@playcraft/cli 0.0.44 → 0.0.47

package/project-template/templates/project-state.template.md

@@ -1,237 +1,136 @@
 # Project State
 
+> **Agent entry**: run `npm run state:get` first. Use its summary (`iteration`, `loop`, `nextCommands`, required/deferred files). Do **not** read this entire file during Ring 1 — the handoff YAML block below is the machine source of truth.
+
 ## Workflow spec
 
 | Field                   | Value                                                                 |
 | ----------------------- | --------------------------------------------------------------------- |
-| **workflowSpecVersion** | `convergence-v1`                                                      |
-| **Changelog**           | [docs/team/workflow-changelog.md](../docs/team/workflow-changelog.md) |
+| **templateVersion**     | `0.3.2-alpha.0`                                                       |
+| **workflowSpecVersion** | `growth-rings-v1`                                                     |
+| **Template Changelog**  | [CHANGELOG.md](../CHANGELOG.md)                                       |
+| **Workflow Changelog**  | [docs/team/workflow-changelog.md](../docs/team/workflow-changelog.md) |
+
+## Ring Gate Scope
+
+| Field            | Value                                                                                                     |
+| ---------------- | --------------------------------------------------------------------------------------------------------- |
+| ringGatePolicy   | `ring gate checks objective DoD verifiers + non-regression of prior rings + user-decision readiness only` |
+| ringGateExcludes | `subjective quality judgment, gameplay fun, final visual taste, user preference choice`                   |
+
+## Settings
+
+| Field                  | Value   | Description                                                                                  |
+| ---------------------- | ------- | -------------------------------------------------------------------------------------------- |
+| **designerAutoDecide** | `false` | When `true`, Game Designer may self-decide simple/obvious questions without asking the user. |
 
 <!--
-  convergence-v1: Three convergence loops — design_check (Gate #1/#2b) → ui_pass/ui_review/ui_rework → gameplay_pass/load_check → Gate #3.
-  Visual baseline (designer-handoff-v2): Phase 1 = MC + ASR; Phase 2 Designer = audio + digit strip + VisualAtom status only.
+  designerAutoDecide:
+    false (default) = Designer asks the user every brainstorm question via AskUserQuestion.
+    true            = Designer may auto-decide questions that have an obvious best answer based on
+                      genre convention, research, or hard constraints. Auto-decisions are logged in
+                      design-brief.md as [AGENT-AUTO] with reasoning. The user can override any
+                      auto-decision in subsequent rounds.
+
+  Only affects brainstorm questions. Ring Gate confirmations remain orchestrator-only regardless.
+-->
+
+<!--
+  growth-rings-v1: Four growth rings climb the atom-tree from engine root upward.
+  Each ring runs clarify → build → verify inner loops with full role collaboration.
+  Objective DoD verifiers replace pre-development document packages.
 -->
 
 ## User Intent
 
 > {{user_intent — ≤2 sentences; do NOT restate Style Direction or five-axis tables from design-brief}}
 
-## Gate #1 Options
+## Current Iteration
 
-<!--
-  Gate #1 only — orchestrator reads this + design-brief. One row per option; no Style Direction prose.
-  Delete this section after Gate #1 passes.
--->
+> **Human-readable view.** The machine source of truth is the `## Agent handoff` YAML block below (`iteration:` + `loop:` + `ringGate:` + `ringDoD:`). `workflow-doctor` and agents read that block; keep this prose in sync for humans.
+
+**Iteration {{current_iteration}}** — {{iteration_description}}
 
-| Option | Mechanic | Dimension | Interaction | Narrative | Arc   | Risk             | Recommended |
-| ------ | -------- | --------- | ----------- | --------- | ----- | ---------------- | ----------- |
-| A      | {{…}}    | {{…}}     | {{…}}       | {{L0–L3}} | {{…}} | {{low/med/high}} | {{yes/no}}  |
-| B      | {{…}}    | {{…}}     | {{…}}       | {{…}}     | {{…}} | {{…}}            | {{yes/no}}  |
+`1 (engine-root → core gameplay)` → `2 (gameplay + periphery)` → `3 (playable ad hook/CTA)` → `4 (production + architecture)` → `done`
 
-## Current Stage
+Each iteration runs inner loops: `clarify` → `build` → `verify` → **Ring Gate** (user acceptance) → next iteration.
 
-**{{current_stage}}** — {{stage_description}}
+<!-- Iteration definitions: see CLAUDE.md § Growth-Ring Model -->
 
-`pm` → `style_exploration` → `production` → `ui_pass` → `ui_review` ⇄ `ui_rework` → `gameplay_pass` → `done`
+## Ring DoD (current iteration)
 
-<!-- Stage definitions: see CLAUDE.md § Stage Model -->
+> Objective Definition-of-Done for the **current** growth ring. Orchestrator runs `npm run ring:gate -- --iteration N` to update verifier status.
+> **Human-readable view.** Machine source of truth is `ringDoD:` in the `## Agent handoff` YAML block.
 
-## Gates
+| Check         | Status             | Verifier                      | Notes                                                                                                           |
+| ------------- | ------------------ | ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| contract      | {{passed/pending}} | `npm run verify:contract`     | Engine boots; neutral runtime contract wired (`window.__playable`)                                              |
+| lifecycle     | {{passed/pending}} | `npm run verify:lifecycle`    | Ring 1: starts at HOOK and autoPlay reaches ENDCARD without MP4                                                 |
+| firstLevelWin | {{passed/pending}} | `npm run verify:firstwin`     | Ring 1: headless autoPlay reaches ENDCARD (first level winnable)                                                |
+| placeholders  | {{passed/pending}} | `npm run verify:placeholders` | Ring 1+: every `load.*` path exists on disk + `assets/images/` non-empty (placeholder-first, no pure code-draw) |
 
-> Only the **orchestrator** runs `AskUserQuestion` toward the user. Sub-agents set `pending` and STOP.
+> Future-ring DoD checks are hidden at Ring 1. Run `npm run state:get` after each loop/ring transition to see the active verifier set.
 
-| Gate               | Status             | Notes                                                                        |
-| ------------------ | ------------------ | ---------------------------------------------------------------------------- |
-| #1 Direction       | {{passed/pending}} | Orchestrator confirms after PM four docs + Reviewer design_check + STOP      |
-| #2a MC selection   | {{passed/pending}} | Orchestrator picks A/B/C → sets `selectedMcOption` below                     |
-| #2b MC + ASR final | {{passed/pending}} | Reviewer design_check → Orchestrator confirms MC + ASR → `stage: production` |
-| #3 Dev acceptance  | {{passed/pending}} | Reviewer load_check pass → user opens devUrl (orchestrator link only)        |
+## Ring Gate
+
+> Only the **orchestrator** runs `AskUserQuestion` toward the user. Sub-agents set `ringGate: pending` and STOP.
+> One Ring Gate per iteration replaces the old six waterfall gates.
+
+| Field      | Value              | Notes                                                                       |
+| ---------- | ------------------ | --------------------------------------------------------------------------- |
+| ringGate   | {{passed/pending}} | Orchestrator confirms after all ring DoD checks pass + user plays at devUrl |
+| iteration  | {{1..4}}           | Current growth ring                                                         |
+| canAskUser | {{yes/no}}         | Set by `ring:gate` runner — only `yes` when all DoD checks pass             |
 
 ## Agent handoff
 
 > Sub-agents and orchestrator **must** read/write this block before STOP or invoke. See `docs/team/collaboration.md` § Agent Handoff.
+> This block is the **single machine-readable source of truth** for `iteration`, `loop`, `ringGate`, and `ringDoD`.
 
 ```yaml
+iteration: 1
+ringGoal: engine-root + core gameplay (placeholder art)
+loop: clarify
 subagent: none
 subagent_stop: false
 waiting_for: orchestrator
-gate_pending: null
+ringGate: pending
+ringDoD: { contract: pending, lifecycle: pending, firstLevelWin: pending, placeholders: pending }
+archivedRings: {}
 next_orchestrator_action: null
 last_completed_by: null
-rework_round: 0
 block_reason: null
 ```
 
-<!--
-Examples (copy structure on STOP — do not leave nulls):
-
-PM Gate #1 STOP:
-  subagent: pm
-  subagent_stop: true
-  waiting_for: user_gate
-  gate_pending: "1"
-  next_orchestrator_action: "Run Gate #1 AskUserQuestion"
-  last_completed_by: pm
-  rework_round: 0
-
-Designer Gate #2a STOP:
-  subagent: designer
-  subagent_stop: true
-  waiting_for: user_gate
-  gate_pending: "2a"
-  next_orchestrator_action: "Run Gate #2a"
-  last_completed_by: designer
-
-Developer ui_pass STOP:
-  subagent: developer
-  subagent_stop: true
-  waiting_for: orchestrator
-  gate_pending: null
-  next_orchestrator_action: "Invoke @reviewer ui_diff"
-  last_completed_by: developer
-
-Reviewer ui_diff pass STOP:
-  subagent: reviewer
-  subagent_stop: true
-  waiting_for: orchestrator
-  gate_pending: null
-  next_orchestrator_action: "Set stage=gameplay_pass, invoke @developer"
-  last_completed_by: reviewer
--->
-
-## Gate resume fields
-
-| Field            | Value                                              |
-| ---------------- | -------------------------------------------------- |
-| selectedMcOption | {{A / B / C — set by orchestrator after Gate #2a}} |
-| uiReworkRound    | {{0–5 — incremented by Reviewer on ui_diff fail}}  |
-
-## Dev Preview
-
-| Field          | Value                                                                        |
-| -------------- | ---------------------------------------------------------------------------- |
-| devCommand     | npm run dev                                                                  |
-| devScript      | {{from package.json scripts.dev}}                                            |
-| devUrl         | {{http://... — Developer records when ready; orchestrator uses for Gate #3}} |
-| devStatus      | pending / ui_ready / ready / blocked_upstream / failed                       |
-| devBlockers    | {{list: assetPath, issue, routeTo (TA/Designer/PM), status}}                 |
-| devStartedBy   | developer / reviewer / orchestrator                                          |
-| devLastChecked | {{ISO timestamp}}                                                            |
-| loadCheck      | pending / passed / failed                                                    |
-| loadCheckNotes | {{console errors, white screen, load time}}                                  |
-
-## UI Review
-
-| Field            | Value                                      |
-| ---------------- | ------------------------------------------ |
-| uiReviewStatus   | pending / passed / failed                  |
-| uiReworkRound    | {{0–5}}                                    |
-| uiDiffReportPath | logs/review-report.md                      |
-| uiDiffNotes      | {{summary of MC vs screenshot comparison}} |
-
-<!--
-devStatus:
-  pending           — ui_pass or gameplay_pass not finished
-  ui_ready          — UI shell complete (scene switch, layout, simple states); safe to invoke Reviewer ui_diff
-  ready             — gameplay_pass complete; safe to invoke Reviewer load_check
-  blocked_upstream  — Developer waiting on TA/Designer rework (orchestrator re-invokes)
-  failed            — dev server could not start; document error
-
-Developer MUST NOT set ui_ready/ready while devBlockers has open items.
--->
-
-## File Index
-
-### PM Output
-
-| File                                    | Description                                   | Status     |
-| --------------------------------------- | --------------------------------------------- | ---------- |
-| [design-brief.md](docs/design-brief.md) | Style Direction + experience flow (mechanics) | {{status}} |
-| [layout-spec.md](docs/layout-spec.md)   | Paths, palette hex, assetMapping, atlas       | {{status}} |
-| [atom-plan.json](docs/atom-plan.json)   | skillsMatch + atoms[] (machine contract)      | {{status}} |
-| [atom-plan.md](docs/atom-plan.md)       | Acceptance criteria + Context enrichments     | {{status}} |
-
-### Designer Output
-
-| File/Directory                                    | Description                               | Status     |
-| ------------------------------------------------- | ----------------------------------------- | ---------- |
-| [style-exploration.md](docs/style-exploration.md) | Style options + concept mockups (Phase 1) | {{status}} |
-| [designer-log.md](logs/designer-log.md)           | Work log + delivery manifest              | {{status}} |
-| `assets/images/`                                  | Key creative samples (Designer)           | {{status}} |
-| `assets/audio/`                                   | BGM + SFX (original generation)           | {{status}} |
-| `assets/bundles/`                                 | Designer atom bundles                     | {{status}} |
-
-### Technical Artist Output
-
-| File/Directory              | Description                                                      | Status     |
-| --------------------------- | ---------------------------------------------------------------- | ---------- |
-| [ta-log.md](logs/ta-log.md) | Work log + compliance report                                     | {{status}} |
-| `assets/images/`            | Completed asset set (TA completions + sprite sheets + processed) | {{status}} |
-| `assets/audio/`             | Post-processed audio (compress/trim/loop)                        | {{status}} |
-| `assets/bundles/`           | TA atom bundles                                                  | {{status}} |
-
-### Developer Output
-
-| File/Directory                            | Description                                            | Status     |
-| ----------------------------------------- | ------------------------------------------------------ | ---------- |
-| [developer-log.md](logs/developer-log.md) | Work log + Dev self-check + devUrl + upstream blockers | {{status}} |
-| `game/gameplay/`                          | PGS + state machine                                    | {{status}} |
-| `game/config/`                            | Level configuration                                    | {{status}} |
-| `game/scenes/`                            | Scene definitions                                      | {{status}} |
-| `game/index.html`                         | Entry point                                            | {{status}} |
+## Handoff Context
 
-### Reviewer Output
+> Structured shared working memory. Machine source of truth is `handoffContext` in `docs/project-state.json`; agents read it through `npm run state:get -- --json contextPacket`.
 
-| File                                                      | Description                                 | Status     |
-| --------------------------------------------------------- | ------------------------------------------- | ---------- |
-| [review-report.md](logs/review-report.md)                 | design_check / ui_diff / load_check reports | {{status}} |
-| [intent-clarifications.md](docs/intent-clarifications.md) | Agent-to-agent Q&A (ICP)                    | {{status}} |
+| Area                        | Value                                                  |
+| --------------------------- | ------------------------------------------------------ |
+| ring.summary                | Ring 1 starts as a semantic placeholder playable demo. |
+| lastRole.role               | none                                                   |
+| lastRole.summary            | No sub-agent has completed work yet.                   |
+| nextRole.role               | orchestrator                                           |
+| nextRole.mustKnow           | Run state:get and follow currentAction / nextCommands. |
+| shared.engine               | unset                                                  |
+| shared.coreAction           | unset                                                  |
+| shared.semanticPlaceholders | none                                                   |
+| openQuestions               | none                                                   |
 
-## Production Pipeline (Serial)
-
-<!-- Only relevant when stage = production or transitioning to ui_pass -->
-
-| Wave | Agent            | Status     | Notes                                      |
-| ---- | ---------------- | ---------- | ------------------------------------------ |
-| 1    | Designer         | {{status}} | Ph.2: audio + digit + VisualAtom status    |
-| 2    | Technical Artist | {{status}} | Spec Quick-Check → bulk → Compliance green |
-
-<!-- Wave 3 Developer runs in stage = ui_pass — not tracked here -->
-
-## Intent Clarification Tracking
-
-<!-- Monitor ICP activity during production -->
-
-| Metric                                     | Value      |
-| ------------------------------------------ | ---------- |
-| Open questions in intent-clarifications.md | {{count}}  |
-| Unresolved for > 10 min                    | {{count}}  |
-| Designer questions received                | {{count}}  |
-| TA questions received                      | {{count}}  |
-| Developer questions received               | {{count}}  |
-| PM intervention needed                     | {{yes/no}} |
+> Handoff examples: see [collaboration.md](../docs/team/collaboration.md#agent-handoff) and use `npm run state:set` to update keys. Ring 1 clarify routes Game Designer → temporary ref-flow atom selection → scaffold gate → Developer.
 
 <!--
-PM monitors this table:
-  - Open questions > 3 → PM must intervene
-  - Single Agent receives > 3 questions → record "intent transmission fault" in DAG Revisions
+  Deferred human tables (Ring Gate Runner, Archived Rings, Dev Preview, Progress Checkpoint, …)
+  are updated by npm run state:set / ring:gate. Full field reference: docs/team/collaboration.md
 -->
 
-<!--
-Orchestrator serial rules:
-  - Gate #2b passed → invoke @designer only (Wave 1)
-  - Wave 1 = done → invoke @technical-artist (Wave 2)
-  - Wave 2 = done → stage: ui_pass → invoke @developer
-  - Optional: 30s spot-check ta-log Compliance + contract paths exist before @developer
--->
-
-## Progress Checkpoint
+## File Index (current ring)
 
-<!--
-One row per major step — decision summary only, not full contract text.
-Gate #1 example Notes: "Option B recommended; Competence + match-3" (not a copy of design-brief).
--->
+| File                                      | Description                                             | Status     |
+| ----------------------------------------- | ------------------------------------------------------- | ---------- |
+| [DESIGN.md](docs/DESIGN.md)               | Player experience contract: core loop + first-level win | {{status}} |
+| [developer-log.md](logs/developer-log.md) | Developer work log + devUrl                             | {{status}} |
+| `game/`                                   | Runtime implementation                                  | {{status}} |
 
-| #     | Stage     | Agent     | Action            | Result      | Notes                         |
-| ----- | --------- | --------- | ----------------- | ----------- | ----------------------------- |
-| {{n}} | {{stage}} | {{agent}} | {{what_was_done}} | {{outcome}} | {{key_decisions_or_blockers}} |
+> Hidden until later Rings: `docs/design-brief.md`, `docs/layout-spec.md`, `docs/implementation-plan.md`, `docs/style-exploration.md`, `logs/artist-log.md`, `logs/ta-log.md`, `logs/review-report.md`, production pipeline.

package/project-template/templates/review-report.template.md

@@ -1,38 +1,170 @@
 # Review Report
 
-> Fill **one section** matching the review mode orchestrator invoked: `design_check` | `ui_diff` | `load_check`.
+> Fill **one section** matching the review mode orchestrator invoked: `design_check` | `execution_plan_check` | `gameplay_conformance` | `ui_diff` | `load_check` | `playable_validate`.
 
 ## Review Mode
 
-**{{design_check / ui_diff / load_check}}** — {{ISO timestamp}}
+**{{design_check / execution_plan_check/ gameplay_conformance / ui_diff / load_check / playable_validate}}** — {{ISO timestamp}}
 
 ## Verdict
 
 **{{pass / fail}}**
 
+## Ring DoD Fields
+
+> Orchestrator runs `npm run ring:gate -- --iteration N` **after** Reviewer STOP. Only **Reviewer evidence** fields must be `pass`/`fail` before STOP; **runner-owned script** fields stay `pending` until `ring:gate` executes verifiers.
+
+| Field          | Owner    | Value                                           |
+| -------------- | -------- | ----------------------------------------------- |
+| iteration      | both     | {{1 / 2 / 3 / 4}}                               |
+| blockingIssues | Reviewer | {{0..N}}                                        |
+| failRouteTo    | Reviewer | {{developer / reviewer / game-designer / none}} |
+| failReason     | Reviewer | {{one-line summary}}                            |
+
+### Reviewer evidence (pass/fail required before STOP — ring 2+ only)
+
+> Ring 1 `lifecycle` and `firstLevelWin` are script-owned (`npm run verify:lifecycle`, `npm run verify:firstwin`). Hook enforces these only when active for the current ring.
+
+| Field               | Value                                                          |
+| ------------------- | -------------------------------------------------------------- |
+| gameplayConformance | {{pass / fail / pending / n-a — ring 2+ gameplay_conformance}} |
+| hookCta             | {{pass / fail / pending / n-a — ring 3+ playable_validate}}    |
+| uiDiff              | {{pass / fail / pending / n-a — ring 4 ui_diff only}}          |
+
+### Runner-owned script fields (leave pending until ring:gate)
+
+> `gate-runner.mjs` runs npm verifiers and writes results — Reviewer must **not** pre-fill pass/fail.
+
+| Field           | Verifier script         | Value                       |
+| --------------- | ----------------------- | --------------------------- |
+| contract        | verify:contract         | pending                     |
+| lifecycle       | verify:lifecycle        | pending (ring 1+)           |
+| firstLevelWin   | verify:firstwin         | pending (ring 1+)           |
+| oneClickEndcard | record:mp4 → ENDCARD    | pending (ring 2+)           |
+| verifyUi        | verify:ui               | pending / n-a               |
+| fullPlaythrough | record:mp4 full session | pending / n-a               |
+| visualDiff      | verify:visual           | pending / n-a (ring 4)      |
+| assetBudget     | verify:ui:assets        | pending / n-a               |
+| atomConformance | verify:atom-conformance | pending / n-a (ring 4 only) |
+
+---
+
+## design_check (ring 1 clarify / ring 3 verify ASR)
+
+### Ring context
+
+**{{ring 1 — design package / ring 3 — ASR handoff pack}}**
+
+### Contract Checks
+
+| Item                                   | Pass?      | Notes       |
+| -------------------------------------- | ---------- | ----------- |
+| Required files exist                   | {{yes/no}} | {{details}} |
+| Required sections non-empty            | {{yes/no}} | {{details}} |
+| Gate-specific mandatory fields present | {{yes/no}} | {{details}} |
+| Evidence files present                 | {{yes/no}} | {{details}} |
+
+### Blocking Issues
+
+| #     | Issue           | routeTo                |
+| ----- | --------------- | ---------------------- |
+| {{n}} | {{description}} | game-designer / artist |
+
+### Evidence
+
+| Evidence               | Path / note | Present?   |
+| ---------------------- | ----------- | ---------- |
+| Primary contract doc   | {{path}}    | {{yes/no}} |
+| Secondary contract doc | {{path}}    | {{yes/no}} |
+| Supporting artifact    | {{path}}    | {{yes/no}} |
+
+### Outcome
+
+{{pass → orchestrator may run ring:gate / fail → route back to agent}}
+
+---
+
+## execution_plan_check (ring 2 clarify)
+
+### Ring context
+
+**ring 2 — layout-spec + atom-tree + implementation-plan package**
+
+### Contract Checks
+
+| Item                                                                               | Pass?          | Notes       |
+| ---------------------------------------------------------------------------------- | -------------- | ----------- |
+| `layout-spec.md` exists and is structurally complete                               | {{yes/no}}     | {{details}} |
+| `atom-tree.json` exists and is structurally complete                               | {{yes/no}}     | {{details}} |
+| Optional `atom-tree.md` reading guide exists if downstream roles need it           | {{yes/no/n-a}} | {{details}} |
+| `implementation-plan.md` exists and is structurally complete                       | {{yes/no}}     | {{details}} |
+| `layout-spec` `assetMapping` is non-empty                                          | {{yes/no}}     | {{details}} |
+| `implementation-plan` features cover acceptance criteria                           | {{yes/no}}     | {{details}} |
+| Chain coherence is traceable (`layout-spec` → `atom-tree` → `implementation-plan`) | {{yes/no}}     | {{details}} |
+
+### Blocking Issues
+
+| #     | Issue           | routeTo                                |
+| ----- | --------------- | -------------------------------------- |
+| {{n}} | {{description}} | game-designer / ref-flow / plan-writer |
+
+### Evidence
+
+| Evidence            | Path / note                    | Present?       |
+| ------------------- | ------------------------------ | -------------- |
+| Layout contract     | `docs/layout-spec.md`          | {{yes/no}}     |
+| Atom manifest       | `docs/atom-tree.json`          | {{yes/no}}     |
+| Atom companion      | `docs/atom-tree.md` (optional) | {{yes/no/n-a}} |
+| Execution blueprint | `docs/implementation-plan.md`  | {{yes/no}}     |
+
+### Outcome
+
+{{pass → orchestrator may run ring:gate --iteration 2 / fail → route back to producing subagent}}
+
 ---
 
-## design_check (Gate #1 / #2b)
+## gameplay_conformance (ring DoD: gameplayConformance — ring 2+ review-backed gate)
+
+### devUrl
+
+{{http://...?debug=1}}
+
+### Check A: Design Drift
+
+| #   | 检查项                     | 结果                 | 详情        |
+| --- | -------------------------- | -------------------- | ----------- |
+| 1   | 核心玩法循环               | {{✅ / ❌ Blocking}} | {{details}} |
+| 2   | 规则体系                   | {{✅ / ❌ Blocking}} | {{details}} |
+| 3   | 胜负条件                   | {{✅ / ❌ Blocking}} | {{details}} |
+| 4   | Experience Flow 四阶段可达 | {{✅ / ❌}}          | {{details}} |
+| 5   | 首关保证                   | {{✅ / ❌ Blocking}} | {{details}} |
+
+**Summary**: {{N}} Blocking / {{M}} Non-blocking
 
-### Gate
+### Check B: Skill Leverage Evidence
 
-**{{#1 / #2b}}**
+| skillRef | Used / consulted? | Notes                 |
+| -------- | ----------------- | --------------------- |
+| {{ref}}  | {{yes/no}}        | {{reason if skipped}} |
 
-### Checklist
+### Check C: Path Verification
 
-| Item               | Pass?      | Notes       |
-| ------------------ | ---------- | ----------- |
-| {{checklist item}} | {{yes/no}} | {{details}} |
+| Path                | Screenshot                  | Result      |
+| ------------------- | --------------------------- | ----------- |
+| Hook → Tutorial     | `logs/conform-hook.png`     | {{✅ / ❌}} |
+| Tutorial → Gameplay | `logs/conform-gameplay.png` | {{✅ / ❌}} |
+| Gameplay → EndCard  | `logs/conform-endcard.png`  | {{✅ / ❌}} |
 
-### Missing / defects
+### Overall
 
-| #     | Issue           | routeTo       |
-| ----- | --------------- | ------------- |
-| {{n}} | {{description}} | pm / designer |
+- **Result**: {{PASS / FAIL}}
+- **gameplayConformance**: {{pass / fail}} — set `logs/review-report.md` § Ring DoD Fields (review-backed gate, ring 2+)
+- **Blocking Issues**: {{count}} — {{summary}}
+- **Non-blocking Notes**: {{count}} — {{summary}}
 
 ### Outcome
 
-{{pass → Run Gate / fail → re-invoke agent}}
+{{pass → `conformance: passed`, handoff `Invoke @reviewer load_check` / fail → route Developer}}
 
 ---
 
@@ -40,33 +172,48 @@
 
 ### devUrl
 
-{{http://...}}
+{{http://...?debug=1}}
+
+### Structured Visual Rubric
+
+> **MUST** fill after Reading each screenshot PNG. Evidence must describe visible content, not disk file sizes. Static `verify:ui` PASS is not enough for this section.
+
+| Check ID        | Result (PASS/FAIL) | Evidence (screenshot path + what you see) | recommendedSkill | alphaStrategy |
+| --------------- | ------------------ | ----------------------------------------- | ---------------- | ------------- |
+| bg_clean        | {{PASS/FAIL}}      | {{e.g. logs/ui-diff-game.png — ...}}      | {{playable-art / playable-verify-ui / n-a}} | {{chroma / opaque / n-a}} |
+| no_double_board | {{PASS/FAIL}}      | {{...}}                                   | {{...}}          | {{dual-bg-diff / rgb-alpha-split / n-a}} |
+| no_hud_ghost    | {{PASS/FAIL}}      | {{...}}                                   | {{playable-art / playable-verify-ui / n-a}} | {{rgb-alpha-split / n-a}} |
+| no_fake_ui      | {{PASS/FAIL}}      | {{...}}                                   | {{...}}          | {{...}}       |
+| tile_silhouette | {{PASS/FAIL}}      | {{...}}                                   | {{playable-art / playable-fx-decompose / n-a}} | {{chroma / rgb-alpha-split / overlay-diff / n-a}} |
+| text_no_overlap | {{PASS/FAIL}}      | {{...}}                                   | {{playable-verify-ui / n-a}} | {{n-a}} |
+| mc_layout       | {{PASS/FAIL}}      | {{...}}                                   | {{playable-verify-ui / artist / n-a}} | {{n-a}} |
 
 ### Scene comparisons
 
-| Scene | Screenshot            | MC reference | Severity                 | Match?     | routeTo                   | Fix suggestion |
-| ----- | --------------------- | ------------ | ------------------------ | ---------- | ------------------------- | -------------- |
-| hook  | logs/ui-diff-hook.png | {{mc path}}  | {{critical/major/minor}} | {{yes/no}} | {{developer/ta/designer}} | {{fix}}        |
+| Scene | Screenshot            | MC reference | Severity                 | Match?     | routeTo                 | recommendedSkill | alphaStrategy | Fix suggestion |
+| ----- | --------------------- | ------------ | ------------------------ | ---------- | ----------------------- | ---------------- | ------------- | -------------- |
+| hook  | logs/ui-diff-hook.png | {{mc path}}  | {{critical/major/minor}} | {{yes/no}} | {{game-designer/developer/ta/artist}} | {{playable-art / playable-fx-peak / playable-fx-decompose / playable-verify-ui / n-a}} | {{chroma / dual-bg-diff / rgb-alpha-split / black-add / n-a}} | {{fix}} |
 
 ### Summary
 
 - **uiReworkRound**: {{0–5}}
 - **Blocking issues**: {{count critical + major}}
 - **Minor only**: {{yes/no — does not block pass}}
+- **visionEvidence**: {{validate/vision/vision-evidence.json / degraded / n-a}} — {{does it support current FAIL? yes/no + one-line reason}}
 
 ### Action Items
 
-| #     | Severity     | routeTo   | Action           |
-| ----- | ------------ | --------- | ---------------- |
-| {{n}} | {{severity}} | {{agent}} | {{specific fix}} |
+| #     | Severity     | routeTo   | recommendedSkill | alphaStrategy | Action           |
+| ----- | ------------ | --------- | ---------------- | ------------- | ---------------- |
+| {{n}} | {{severity}} | {{agent}} | {{skill}}        | {{strategy}}  | {{specific fix}} |
 
 ---
 
-## load_check (pre-Gate #3)
+## load_check (ring verify — pre-Ring Gate)
 
 ### devUrl
 
-{{http://...}}
+{{http://...?debug=1}}
 
 ### Checks
 
@@ -82,7 +229,44 @@
 
 ### Outcome
 
-{{pass → Run Gate #3 / fail → route Developer}}
+{{pass → orchestrator runs npm run ring:gate -- --iteration N / fail → classify owner and route: runtime/script → Developer; asset 404/format → TA or Artist; config/design contradiction → Game Designer}}
+
+---
+
+## playable_validate (Loop 3 deep optimization)
+
+### devUrl / MP4
+
+- **MP4**: `recordings/playable-YYYYMMDD-HHmmss.mp4`
+- **Baseline**: {{path to previous MP4 or "none"}}
+- **Report**: `validate/PLAYABLE-YYYYMMDD-HHmmss.md`
+
+### Findings
+
+| Time      | Visible symptom | Severity     | routeTo                 | recommendedSkill | alphaStrategy | Status         |
+| --------- | --------------- | ------------ | ----------------------- | ---------------- | ------------- | -------------- |
+| {{MM:SS}} | {{description}} | {{P0/P1/P2}} | {{game-designer/developer/ta/artist}} | {{playable-art / playable-fx-peak / playable-fx-decompose / playable-verify-ui / n-a}} | {{chroma / dual-bg-diff / rgb-alpha-split / black-add / chroma-video / dual-bg-video / rgb-alpha-video / opaque-video / n-a}} | {{open/fixed}} |
+
+### Vision Evidence
+
+- **Path**: `validate/vision/vision-evidence.json` / degraded / n-a
+- **Annotated evidence**: {{paths to annotated PNG/MP4 frames}}
+- **Supports current FAIL?**: {{yes/no}} — {{visible evidence summary}}
+
+### Regression vs baseline
+
+- **改善**: {{...}}
+- **仍存**: {{...}}
+- **回归**: {{...}}
+
+### Overall
+
+- **Result**: {{PASS / FAIL}}
+- **P0**: {{count}} | **P1**: {{count}} | **P2**: {{count}}
+
+### Outcome
+
+{{pass → optimizationStatus: passed, handoff orchestrator Ring Gate / fail → route per routeTo, re-enter ring 4 verify}}
 
 ---