docs: record the 15a/15b/15c contracts in the 15d brief

2026-09-05 18:04:29 +00:00
parent 44f7fb8a01
commit 99d42f8fbc
1 changed files with 44 additions and 0 deletions
@@ -56,3 +56,47 @@ re-points them to output-level checks; you do not.
 - [ ] Screenshots match at 560 / 800 / 1100 / 1600 px
 - [ ] `pnpm run gate` green — the full gate, not `verify` + `audit-ui` alone
 - [ ] 42 assertions intact
+
+## What 15a, 15b and 15c actually shipped
+
+Read `.agents/context/content-i18n.md` first — it is the language contract and
+it is binding on this task.
+
+- **`src/components/islands/GuideSelector.astro`** — one island, all nine
+  groups. Render it as
+  `<GuideSelector rootSelector="#full-guide" data={...} />`. `data` needs
+  `phases`, `workers`, `trees`, `routes`, `providers`, `efforts`, `skillFiles`,
+  `skillWorkflow`, `commonSkills` and a bilingual `labels` object; the
+  `GuideSelectorData` interface at the top of the file is the exact shape. You
+  server-render each group's shell and its initial detail panel, keeping today's
+  `data-*` hooks and `.active` state. Mark each group `role="tablist"` and its
+  controls `role="tab"` or the keyboard handler will not bind.
+- **`src/components/islands/LanguageToggle.astro`** — render each localized
+  fragment twice, with `data-language-content="en"` or `"pt"` on the outer
+  element. The toggle flips `hidden` on those, sets `<html lang>`, and fires
+  `ai-for-dummies:languagechange` on `window`. It is a plain `.astro` island
+  that defers its own setup with `requestIdleCallback`; **do not** put
+  `client:idle` on it — that directive is framework-components only.
+- **`src/components/islands/CopyPrompt.astro`** — one per button. Pass
+  `target="prompt-install-skills" | "prompt-basic" | "prompt-skills"`. Render
+  `<p id="copy-status" role="status" aria-live="polite">` exactly once on the
+  page; the island writes into it. Fill the `<pre><code id="prompt-…">` bodies
+  from the `handsOnPrompts` and `skillInstallPrompts` collections — 15b verified
+  those are byte-identical to the legacy `app.js` constants, and the clipboard
+  copies whatever you render, so do not reformat them.
+- **`src/components/islands/ReadingProgress.astro`** — replaces the legacy
+  `<div class="reading-progress">` at the top of the page.
+
+Nothing else is missing. If you are about to write an island, you are doing
+another task's work — report the gap instead.
+
+## Two things to expect
+
+- **The snapshot will not match by construction.** Dual-locale rendering emits
+  both languages into the HTML where today's page emits English plus a
+  Portuguese map inside `app.js`. Compare _rendered, language-filtered_ output
+  against today's page, and if `.agents/snapshots/` needs regenerating, say so
+  explicitly in your report with what changed and why — do not quietly rewrite a
+  snapshot to make a diff go away.
+- **`renderHandsOn` takes no argument** and is not part of GuideSelector's
+  nine-group pattern. It is yours. Its name is asserted by `verify.mjs`.