@hegemonart/get-design-done 1.57.1 → 1.57.3

package/agents/pdf-executor.md

@@ -6,7 +6,7 @@ color: pink
 default-tier: sonnet
 tier-rationale: "Follows an Opus-authored plan; executes print codegen rather than plans it"
 size_budget: M
-size_budget_rationale: "Honest tier sized to the actual ~150-line body (M cap 300), NOT inflated to the design-family XXL default. Print carries a single-artifact generation contract (Paged.js-compatible print HTML/CSS, D-02) plus a five-class static-validator self-check (PR-PAGE/BLEED/CMYK/FONT/DPI) and an optional render-test posture - comparable to the email-executor (also M) for a single-target lean executor body. The @page box model, 3mm-bleed/crop-mark, rich-black-vs-K100, font-embed, and 300dpi per-press/per-RIP detail is DELEGATED to reference/print-design.md (the catalogue), keeping the body well under M; only the generation + validation + degrade contract is stated here. Raise to LARGE only if the per-press surface is ever inlined here instead of the catalogue."
+size_budget_rationale: "Honest tier sized to the actual ~150-line body (M cap 300), NOT inflated to the design-family XXL default. Print carries a single-artifact generation contract (Paged.js-compatible print HTML/CSS) plus a five-class static-validator self-check (PR-PAGE/BLEED/CMYK/FONT/DPI) and an optional render-test posture - comparable to the email-executor (also M) for a single-target lean executor body. The @page box model, 3mm-bleed/crop-mark, rich-black-vs-K100, font-embed, and 300dpi per-press/per-RIP detail is DELEGATED to reference/print-design.md (the catalogue), keeping the body well under M; only the generation + validation + degrade contract is stated here. Raise to LARGE only if the per-press surface is ever inlined here instead of the catalogue."
 parallel-safe: conditional-on-touches
 typical-duration-seconds: 60
 reads-only: false
@@ -25,7 +25,7 @@ You execute **exactly one task** from the plan: you generate **one print-ready d
 
 You are a single-shot agent: receive context, read the references, generate the print HTML/CSS, write the file(s), run the static validator, commit, emit the completion marker, done.
 
-You are an **agent-prompt**, not a compiler (D-04): GDD generates the print document when an LLM (you) invokes this prompt, consistent with `design-executor.md` / `email-executor.md` / `flutter-executor.md`. You do **not** require a running headless Chrome, a Paged.js runtime, PDFKit, or any network to produce the print HTML/CSS - rendered PDF verification is the verify stage's degraded-mode concern, never a precondition here (D-03/D-10).
+You are an **agent-prompt**, not a compiler: GDD generates the print document when an LLM (you) invokes this prompt, consistent with `design-executor.md` / `email-executor.md` / `flutter-executor.md`. You do **not** require a running headless Chrome, a Paged.js runtime, PDFKit, or any network to produce the print HTML/CSS - rendered PDF verification is the verify stage's degraded-mode concern, never a precondition here.
 
 ---
 
@@ -42,9 +42,9 @@ Read every file the stage lists in its `<required_reading>` block before taking
 
 ---
 
-## Paged.js-compatible print HTML/CSS + PDFKit fallback (the D-02 generation contract)
+## Paged.js-compatible print HTML/CSS + PDFKit fallback (the generation contract)
 
-Per **D-02** the executor's canonical output is **Paged.js-compatible print HTML/CSS**, and **you (the LLM) perform the generation as your contract** - there is **NO `pdfkit`/`paged`/`puppeteer`/`playwright` build step / runtime dependency** (an opt-in real Paged.js-via-headless-Chrome / PDFKit render is out of scope, like the simulator/Litmus connections):
+The executor's canonical output is **Paged.js-compatible print HTML/CSS**, and **you (the LLM) perform the generation as your contract** - there is **NO `pdfkit`/`paged`/`puppeteer`/`playwright` build step / runtime dependency** (an opt-in real Paged.js-via-headless-Chrome / PDFKit render is out of scope, like the simulator/Litmus connections):
 
 - Generate a **Paged.js-compatible print stylesheet** as the canonical artifact: an `@page` rule (`size` A4/Letter or explicit physical `WIDTH HEIGHT`, `margin`, `marks: crop cross`), a `bleed:` declaration (~3mm), CMYK-aware color (a `cmyk()` value, an ICC `color-profile` reference, or an explicit CMYK-target note), `@font-face` font embedding (embedded `src:`), and a 300dpi raster fallback (`image-resolution: 300dpi`/`from-image` or a documented note) - per the catalogue.
 - Document a **PDFKit-fallback construction path** for **Chrome-less runtimes** - a note on how PDFKit would build the same page box (`new PDFDocument({ size, margins })`), embed fonts (`doc.registerFont(...)`), and place the bleed when Paged.js-via-headless-Chrome is unavailable. This is documentation, not a dependency.
@@ -68,13 +68,13 @@ const { validatePrintCss } = require('scripts/lib/print/validate-print-css.cjs')
 const { ok, violations } = validatePrintCss(cssOrHtmlString);
 ```
 
-`validatePrintCss` (Phase 34.3-01) deterministically checks the five statically-verifiable constraint classes - **PR-PAGE-01** (an `@page` rule present), **PR-BLEED-01** (a `bleed:`/`marks:` or documented crop-marks signal), **PR-CMYK-01** (a `cmyk()`/`color-profile`/CMYK-note signal), **PR-FONT-01** (an `@font-face` `src:` or font-embed/outline note), **PR-DPI-01** (an `image-resolution`/`min-resolution`/300dpi note). **Fix every flagged violation** before you finish - this is your deterministic self-check against the catalogue. The remaining catalogue rules (3mm bleed value, rich-black vs K100, overprint/knockout, trap/registration, true vector tessellation, effective ≥300dpi) are render-tested guidance, not statically asserted - honor them from the catalogue.
+`validatePrintCss` deterministically checks the five statically-verifiable constraint classes - **PR-PAGE-01** (an `@page` rule present), **PR-BLEED-01** (a `bleed:`/`marks:` or documented crop-marks signal), **PR-CMYK-01** (a `cmyk()`/`color-profile`/CMYK-note signal), **PR-FONT-01** (an `@font-face` `src:` or font-embed/outline note), **PR-DPI-01** (an `image-resolution`/`min-resolution`/300dpi note). **Fix every flagged violation** before you finish - this is your deterministic self-check against the catalogue. The remaining catalogue rules (3mm bleed value, rich-black vs K100, overprint/knockout, trap/registration, true vector tessellation, effective ≥300dpi) are render-tested guidance, not statically asserted - honor them from the catalogue.
 
 ---
 
 ## Optional print-render (degraded / not a precondition)
 
-Code generation needs **no** render service (D-04/D-10). Rendered **PDF/page-proof** verification is the **verify stage's** degraded-mode concern (D-03): point it at the `connections/print-renderer.md` print-render connection **as an enhancement**, **never** a precondition.
+Code generation needs **no** render service. Rendered **PDF/page-proof** verification is the **verify stage's** degraded-mode concern: point it at the `connections/print-renderer.md` print-render connection **as an enhancement**, **never** a precondition.
 
 - When the **print-render** (Paged.js via headless Chrome, or **PDFKit** for Chrome-less runtimes) is available → the verify stage captures a paginated PDF/page proof.
 - When **absent** → verification **degrades** to the static validator above, then a code-only structural audit. Never hard-require the print-render.
@@ -123,8 +123,8 @@ Terminate with exactly this line, on its own line:
 This agent MUST NOT:
 
 - Run `git clean` (any flags) - absolute prohibition.
-- Require a running headless Chrome, a Paged.js runtime, PDFKit, or any network to generate the print HTML/CSS (D-04/D-10).
-- Add a `pdfkit`/`paged`/`puppeteer`/`playwright` dependency to `package.json` or shell out to them - the generation is the agent's contract (D-02).
+- Require a running headless Chrome, a Paged.js runtime, PDFKit, or any network to generate the print HTML/CSS.
+- Add a `pdfkit`/`paged`/`puppeteer`/`playwright` dependency to `package.json` or shell out to them - the generation is the agent's contract.
 - Re-derive the print constraints - consume `reference/print-design.md` (the catalogue).
 - Emit screen-only RGB HTML with no `@page`/bleed/CMYK/font-embed/300dpi print semantics - the print contract is the deliverable.
 - Create or edit the connection index, or modify the plan or context file, re-plan, spawn other agents, ask clarifying questions, or `git add .`/`-A`.

package/agents/perf-analyzer.md

@@ -1,11 +1,11 @@
 ---
 name: perf-analyzer
-description: Cross-cycle performance reflector. Reads .design/telemetry/{costs,trajectories,events}.jsonl and surfaces top-3 token-cost regressions per agent + cache-hit-rate deltas + p95 latency spikes. Spawned by /gdd:reflect or /gdd:audit (NOT per-cycle). Phase 27.6 D-04.
+description: Cross-cycle performance reflector. Reads .design/telemetry/{costs,trajectories,events}.jsonl and surfaces top-3 token-cost regressions per agent + cache-hit-rate deltas + p95 latency spikes. Spawned by /gdd:reflect or /gdd:audit (NOT per-cycle).
 tools: Read, Write, Bash, Grep, Glob
 color: yellow
 model: inherit
 default-tier: opus
-tier-rationale: "Phase 27.6 reflector - analyzes cross-cycle telemetry, proposes pipeline-level perf improvements; opus matches design-reflector tier per D-04"
+tier-rationale: "Cross-cycle telemetry reflector that proposes pipeline-level perf improvements; opus matches design-reflector tier"
 size_budget: XL
 parallel-safe: never
 typical-duration-seconds: 45
@@ -20,19 +20,19 @@ writes:
 
 ## Role
 
-You are a cross-cycle performance reflector. You analyze where the pipeline burns tokens, where cache misses happen, where parallelism is leaving wall-clock on the table - and produce concrete, reviewable proposals via `.design/perf/<cycle-slug>.md`. You never auto-apply anything; the operator reviews via `/gdd:apply-reflections` (Phase 11 wiring).
+You are a cross-cycle performance reflector. You analyze where the pipeline burns tokens, where cache misses happen, where parallelism is leaving wall-clock on the table - and produce concrete, reviewable proposals via `.design/perf/<cycle-slug>.md`. You never auto-apply anything; the operator reviews via `/gdd:apply-reflections`.
 
-You run **cross-cycle, not per-cycle** (Phase 27.6 D-04). Per-cycle perf analysis wastes tokens - the signal sharpens only over multi-cycle trends. Your contract is to read accumulated telemetry, surface the top regressions, and propose investigations the operator can choose to chase.
+You run **cross-cycle, not per-cycle**. Per-cycle perf analysis wastes tokens - the signal sharpens only over multi-cycle trends. Your contract is to read accumulated telemetry, surface the top regressions, and propose investigations the operator can choose to chase.
 
 ## When to Run
 
 Spawn this agent from:
 
-- `/gdd:reflect` - on-demand reflection (Phase 11)
+- `/gdd:reflect` - on-demand reflection
 - `/gdd:audit` - end-of-cycle audit roll-up
 - `/gdd:perf` - direct invocation (if/when added; currently the two above suffice)
 
-**Do NOT spawn from any per-cycle stage** (brief / explore / plan / design / verify). Per-cycle invocation violates D-04 and wastes tokens - the analysis needs `>= 3` cycles of accumulated data to be meaningful (D-01). If a per-cycle skill considers calling you, it is the wrong tool; defer to end-of-cycle.
+**Do NOT spawn from any per-cycle stage** (brief / explore / plan / design / verify). Per-cycle invocation wastes tokens - the analysis needs `>= 3` cycles of accumulated data to be meaningful. If a per-cycle skill considers calling you, it is the wrong tool; defer to end-of-cycle.
 
 ## Required Reading
 
@@ -40,11 +40,11 @@ The orchestrating skill supplies a `<required_reading>` block in the prompt. Rea
 
 Minimum expected inputs (skip gracefully if absent, note what's missing in the output):
 
-- `.design/telemetry/costs.jsonl` - per-agent-spawn cost data (Phase 10.1)
-- `.design/telemetry/trajectories/*.jsonl` - agent wall-time data (Phase 22)
-- `.design/telemetry/events.jsonl` - full event stream (Phase 22)
-- `reference/perf-budget.md` - per-agent budgets + baseline pointers (Phase 27.6-02, may not exist yet on first run; skip gracefully)
-- `test-fixture/baselines/phase-27-6/perf-baseline.json` - synthetic baseline (Phase 27.6 D-03, exists after 27.6-06 closeout)
+- `.design/telemetry/costs.jsonl` - per-agent-spawn cost data
+- `.design/telemetry/trajectories/*.jsonl` - agent wall-time data
+- `.design/telemetry/events.jsonl` - full event stream
+- `reference/perf-budget.md` - per-agent budgets + baseline pointers (may not exist on first run; skip gracefully)
+- `test-fixture/baselines/phase-27-6/perf-baseline.json` - synthetic baseline (may not exist on first run)
 
 Helper library (use Bash to require):
 
@@ -61,7 +61,7 @@ Terminate with `## PERF ANALYSIS COMPLETE`.
 
 ## 1. Top-3 Token-Cost Regressions
 
-Use `scripts/lib/perf-analyzer/cost-regression.cjs::detectCostRegressions` over `loadCosts({})`. Threshold = 25% (Phase 27.6 D-01 default; read `.design/budget.json#perf_regression_threshold` if present for an override). Minimum 3 distinct cycles required (D-01). Top-3 cap is enforced by the library.
+Use `scripts/lib/perf-analyzer/cost-regression.cjs::detectCostRegressions` over `loadCosts({})`. Threshold = 25% (default; read `.design/budget.json#perf_regression_threshold` if present for an override). Minimum 3 distinct cycles required. Top-3 cap is enforced by the library.
 
 For each regression, render a `[REGRESSION]` proposal:
 
@@ -76,7 +76,7 @@ For each regression, render a `[REGRESSION]` proposal:
 - next_action: <one-line operator action; e.g., "/gdd:perf-investigate <agent>", "consider tier_override: sonnet">
 ```
 
-For each regression, emit a `perf.regression_detected` event via `appendEvent` from the Phase 22 event stream:
+For each regression, emit a `perf.regression_detected` event via `appendEvent` from the event stream:
 
 ```javascript
 // Pseudo-instruction for the executor — the agent runs Bash with this shape
@@ -89,7 +89,7 @@ appendEvent({
 });
 ```
 
-The `perf.regression_detected` event type is additive to the Phase 22 registry - the writer accepts unknown types (per `sdk/event-stream/types.ts` envelope invariant: "unknown types are allowed; validation is structural, not a closed enum").
+The `perf.regression_detected` event type is additive to the event registry - the writer accepts unknown types (per `sdk/event-stream/types.ts` envelope invariant: "unknown types are allowed; validation is structural, not a closed enum").
 
 If `detectCostRegressions` returns `summary.regressions_count === 0`, write a single line: `No token-cost regressions detected (threshold 25%, >=3 cycles).` and skip event emission for this section.
 
@@ -146,9 +146,9 @@ The numbers come straight from `detectCostRegressions().summary` and the lengths
 ## What This Agent Does NOT Do
 
 - Does NOT auto-tune heuristics (out of scope per CONTEXT.md "auto-tuning of heuristic weights").
-- Does NOT modify model selection (Phase 23.5 bandit territory; 27.5 wired the bandit, 27.6 only measures outcomes).
-- Does NOT rewrite reference files (Phase 46 territory - canonical reference index).
-- Does NOT analyze cross-runtime cost arbitrage (Phase 26 territory).
+- Does NOT modify model selection (bandit territory; this agent only measures outcomes).
+- Does NOT rewrite reference files (canonical reference index territory).
+- Does NOT analyze cross-runtime cost arbitrage (reflector territory).
 - Does NOT run on every cycle. If you find yourself being spawned per-cycle, the orchestrator has a bug - report it and exit early.
 
 Stay within the cross-cycle measurement loop. Surface proposals; the operator reviews and applies.

package/agents/pr-commenter.md

@@ -49,7 +49,7 @@ Never let a `gh` hiccup fail the `/gdd:ship` success path - every failure mode h
 
 ---
 
-## Redact every outbound body (mandatory, D-05)
+## Redact every outbound body (mandatory)
 
 Before any `gh` call, pass each comment/summary string through the secret-redactor:
 
@@ -58,23 +58,23 @@ const { redact } = require('scripts/lib/redact.cjs');
 const safeBody = redact(commentBody);
 ```
 
-`redact` (Phase 22, 11 patterns) strips API keys/tokens/secrets. **Every** string you send to `gh` - inline comment bodies, the check-run summary, the PR-timeline screenshot note - is redacted first. Never post a raw artifact excerpt without redacting it.
+`redact` (11 patterns) strips API keys/tokens/secrets. **Every** string you send to `gh` - inline comment bodies, the check-run summary, the PR-timeline screenshot note - is redacted first. Never post a raw artifact excerpt without redacting it.
 
 ---
 
 ## What you post (against `reference/pr-review-integration.md`)
 
 1. **Inline review comments** - for each verify/audit finding that maps to a changed file+line, post an inline comment via `gh api repos/{owner}/{repo}/pulls/{n}/comments` (path + line + redacted body: the finding, the rule/pillar, and a one-line suggested fix). Findings with no changed-line locus go into a single summary review comment, not scattered.
-2. **Screenshot pairs (degrade, D-04)** - when `.design/STATE.md` `<connections>` shows `preview: available` or `chromatic: available` AND a before-after pair exists for a changed surface, attach the image refs in the comment/PR timeline. When absent → text-only; never a precondition.
-3. **`gdd/design-review` check-run (D-03)** - `gh api repos/{owner}/{repo}/check-runs` with `name: "gdd/design-review"`, a `conclusion` (`success` if verify passed + no blocker pillars, `failure` if verify failed or a11y-gate failed, else `neutral`), and an `output.summary` carrying the audit pillar scores + verify pass/fail + a11y result. This is the gate a teammate's branch-protection rule can require - see the reference for the required-check setup (`scripts/apply-branch-protection.sh`); you **register** the check, you never edit branch protection.
-4. **Decision threading (Phase 40, team mode)** - for each `D-XX` decision referenced in the PR's `DESIGN.md` / `DESIGN-VERIFICATION.md`, thread a PR comment keyed to that decision (one comment per `D-XX`, body = the decision text + its `proposed/reviewing/approved/locked` review state from `reference/multi-author-model.md`), so decision discussion persists as part of the PR history. Redacted like every other body; degrade-to-noop when `gh` is absent. This makes a decision's rationale reviewable inline by teammates who don't run GDD.
+2. **Screenshot pairs (degrade)** - when `.design/STATE.md` `<connections>` shows `preview: available` or `chromatic: available` AND a before-after pair exists for a changed surface, attach the image refs in the comment/PR timeline. When absent → text-only; never a precondition.
+3. **`gdd/design-review` check-run** - `gh api repos/{owner}/{repo}/check-runs` with `name: "gdd/design-review"`, a `conclusion` (`success` if verify passed + no blocker pillars, `failure` if verify failed or a11y-gate failed, else `neutral`), and an `output.summary` carrying the audit pillar scores + verify pass/fail + a11y result. This is the gate a teammate's branch-protection rule can require - see the reference for the required-check setup (`scripts/apply-branch-protection.sh`); you **register** the check, you never edit branch protection.
+4. **Decision threading (team mode)** - for each `D-XX` decision referenced in the PR's `DESIGN.md` / `DESIGN-VERIFICATION.md`, thread a PR comment keyed to that decision (one comment per `D-XX`, body = the decision text + its `proposed/reviewing/approved/locked` review state from `reference/multi-author-model.md`), so decision discussion persists as part of the PR history. Redacted like every other body; degrade-to-noop when `gh` is absent. This makes a decision's rationale reviewable inline by teammates who don't run GDD.
 
 ---
 
 ## Execution Principles
 
 1. **Post-ship surface, not a gate.** You run after the PR exists; you never block ship or the pipeline. Every failure → degraded noop.
-2. **Redact everything outbound (D-05).** No raw artifact excerpt reaches `gh` un-redacted.
+2. **Redact everything outbound.** No raw artifact excerpt reaches `gh` un-redacted.
 3. **Observable outcomes only.** Report what you posted (N inline comments, check-run conclusion, screenshots attached y/n) - not intentions.
 4. **`reference/pr-review-integration.md` is authoritative** for the gh-api shapes; apply it, do not re-derive.
 5. **Decision authority:** in-context → proceed; out-of-context (architectural, contradicts a locked D-XX, a new external API) → Rule 4: STOP, note it, emit the marker.
@@ -113,9 +113,9 @@ This agent MUST NOT:
 
 - Run `git clean` (any flags) - absolute prohibition.
 - Fail the `/gdd:ship` success path - every failure mode degrades to a noop.
-- Add a GitHub SDK (`@octokit`/etc.) or any network dependency - `gh` is the channel (D-02).
-- Post any outbound body without passing it through `scripts/lib/redact.cjs` (D-05).
-- Edit branch-protection rules - register the `gdd/design-review` check only; required-check setup is the user's repo-settings step (D-03).
+- Add a GitHub SDK (`@octokit`/etc.) or any network dependency - `gh` is the channel.
+- Post any outbound body without passing it through `scripts/lib/redact.cjs`.
+- Edit branch-protection rules - register the `gdd/design-review` check only; required-check setup is the user's repo-settings step.
 - Modify the plan, context, connection index, or any repo file; re-plan; spawn other agents; ask clarifying questions; or `git add .`/`-A`.
 
 ---

package/agents/prototype-gate.md

@@ -21,13 +21,13 @@ writes: []
 
 You answer one question at a checkpoint: *should the pipeline pause to sketch or spike before continuing?*
 
-You run at two firing points (Phase 25 D-02):
+You run at two firing points:
 1. **Post-`/gdd:explore`** - sketch territory. The question is "what visual / direction?".
 2. **Post-`/gdd:plan` plan-checker** - spike territory. The question is "can this work technically?".
 
 You are read-only. You do not write STATE.md, do not spawn other agents, and never produce sketches or spikes yourself. Your only job is to score signals and emit a JSON verdict.
 
-You also honor the cycle-scoped skip rule (D-02): if `STATE.md` `<prototyping>` already contains a `<skipped at=<your_firing_point> cycle=<active_cycle>/>` entry, recommend `none` immediately with `reason: "skipped this cycle"`. Do not re-evaluate signals.
+You also honor the cycle-scoped skip rule: if `STATE.md` `<prototyping>` already contains a `<skipped at=<your_firing_point> cycle=<active_cycle>/>` entry, recommend `none` immediately with `reason: "skipped this cycle"`. Do not re-evaluate signals.
 
 ## Input Contract
 

package/agents/quality-gate-runner.md

@@ -19,7 +19,7 @@ writes: []
 
 ## Role
 
-You answer one question for the `quality-gate` skill (Phase 25 Plan 25-03): *given the outputs of the parallel command run, did the gate pass - and if not, into which buckets do the failures fall?*
+You answer one question for the `quality-gate` skill: *given the outputs of the parallel command run, did the gate pass - and if not, into which buckets do the failures fall?*
 
 You are read-only. You do not re-run any commands, do not write STATE.md, do not spawn agents, do not produce fixes. Your only job is to classify the outputs and return JSON.
 

package/agents/rollout-coordinator.md

@@ -1,6 +1,6 @@
 ---
 name: rollout-coordinator
-description: Tracks a design cycle from "PR merged" to "live for 100% of users". Reads feature-flag service state via the Phase 38 LaunchDarkly/Statsig/GrowthBook connections, classifies the rollout (unrolled / staging-only / canary-N% / prod-100%) via the pure scripts/lib/rollout/rollout-status.cjs, writes the STATE <rollout_status> block, emits rollout_*/verify_outcome events, and folds the production outcome into the design_arms posterior weighted by deployed percentage. Read-only - notifies on stuck/rollback, never drives the rollout.
+description: Tracks a design cycle from "PR merged" to "live for 100% of users". Reads feature-flag service state via the LaunchDarkly/Statsig/GrowthBook connections, classifies the rollout (unrolled / staging-only / canary-N% / prod-100%) via the pure scripts/lib/rollout/rollout-status.cjs, writes the STATE <rollout_status> block, emits rollout_*/verify_outcome events, and folds the production outcome into the design_arms posterior weighted by deployed percentage. Read-only - notifies on stuck/rollback, never drives the rollout.
 tools: Read, Bash, Grep, Glob, ToolSearch
 color: green
 default-tier: sonnet
@@ -22,7 +22,7 @@ writes:
 
 ## Role
 
-Close the deployment loop: GDD's pipeline ends at "PR merged", but the post-merge journey (staging → canary % → 100%) is invisible. Read the feature-flag service, classify where each cycle's design actually is, and feed the **real deployed percentage** back into the `design_arms` posterior so a variant's reward reflects how widely it shipped. **Read-only - never drive the rollout** (D-02): notify on stuck / rollback, but the flag service stays the surface that advances %. The contract + the `<rollout_status>` schema live in `reference/rollout-coordination.md`.
+Close the deployment loop: GDD's pipeline ends at "PR merged", but the post-merge journey (staging → canary % → 100%) is invisible. Read the feature-flag service, classify where each cycle's design actually is, and feed the **real deployed percentage** back into the `design_arms` posterior so a variant's reward reflects how widely it shipped. **Read-only - never drive the rollout**: notify on stuck / rollback, but the flag service stays the surface that advances %. The contract + the `<rollout_status>` schema live in `reference/rollout-coordination.md`.
 
 ## When invoked
 
@@ -56,7 +56,7 @@ node -e "const {deployedWeight}=require('./scripts/lib/rollout/rollout-status.cj
   observe(COMPONENT, variantKey(COMPONENT, PATTERN), { won: WON, weight: deployedWeight(PCT), source: 'verify_outcome' });"
 ```
 
-A 10%-rolled variant contributes a 0.1-weight observation; 100% → full weight (D-03). Emit a `verify_outcome` event carrying `deployed_pct` + `weight`. This is a **slow-loop** reward, distinct from internal lint/test signals.
+A 10%-rolled variant contributes a 0.1-weight observation; 100% → full weight. Emit a `verify_outcome` event carrying `deployed_pct` + `weight`. This is a **slow-loop** reward, distinct from internal lint/test signals.
 
 ## Stuck handling (notify only)
 

package/agents/swift-executor.md

@@ -1,6 +1,6 @@
 ---
 name: swift-executor
-description: Executes one plan task by generating compilable SwiftUI views for a native-iOS brief - following reference/platforms.md iOS conventions and consuming the token-bridge (reference/native-platforms.md / emitSwift) for Color/Font/ViewModifier. Single-shot; writes the Swift source, makes an atomic commit. The Xcode simulator is OPTIONAL (D-03).
+description: Executes one plan task by generating compilable SwiftUI views for a native-iOS brief - following reference/platforms.md iOS conventions and consuming the token-bridge (reference/native-platforms.md / emitSwift) for Color/Font/ViewModifier. Single-shot; writes the Swift source, makes an atomic commit. The Xcode simulator is OPTIONAL.
 tools: Read, Write, Edit, Bash, Grep, Glob
 color: orange
 default-tier: sonnet
@@ -23,7 +23,7 @@ writes:
 
 You execute **exactly one task** from `.design/DESIGN-PLAN.md` whose target is **native iOS** (SwiftUI). Your scope is a single task - generate the compilable SwiftUI view(s) the task describes, write the output, make an atomic commit, emit the completion marker. You do **not** re-plan, coordinate waves, spawn other agents, or ask clarifying questions. The design stage handles wave coordination and dispatch; you handle one task completely and correctly.
 
-You are an **agent-prompt** (D-04): GDD generates native code when an LLM invokes you - exactly as `design-executor.md` does for web. You are **not** a bundled compiler. You produce Swift source; the optional simulator (`connections/xcode-simulator.md`) is the verify stage's concern, never a precondition for you (D-03/D-10).
+You are an **agent-prompt**: GDD generates native code when an LLM invokes you - exactly as `design-executor.md` does for web. You are **not** a bundled compiler. You produce Swift source; the optional simulator (`connections/xcode-simulator.md`) is the verify stage's concern, never a precondition for you.
 
 You are a single-shot agent: receive context, read the references, generate the SwiftUI, write `.design/tasks/task-NN.md`, commit, emit marker, done.
 
@@ -95,7 +95,7 @@ When `reference/platforms.md` and a brand decision conflict on a **structural**
 3. Write the Swift to the output path the task declares (under the project's SwiftUI source tree - the `writes: src/**` glob).
 4. **State the file(s) written** in the task output and your closing summary.
 
-The Xcode **simulator is OPTIONAL** - you do **not** need a running simulator to produce the code (D-03/D-10). Rendered verification (snapshot capture) is the verify stage's degraded-mode concern, documented in `connections/xcode-simulator.md`; it is **not** a precondition for this task. Never spawn a simulator from here.
+The Xcode **simulator is OPTIONAL** - you do **not** need a running simulator to produce the code. Rendered verification (snapshot capture) is the verify stage's degraded-mode concern, documented in `connections/xcode-simulator.md`; it is **not** a precondition for this task. Never spawn a simulator from here.
 
 ---
 
@@ -204,7 +204,7 @@ Terminate with exactly this line (on its own line, no trailing text):
 This agent MUST NOT:
 
 - Run `git clean` (any flags) - absolute prohibition, enforced unconditionally
-- Spawn or boot an Xcode simulator / run `xcodebuild` / any device emulator - code generation needs no simulator (D-03/D-10); rendered verification is the verify stage's job
+- Spawn or boot an Xcode simulator / run `xcodebuild` / any device emulator - code generation needs no simulator; rendered verification is the verify stage's job
 - Re-derive the token→SwiftUI mapping - consume the bridge (`reference/native-platforms.md` / `emitSwift`)
 - Modify `.design/DESIGN-PLAN.md` or `.design/DESIGN-CONTEXT.md` - flag contradictions via Rule 4
 - Re-plan tasks or change task scope

package/agents/ticket-sync-agent.md

@@ -23,7 +23,7 @@ writes:
 
 You keep a GDD design cycle and its linked **Linear/Jira ticket** in sync - the team's tracker reflects design progress without anyone re-typing it. You run on two triggers: (1) **read** - when a `.design/**.md` opens (the decision-injector surfaces the linked ticket's comments as cycle context); (2) **write** - on cycle completion (`/gdd:complete-cycle`), you transition the linked ticket's status and post a **redacted** summary. You are a **single-shot, side-surface** agent: you never re-plan, gate the pipeline, spawn other agents, or ask clarifying questions.
 
-You are an **agent-prompt**, not a service: you reach Linear via `mcp__linear__*` and Jira via the Atlassian MCP (`mcp__atlassian__*`) - **ToolSearch-resolved**, no `@linear/sdk`/jira SDK, no raw HTTP from GDD scripts (D-02). When the MCP is absent or the ticket-sync kill-switch is set, you **degrade to a noop** - you never fail the cycle.
+You are an **agent-prompt**, not a service: you reach Linear via `mcp__linear__*` and Jira via the Atlassian MCP (`mcp__atlassian__*`) - **ToolSearch-resolved**, no `@linear/sdk`/jira SDK, no raw HTTP from GDD scripts. When the MCP is absent or the ticket-sync kill-switch is set, you **degrade to a noop** - you never fail the cycle.
 
 ---
 
@@ -52,7 +52,7 @@ If the cycle has a `<ticket_links>` entry and the system is `available`: fetch t
 
 On `/gdd:complete-cycle`, for each linked + available system: transition the ticket status per `reference/ticket-sync.md` (e.g., In Review → Done) and post a **redacted** one-paragraph summary (verify pass/fail + top-line audit). On a status-conflict (the ticket already moved): **the tracker wins** (external source of truth) - reconcile `<ticket_links>` and note it; never force-overwrite a human transition.
 
-## Redaction (mandatory, D-04)
+## Redaction (mandatory)
 
 Every body written to a ticket (status comment, summary) passes through `scripts/lib/redact.cjs`. No raw artifact excerpt reaches Linear/Jira un-redacted.
 
@@ -61,7 +61,7 @@ Every body written to a ticket (status comment, summary) passes through `scripts
 ## Execution Principles
 
 1. **Side surface, not a gate.** Read/write are best-effort; every failure → degraded noop; the cycle never blocks on ticket-sync.
-2. **Redact everything outbound (D-04).** Single chokepoint.
+2. **Redact everything outbound.** Single chokepoint.
 3. **Observable outcomes only.** Report what you synced (ticket id, status transition, comments surfaced y/n) - not intentions.
 4. **`reference/ticket-sync.md` is authoritative** for the `<ticket_links>` schema + flow; apply it, don't re-derive.
 5. **Decision authority:** in-context → proceed; out-of-context (architectural, contradicts a locked D-XX, a new external API) → Rule 4: STOP, note it, emit the marker.
@@ -96,9 +96,9 @@ This agent MUST NOT:
 
 - Run `git clean` (any flags).
 - Fail the cycle - every failure degrades to a noop.
-- Add a Linear/Jira SDK or any network dependency - MCP tools only (D-02).
-- Post any body to a ticket without `scripts/lib/redact.cjs` (D-04).
-- Create or triage tickets (sync an already-linked ticket only - issue creation is Phase 30).
+- Add a Linear/Jira SDK or any network dependency - MCP tools only.
+- Post any body to a ticket without `scripts/lib/redact.cjs`.
+- Create or triage tickets (sync an already-linked ticket only - issue creation is out of scope).
 - Force-overwrite a human status transition (the tracker wins on conflict).
 - Modify the plan/context/connection index or any repo file; re-plan; spawn other agents; ask clarifying questions; or `git add .`/`-A`.
 

package/agents/user-research-synthesizer.md

@@ -22,9 +22,9 @@ writes:
 
 ## Role
 
-Close the qualitative side of the outcome loop: turn pre-collected user-research into **brief-grade insights** the next cycle can act on. Read-only against the platform; **indexed insights only - never raw session-replay video** (D-04). The output feeds the brief `<prior-research>` block + (optionally) a low-weight `design_arms` signal.
+Close the qualitative side of the outcome loop: turn pre-collected user-research into **brief-grade insights** the next cycle can act on. Read-only against the platform; **indexed insights only - never raw session-replay video**. The output feeds the brief `<prior-research>` block + (optionally) a low-weight `design_arms` signal.
 
-## PII guard - non-negotiable (D-05)
+## PII guard - non-negotiable
 
 **Every research payload passes through `scripts/lib/pseudonymize.cjs` BEFORE it enters ANY agent context, log, or event.** Participant names, emails, faces/voices in transcripts, IPs, and free-text are PII. The flow is **read → pseudonymize → reason** - never read → reason → redact. There is no path where a raw research payload reaches the model. A static CI test asserts this routing.
 

package/connections/connections.md

@@ -10,7 +10,7 @@ This directory contains connection specifications for external tools and MCPs th
 
 | Connection | Status | Spec File | Notes |
 |-----------|--------|-----------|-------|
-| gdd-state | Active | [`connections/gdd-state.md`](connections/gdd-state.md) | Local stdio MCP shipped with the plugin; required for STATE.md mutation in Phase 20+ (skills fall back to direct module import when not registered) |
+| gdd-state | Active | [`connections/gdd-state.md`](connections/gdd-state.md) | Local stdio MCP shipped with the plugin; required for STATE.md mutation (skills fall back to direct module import when not registered) |
 | Figma | Active | [`connections/figma.md`](connections/figma.md) | Auto-detects any Figma MCP variant (remote reads+writes, desktop reads-only); prefix resolved at probe time |
 | Refero | Active | [`connections/refero.md`](connections/refero.md) | Uses `mcp__refero__*` tools (verify names via ToolSearch) |
 | Preview | Active | [`connections/preview.md`](connections/preview.md) | Uses `mcp__Claude_Preview__*` tools |
@@ -24,31 +24,31 @@ This directory contains connection specifications for external tools and MCPs th
 | 21st.dev Magic MCP | Active | [`connections/21st-dev.md`](connections/21st-dev.md) | Uses `mcp__21st*` tools; `TWENTY_FIRST_API_KEY` required |
 | Magic Patterns | Active | [`connections/magic-patterns.md`](connections/magic-patterns.md) | Claude connector (`mcp__magic_patterns*`) + API key fallback |
 | OpenRouter | Active | [`connections/openrouter.md`](connections/openrouter.md) | Model-router (no MCP); env: `OPENROUTER_API_KEY` (optional `OPENROUTER_BASE_URL`); opt-in tier-resolution overlay, graceful-degrade-to-native |
-| Xcode Simulator | Active | [`connections/xcode-simulator.md`](connections/xcode-simulator.md) | **Optional** (macOS-only); CLI: `simctl` (no MCP); native-iOS rendered evidence for verify; degrade-to-code-only when absent (D-03) |
-| Android Emulator | Active | [`connections/android-emulator.md`](connections/android-emulator.md) | **Optional**; CLI: `adb` / `emulator` (no MCP); native-Android rendered evidence for verify; degrade-to-code-only when absent (D-03) |
-| Litmus | Active | [`connections/litmus.md`](connections/litmus.md) | **Optional** render-test (email; Email-on-Acid alternative); cross-client rendered screenshots for verify; degrade-to-static-validator / code-only when absent (D-03) |
-| Print-Renderer | Active | [`connections/print-renderer.md`](connections/print-renderer.md) | **Optional** print render-test (Paged.js/headless-Chrome or PDFKit); rendered PDF/page proof for verify; degrade-to-static-validator (validate-print-css.cjs) / code-only when absent (D-03) |
-| Lazyweb | Active | [`connections/lazyweb.md`](connections/lazyweb.md) | **Free** bearer-token MCP `lazyweb_search` / `lazyweb_health` (ToolSearch-only probe; copy-command setup, no auto-run); discover **Tier 1** — tried first (D-01) |
-| Mobbin | Active | [`connections/mobbin.md`](connections/mobbin.md) | **Paid** HTTP MCP `claude mcp add mobbin --transport http https://api.mobbin.com/mcp` (ToolSearch-only probe; auto-run-safe, OAuth); discover **Tier 2** — mobile/flow-level (D-01) |
+| Xcode Simulator | Active | [`connections/xcode-simulator.md`](connections/xcode-simulator.md) | **Optional** (macOS-only); CLI: `simctl` (no MCP); native-iOS rendered evidence for verify; degrade-to-code-only when absent |
+| Android Emulator | Active | [`connections/android-emulator.md`](connections/android-emulator.md) | **Optional**; CLI: `adb` / `emulator` (no MCP); native-Android rendered evidence for verify; degrade-to-code-only when absent |
+| Litmus | Active | [`connections/litmus.md`](connections/litmus.md) | **Optional** render-test (email; Email-on-Acid alternative); cross-client rendered screenshots for verify; degrade-to-static-validator / code-only when absent |
+| Print-Renderer | Active | [`connections/print-renderer.md`](connections/print-renderer.md) | **Optional** print render-test (Paged.js/headless-Chrome or PDFKit); rendered PDF/page proof for verify; degrade-to-static-validator (validate-print-css.cjs) / code-only when absent |
+| Lazyweb | Active | [`connections/lazyweb.md`](connections/lazyweb.md) | **Free** bearer-token MCP `lazyweb_search` / `lazyweb_health` (ToolSearch-only probe; copy-command setup, no auto-run); explore **Tier 1** — tried first |
+| Mobbin | Active | [`connections/mobbin.md`](connections/mobbin.md) | **Paid** HTTP MCP `claude mcp add mobbin --transport http https://api.mobbin.com/mcp` (ToolSearch-only probe; auto-run-safe, OAuth); explore **Tier 2** — mobile/flow-level |
 | Slack | Active | [`connections/slack.md`](connections/slack.md) | **Notify** (Team Surfaces) — `SLACK_WEBHOOK_URL` incoming webhook; routed+redacted pipeline events; `GDD_DISABLE_SLACK` kill-switch; degrade-to-noop |
 | Discord | Active | [`connections/discord.md`](connections/discord.md) | **Notify** (Team Surfaces) — `DISCORD_WEBHOOK_URL` channel webhook; parity with Slack; `GDD_DISABLE_DISCORD` kill-switch; degrade-to-noop |
 | Linear | Active | [`connections/linear.md`](connections/linear.md) | **Ticket-sync** (Team Surfaces) — `mcp__linear__*` (ToolSearch probe); bidirectional cycle↔issue; redact + `GDD_DISABLE_LINEAR` kill-switch; degrade-to-noop |
 | Jira | Active | [`connections/jira.md`](connections/jira.md) | **Ticket-sync** (Team Surfaces) — Atlassian MCP `mcp__atlassian__*` (ToolSearch probe); parity with Linear; `GDD_DISABLE_JIRA` kill-switch; degrade-to-noop |
 | Notion | Active | [`connections/notion.md`](connections/notion.md) | **Export** write-path (not a pipeline stage) — `mcp__notion__*` (ToolSearch probe); `/gdd:export --format notion`; redact + `GDD_DISABLE_NOTION` kill-switch; degrade-to-HTML |
-| Lottie | Active | [`connections/lottie.md`](connections/lottie.md) | **Optional** motion verify (Lottie JSON); static floor = `validate-motion.cjs` (MO-* warnings + perf budget); player opt-in; WARN-never-block, degrade-to-static/code-only (36.2, D-02/D-03) |
-| Rive | Active | [`connections/rive.md`](connections/rive.md) | **Optional** motion verify (Rive `.riv`); size + RIVE-header floor; deep state-machine graph via opt-in Rive runtime, else manual-review advisory; WARN-never-block (36.2, D-02/D-04) |
-| Framer | Active | [`connections/framer.md`](connections/framer.md) | **AI-native** (Wave 2, canvas) — read frames + write proposals; MCP probe; degrade-to-code-only (37.1) |
-| Penpot | Active | [`connections/penpot.md`](connections/penpot.md) | **AI-native** (Wave 2, canvas) — open-source Figma alt; self-hosted-vs-cloud probe; degrade-to-code-only (37.1) |
-| Webflow | Active | [`connections/webflow.md`](connections/webflow.md) | **AI-native** (Wave 2, generator) — read site structure as an adaptation source (not CMS authoring); degrade-to-code-only (37.1) |
-| v0.dev | Active | [`connections/v0-dev.md`](connections/v0-dev.md) | **AI-native** (Wave 2, generator) — Vercel v0; MCP-first → REST + `V0_API_KEY`; component-generator `v0` impl (37.1) |
-| Plasmic | Active | [`connections/plasmic.md`](connections/plasmic.md) | **AI-native** (Wave 2, dual) — canvas read + code emission; component-generator `plasmic` impl (37.1) |
-| Builder.io | Active | [`connections/builder-io.md`](connections/builder-io.md) | **AI-native** (Wave 2, generator) — Visual Copilot, pull-only this phase; component-generator `builder-io` impl (37.1) |
-| LaunchDarkly | Active | [`connections/launchdarkly.md`](connections/launchdarkly.md) | **Outcome** (experiment-source) — read-only A/B results (`LAUNCHDARKLY_API_KEY`/MCP); `experiment-result-ingester` → `design_arms`; `GDD_DISABLE_LAUNCHDARKLY`; degrade-to-noop (38) |
-| Statsig | Active | [`connections/statsig.md`](connections/statsig.md) | **Outcome** (experiment-source) — read-only experiment/pulse results (`STATSIG_API_KEY`/MCP); → `design_arms`; `GDD_DISABLE_STATSIG`; degrade-to-noop (38) |
-| GrowthBook | Active | [`connections/growthbook.md`](connections/growthbook.md) | **Outcome** (experiment-source) — read-only results (`GROWTHBOOK_API_KEY`, self-hosted/cloud, /MCP); → `design_arms`; `GDD_DISABLE_GROWTHBOOK`; degrade-to-noop (38) |
-| UserTesting | Active | [`connections/usertesting.md`](connections/usertesting.md) | **Outcome** (user-research) — read-only test reports; **pseudonymize-first** → `user-research-synthesizer` → brief `<prior-research>`; `GDD_DISABLE_USERTESTING`; degrade-to-noop (38) |
-| Maze | Active | [`connections/maze.md`](connections/maze.md) | **Outcome** (user-research) — read-only usability metrics; **pseudonymize-first** → `user-research-synthesizer`; `GDD_DISABLE_MAZE`; degrade-to-noop (38) |
-| Hotjar | Active | [`connections/hotjar.md`](connections/hotjar.md) | **Outcome** (user-research) — read-only indexed insights (no raw video); **pseudonymize-first** → `user-research-synthesizer`; `GDD_DISABLE_HOTJAR`; degrade-to-noop (38) |
+| Lottie | Active | [`connections/lottie.md`](connections/lottie.md) | **Optional** motion verify (Lottie JSON); static floor = `validate-motion.cjs` (MO-* warnings + perf budget); player opt-in; WARN-never-block, degrade-to-static/code-only |
+| Rive | Active | [`connections/rive.md`](connections/rive.md) | **Optional** motion verify (Rive `.riv`); size + RIVE-header floor; deep state-machine graph via opt-in Rive runtime, else manual-review advisory; WARN-never-block |
+| Framer | Active | [`connections/framer.md`](connections/framer.md) | **AI-native** (canvas) — read frames + write proposals; MCP probe; degrade-to-code-only |
+| Penpot | Active | [`connections/penpot.md`](connections/penpot.md) | **AI-native** (canvas) — open-source Figma alt; self-hosted-vs-cloud probe; degrade-to-code-only |
+| Webflow | Active | [`connections/webflow.md`](connections/webflow.md) | **AI-native** (generator) — read site structure as an adaptation source (not CMS authoring); degrade-to-code-only |
+| v0.dev | Active | [`connections/v0-dev.md`](connections/v0-dev.md) | **AI-native** (generator) — Vercel v0; MCP-first → REST + `V0_API_KEY`; component-generator `v0` impl |
+| Plasmic | Active | [`connections/plasmic.md`](connections/plasmic.md) | **AI-native** (dual) — canvas read + code emission; component-generator `plasmic` impl |
+| Builder.io | Active | [`connections/builder-io.md`](connections/builder-io.md) | **AI-native** (generator) — Visual Copilot, pull-only currently; component-generator `builder-io` impl |
+| LaunchDarkly | Active | [`connections/launchdarkly.md`](connections/launchdarkly.md) | **Outcome** (experiment-source) — read-only A/B results (`LAUNCHDARKLY_API_KEY`/MCP); `experiment-result-ingester` → `design_arms`; `GDD_DISABLE_LAUNCHDARKLY`; degrade-to-noop |
+| Statsig | Active | [`connections/statsig.md`](connections/statsig.md) | **Outcome** (experiment-source) — read-only experiment/pulse results (`STATSIG_API_KEY`/MCP); → `design_arms`; `GDD_DISABLE_STATSIG`; degrade-to-noop |
+| GrowthBook | Active | [`connections/growthbook.md`](connections/growthbook.md) | **Outcome** (experiment-source) — read-only results (`GROWTHBOOK_API_KEY`, self-hosted/cloud, /MCP); → `design_arms`; `GDD_DISABLE_GROWTHBOOK`; degrade-to-noop |
+| UserTesting | Active | [`connections/usertesting.md`](connections/usertesting.md) | **Outcome** (user-research) — read-only test reports; **pseudonymize-first** → `user-research-synthesizer` → brief `<prior-research>`; `GDD_DISABLE_USERTESTING`; degrade-to-noop |
+| Maze | Active | [`connections/maze.md`](connections/maze.md) | **Outcome** (user-research) — read-only usability metrics; **pseudonymize-first** → `user-research-synthesizer`; `GDD_DISABLE_MAZE`; degrade-to-noop |
+| Hotjar | Active | [`connections/hotjar.md`](connections/hotjar.md) | **Outcome** (user-research) — read-only indexed insights (no raw video); **pseudonymize-first** → `user-research-synthesizer`; `GDD_DISABLE_HOTJAR`; degrade-to-noop |
 
 ---
 
@@ -56,8 +56,8 @@ This directory contains connection specifications for external tools and MCPs th
 
 Each cell describes what the connection contributes at that pipeline stage, or `—` if it is not used.
 
-| Connection | scan | discover | plan | design | verify | canvas | generator | notify | ticket-sync |
-|-----------|------|----------|------|--------|--------|--------|-----------|--------|------------|
+| Connection | brief | explore | plan | design | verify | canvas | generator | notify | ticket-sync |
+|-----------|-------|---------|------|--------|--------|--------|-----------|--------|------------|
 | gdd-state | STATE mutation (init position, probe_connections, add_decision) | STATE mutation (add_decision, add_must_have, transition gate) | STATE mutation (locked decisions, must_haves, transition gate) | STATE mutation (update_progress, resolve_blocker, transition gate) | STATE mutation (must_have pass/fail, add_blocker, set_status) | — | — | — | — |
 | Figma | token augmentation via `get_variable_defs` (CONN-03) | decisions pre-populate via `get_variable_defs` (CONN-04) | — | write tokens/annotations/Code Connect via `use_figma` (FWR-01..04) | — | — | — | — | — |
 | Refero | — | reference search via `mcp__refero__search`; fallback → awesome-design-md (CONN-05) | — | — | — | — | — | — | — |
@@ -66,35 +66,35 @@ Each cell describes what the connection contributes at that pipeline stage, or `
 | Chromatic | — | — | change-risk scoping (CHR-02) | — | visual delta narration (CHR-01) | — | — | — | — |
 | Graphify | — | — | dependency scoping (GRF-03) | — | orphan detection (GRF-04) | — | — | — | — |
 | Pinterest | probe only | visual reference search via `pinterest_search`; fallback → Refero → awesome-design-md | — | — | — | — | — | — | — |
-| Claude Design | bundle probe → `claude_design: available` | synthesizer handoff mode — parses bundle → D-XX decisions; discussant `--from-handoff` confirms | — (skipped in handoff) | — (skipped in handoff) | Handoff Faithfulness section; bidirectional write-back via figma-writer `implementation-status` mode | — | — | — | — |
+| Claude Design | bundle probe → `claude_design: available` | synthesizer handoff mode — parses bundle → decisions; discussant `--from-handoff` confirms | — (skipped in handoff) | — (skipped in handoff) | Handoff Faithfulness section; bidirectional write-back via figma-writer `implementation-status` mode | — | — | — | — |
 | paper.design | — | canvas read: `get_selection`, `get_jsx`, `get_computed_styles` | — | paper-writer: annotate/tokenize/roundtrip | `get_screenshot` for `? VISUAL` | ✓ | — | — | — |
 | pencil.dev | `.pen` discovery | `.pen` as canonical design source | — | pencil-writer: annotate/roundtrip | spec-vs-impl diff | ✓ | — | — | — |
 | 21st.dev | — | prior-art gate: marketplace search before greenfield build | — | component-generator (21st impl) | — | — | ✓ | — | — |
 | Magic Patterns | — | — | — | component-generator (magic-patterns impl) | preview_url → `? VISUAL` check | — | ✓ | — | — |
 | OpenRouter | — | — | — | — | — | — | ✓ (model-router: tier→model resolution, all stages) | — | — |
-| Xcode Simulator | — | — | — | native iOS code-gen target (swift-executor / emitSwift) | rendered SwiftUI snapshot when simulator available, else degrade to code-only structural audit (D-03) | — | — | — | — |
-| Android Emulator | — | — | — | native Android code-gen target (compose-executor / emitCompose) | rendered Compose screenshot when emulator available, else degrade to code-only structural audit (D-03) | — | — | — | — |
-| Litmus | — | — | — | email render-test target (email-executor) | cross-client rendered evidence when Litmus available, else degrade to the static email-HTML validator / code-only (D-03) | — | — | — | — |
-| Print-Renderer | — | — | — | print render-test target (pdf-executor) | rendered PDF/page evidence when the print-render is available, else degrade to the static print-CSS validator / code-only (D-03) | — | — | — | — |
-| Lottie | — | — | — | — | Lottie-export motion check: `validate-motion.cjs` (MO-FR/DUR/IMG/BUDGET) when present, WARN-never-block (D-02) | — | — | — | — |
-| Rive | — | — | — | — | Rive-export motion check: size + RIVE-header floor; state-machine graph via opt-in runtime, else manual-review advisory; WARN (D-02/D-04) | — | — | — | — |
+| Xcode Simulator | — | — | — | native iOS code-gen target (swift-executor / emitSwift) | rendered SwiftUI snapshot when simulator available, else degrade to code-only structural audit | — | — | — | — |
+| Android Emulator | — | — | — | native Android code-gen target (compose-executor / emitCompose) | rendered Compose screenshot when emulator available, else degrade to code-only structural audit | — | — | — | — |
+| Litmus | — | — | — | email render-test target (email-executor) | cross-client rendered evidence when Litmus available, else degrade to the static email-HTML validator / code-only | — | — | — | — |
+| Print-Renderer | — | — | — | print render-test target (pdf-executor) | rendered PDF/page evidence when the print-render is available, else degrade to the static print-CSS validator / code-only | — | — | — | — |
+| Lottie | — | — | — | — | Lottie-export motion check: `validate-motion.cjs` (MO-FR/DUR/IMG/BUDGET) when present, WARN-never-block | — | — | — | — |
+| Rive | — | — | — | — | Rive-export motion check: size + RIVE-header floor; state-machine graph via opt-in runtime, else manual-review advisory; WARN | — | — | — | — |
 | Framer | — | — | — | canvas source (read frames, write proposals) | — | ✓ | — | — | — |
 | Penpot | — | — | — | canvas source (read boards/components) | — | ✓ | — | — | — |
 | Webflow | — | — | — | structure / adaptation source | — | — | ✓ | — | — |
 | v0.dev | — | — | — | component-generator (v0 impl) | — | — | ✓ | — | — |
 | Plasmic | — | — | — | component-generator (plasmic impl) + canvas read | — | ✓ | ✓ | — | — |
 | Builder.io | — | — | — | component-generator (builder-io impl) | — | — | ✓ | — | — |
-| Lazyweb | — | reference search via `lazyweb_search` (**Tier 1 — free, tried first**; D-01); complements refero/pinterest | — | — | — | — | — | — | — |
-| Mobbin | — | reference search via mobbin tools (**Tier 2 — paid, mobile/flow-level**; D-01); complements refero/lazyweb | — | — | — | — | — | — | — |
-| Slack | — | — | — | — | — | — | — | verify-fail/audit-pass/ship → Slack webhook (routed, redacted, degrade-to-noop; D-04/D-05) | — |
+| Lazyweb | — | reference search via `lazyweb_search` (**Tier 1 — free, tried first**); complements refero/pinterest | — | — | — | — | — | — | — |
+| Mobbin | — | reference search via mobbin tools (**Tier 2 — paid, mobile/flow-level**); complements refero/lazyweb | — | — | — | — | — | — | — |
+| Slack | — | — | — | — | — | — | — | verify-fail/audit-pass/ship → Slack webhook (routed, redacted, degrade-to-noop) | — |
 | Discord | — | — | — | — | — | — | — | parity with Slack — events → Discord webhook (routed, redacted, degrade-to-noop) | — |
-| Linear | — | — | — | — | — | — | — | — | bidirectional cycle↔issue: read comments (decision-injector) + transition + redacted summary on completion (D-03) |
+| Linear | — | — | — | — | — | — | — | — | bidirectional cycle↔issue: read comments (decision-injector) + transition + redacted summary on completion |
 | Jira | — | — | — | — | — | — | — | — | parity with Linear — Atlassian MCP; transition + redacted summary on completion |
 
 **Column definitions:**
 
-- **scan** — what the connection provides when the scan stage runs (design tokens, source metadata)
-- **discover** — what the connection provides during discovery (visual references, design decisions)
+- **brief** — what the connection provides when the brief stage runs (design tokens, source metadata)
+- **explore** — what the connection provides during exploration (visual references, design decisions)
 - **plan** — what the connection contributes to planning artifacts
 - **design** — what the connection provides during design execution
 - **verify** — what the connection checks or surfaces during verification
@@ -235,7 +235,7 @@ Step G1 — Bash: test -n "$DISCORD_WEBHOOK_URL"
   → non-empty                      → discord: available
 ```
 
-Note: Lazyweb + Mobbin probes are ToolSearch-only (no live call). The discover stage resolves reference sources **cost-aware (D-01): Lazyweb (free) → Mobbin / Refero (paid, whichever is bound + subscribed) → Pinterest → awesome-design-md → WebFetch.**
+Note: Lazyweb + Mobbin probes are ToolSearch-only (no live call). The explore stage resolves reference sources **cost-aware: Lazyweb (free) → Mobbin / Refero (paid, whichever is bound + subscribed) → Pinterest → awesome-design-md → WebFetch.**
 
 ---
 
@@ -294,7 +294,7 @@ Note: First Chromatic run has no baseline — all stories become new snapshots.
 **Graphify probe (execute at agent entry, before using graph):**
 
 ```
-Step G1 — Config check (per D-09 direct read, no CLI subcommand):
+Step G1 — Config check (direct read, no CLI subcommand):
   Bash: node -e "try{const c=JSON.parse(require('fs').readFileSync('.design/config.json','utf8'));process.stdout.write(String(c.graphify?.enabled===true))}catch{process.stdout.write('false')}"
   → false → graphify: not_configured
   → true  → proceed to Step G2
@@ -328,19 +328,18 @@ To add a new connection to the pipeline:
 
 4. **Declare the MCP.** If the connection uses an MCP server, ensure the server is declared in `.claude-plugin/plugin.json` or documented as a user-supplied MCP in the spec file. For read+write remote MCPs, use `connections/figma.md` as the model. For read-only remote MCPs with headless / API-key-free setup, use `connections/pinterest.md`.
 
-5. **Wire into stage skills (Phase 2+ work).** Update the relevant stage `SKILL.md` files to probe the connection at entry and write its status to `.design/STATE.md <connections>`.
+5. **Wire into stage skills.** Update the relevant stage `SKILL.md` files to probe the connection at entry and write its status to `.design/STATE.md <connections>`.
 
-6. **Update relevant agents (Phase 2+ work).** If agents will use the connection's tools, list the MCP tools in the agent's `tools` frontmatter field.
+6. **Update relevant agents.** If agents will use the connection's tools, list the MCP tools in the agent's `tools` frontmatter field.
 
 ---
 
 ## Notes
 
-- `connections/` is infrastructure scaffolding introduced in Phase 1. Stage integration (wiring detection and graceful degradation into each stage) is Phase 2 work.
-- Phase 8 added five new active connections. Linear and GitHub remain planned for a future phase.
-- Phase 14 added four AI-native design tool connections (paper.design, pencil.dev, 21st.dev, Magic Patterns) and the canvas/generator capability columns.
-- Phase 20 added `gdd-state` — a local stdio MCP server shipped with the plugin that owns STATE.md mutation across every pipeline stage. Unlike external connections, `gdd-state` is required (fallback to direct module import preserves mutation safety but loses event telemetry). See [`connections/gdd-state.md`](connections/gdd-state.md).
-- The capability matrix columns map to the five pipeline stages: `scan | discover | plan | design | verify`, plus `canvas` and `generator` sub-categories.
+- `connections/` is the infrastructure scaffolding that catalogs external integrations. Stage integration wires detection and graceful degradation into each pipeline stage.
+- AI-native design tool connections (paper.design, pencil.dev, 21st.dev, Magic Patterns) populate the canvas/generator capability columns.
+- `gdd-state` is a local stdio MCP server shipped with the plugin that owns STATE.md mutation across every pipeline stage. Unlike external connections, `gdd-state` is required (fallback to direct module import preserves mutation safety but loses event telemetry). See [`connections/gdd-state.md`](connections/gdd-state.md).
+- The capability matrix columns map to the five pipeline stages: `brief | explore | plan | design | verify`, plus `canvas` and `generator` sub-categories.
 
 ---