Skip to content

groundtruth: tighten template-builder-ui against Sent docs snapshot#18

Merged
sent-dm merged 1 commit into
devfrom
batch2/unit-5-tbui-gt
May 19, 2026
Merged

groundtruth: tighten template-builder-ui against Sent docs snapshot#18
sent-dm merged 1 commit into
devfrom
batch2/unit-5-tbui-gt

Conversation

@sent-dm
Copy link
Copy Markdown
Contributor

@sent-dm sent-dm commented May 19, 2026

Scope

Grounds the four files in skills/template-builder-ui/ against the v3 docs snapshot at references/_inputs/sent-docs-v3-2026-05-19.md.

template-validation-matrix.md

  • Adds the Sent-confirmed component support matrix (Header/Footer/Buttons: WhatsApp + RCS only; SMS = Body only).
  • Adds the Sent-confirmed character-limit table (SMS 160/segment, WhatsApp body 1028, header/footer 60; RCS body 1028, header 60).
  • Corrects WhatsApp body limit 1024 → 1028.
  • Confirms header types TEXT / IMAGE / VIDEO / DOCUMENT.
  • Confirms button types QUICK_REPLY / URL / PHONE_NUMBER.
  • Confirms categories UTILITY / MARKETING / AUTHENTICATION.
  • Softens name+language immutability claim to product-governance language (consistent with SKILL.md).
  • Adds "SMS = Body only" callout under the SMS section so the section is internally consistent with the new component matrix.

template-ui-wireflows.md

  • Renames the four creation flows to dashboard-exact names: Create from Scratch, Import from Meta, Create From Definition (note capital "From"), Create from Sample.
  • Adds dashboard surface (app.sent.dm/dashboard/templates) and the search/filter axes (name, category, description, status) + per-row actions (edit, delete, view analytics).
  • Removes PAUSED from the Flow 6 state-transition diagram.
  • Notes the 24–48h WhatsApp review SLA per Sent docs.
  • Aligns Flow 7's submit endpoint to POST /v3/templates and mentions Idempotency-Key.

template-status-handling.md

  • Replaces the PAUSED-as-badge framing with the Sent-confirmed four-state enum, with an explicit "no PAUSED in Sent" callout.
  • Adds the Pending-still-sends-SMS rule per Sent docs (template can be sent over SMS while awaiting WhatsApp approval).
  • Reframes webhook discovery as the snapshot-confirmed <field>.<event> envelope; flags template-specific event names as not enumerated in the snapshot and points to GET /v3/webhooks/event-types.
  • Notes the v3 update endpoint accepts name/language/category and that immutability should be verified against the live OpenAPI.

SKILL.md

  • Drops the now-confirmed PAUSED caveat.
  • Drops the now-confirmed WhatsApp component-limit caveat (Sent's header 60 / body 1028 / footer 60 are confirmed; mixed-button rules remain external Meta concerns).
  • Rewrites the immutability and webhook caveats with snapshot-accurate framing.
  • Aligns section 6 creation-path names with the dashboard.

Verification

  • bash scripts/validate-skills.sh → exits 0.
  • Each touched reference file starts with <!-- Grounded against references/_inputs/sent-docs-v3-2026-05-19.md (sections used: ...) -->.

🤖 Generated with Claude Code

- template-validation-matrix.md: confirm component support matrix (SMS body only;
  RCS/WhatsApp full); confirm header types TEXT/IMAGE/VIDEO/DOCUMENT; confirm
  button types QUICK_REPLY/URL/PHONE_NUMBER; confirm categories
  UTILITY/MARKETING/AUTHENTICATION; correct WhatsApp body 1024→1028; add
  Sent-confirmed character-limit table; soften WhatsApp name+language
  immutability to product-governance language consistent with SKILL.md.
- template-ui-wireflows.md: rename the four creation flows to the exact
  dashboard names (Create from Scratch, Import from Meta, Create From
  Definition, Create from Sample); add app.sent.dm/dashboard/templates
  surface and search/filter/per-row actions; remove PAUSED from the Flow 6
  transition diagram; note the 24-48h WhatsApp review SLA.
- template-status-handling.md: replace PAUSED-as-badge framing with the
  Sent-confirmed four-state enum (Draft/Pending/Approved/Rejected) and
  explicit "no PAUSED in Sent" callout; add the Pending-still-sends-SMS rule;
  reframe webhook discovery as <field>.<event> with GET /v3/webhooks/event-types
  for exact names; soften name/language/category lock to product-governance.
- SKILL.md: drop the now-confirmed PAUSED and component-limit caveats;
  rewrite the immutability and webhook caveats with snapshot-accurate framing;
  align section 6 creation-path names with the dashboard.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@sent-dm sent-dm merged commit 31ba1e2 into dev May 19, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant