@playcraft/cli 0.0.39 → 0.0.41

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

@@ -0,0 +1,219 @@
+# Project State
+
+## Workflow spec
+
+| Field                   | Value                                                                 |
+| ----------------------- | --------------------------------------------------------------------- |
+| **workflowSpecVersion** | `production-serial-v1`                                                |
+| **Changelog**           | [docs/team/workflow-changelog.md](../docs/team/workflow-changelog.md) |
+
+<!--
+  production-serial-v1: Gate #2b → production Wave 1 Designer Ph.2 → Wave 2 TA → integration Developer.
+  Visual baseline (designer-handoff-v2): Phase 1 = MC + ASR; Phase 2 Designer = audio + digit strip + VisualAtom status only.
+-->
+
+## User Intent
+
+> {{user_intent — ≤2 sentences; do NOT restate Style Direction or five-axis tables from design-brief}}
+
+## Gate #1 Options
+
+<!--
+  Gate #1 only — orchestrator reads this + design-brief. One row per option; no Style Direction prose.
+  Delete this section after Gate #1 passes.
+-->
+
+| Option | Mechanic | Dimension | Interaction | Narrative | Arc   | Risk             | Recommended |
+| ------ | -------- | --------- | ----------- | --------- | ----- | ---------------- | ----------- |
+| A      | {{…}}    | {{…}}     | {{…}}       | {{L0–L3}} | {{…}} | {{low/med/high}} | {{yes/no}}  |
+| B      | {{…}}    | {{…}}     | {{…}}       | {{…}}     | {{…}} | {{…}}            | {{yes/no}}  |
+
+## Current Stage
+
+**{{current_stage}}** — {{stage_description}}
+
+`pm` → `style_exploration` → `production` → `integration` → `review` ⇄ `rework` → `done`
+
+<!-- Stage definitions: see CLAUDE.md § Stage Model -->
+
+## Gates
+
+> Only the **orchestrator** runs `AskUserQuestion` toward the user. Sub-agents set `pending` and STOP.
+
+| Gate               | Status             | Notes                                                                           |
+| ------------------ | ------------------ | ------------------------------------------------------------------------------- |
+| #1 Direction       | {{passed/pending}} | Orchestrator confirms after PM four docs + STOP                                 |
+| #2a MC selection   | {{passed/pending}} | Orchestrator picks A/B/C → sets `selectedMcOption` below                        |
+| #2b MC + ASR final | {{passed/pending}} | Orchestrator confirms MC + ASR sheets (UI + element) → then `stage: production` |
+| #3 Dev acceptance  | {{passed/pending}} | User opens devUrl (orchestrator link only)                                      |
+
+## Agent handoff
+
+> Sub-agents and orchestrator **must** read/write this block before STOP or invoke. See `docs/team/collaboration.md` § Agent Handoff.
+
+```yaml
+subagent: none
+subagent_stop: false
+waiting_for: orchestrator
+gate_pending: null
+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 integration STOP:
+  subagent: developer
+  subagent_stop: true
+  waiting_for: orchestrator
+  gate_pending: null
+  next_orchestrator_action: "Invoke @reviewer"
+  last_completed_by: developer
+-->
+
+## Gate resume fields
+
+| Field            | Value                                              |
+| ---------------- | -------------------------------------------------- |
+| selectedMcOption | {{A / B / C — set by orchestrator after Gate #2a}} |
+| reworkRound      | {{0 / 1 / 2 — incremented by Reviewer on 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 / ready / blocked_upstream / failed                                  |
+| devBlockers      | {{list: assetPath, issue, routeTo (TA/Designer/PM), status}}                 |
+| devStartedBy     | developer / reviewer / orchestrator                                          |
+| devLastChecked   | {{ISO timestamp}}                                                            |
+| reviewerDevCheck | pending / passed / failed                                                    |
+| reviewerDevNotes | {{UI + gameplay check summary}}                                              |
+
+<!--
+devStatus:
+  pending           — integration not finished
+  ready             — Developer self-check passed, no open blockers; safe to invoke Reviewer
+  blocked_upstream  — Developer waiting on TA/Designer rework (orchestrator re-invokes)
+  failed            — dev server could not start; document error
+
+Developer MUST NOT set 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}} |
+
+### Reviewer Output
+
+| File                                                      | Description                                      | Status     |
+| --------------------------------------------------------- | ------------------------------------------------ | ---------- |
+| [review-report.md](logs/review-report.md)                 | Six-dimension evaluation + Dev walkthrough notes | {{status}} |
+| [intent-clarifications.md](docs/intent-clarifications.md) | Agent-to-agent Q&A (ICP)                         | {{status}} |
+
+## Production Pipeline (Serial)
+
+<!-- Only relevant when stage = production or transitioning to integration -->
+
+| 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 = integration only — 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}} |
+
+<!--
+PM monitors this table:
+  - Open questions > 3 → PM must intervene
+  - Single Agent receives > 3 questions → record "intent transmission fault" in DAG Revisions
+-->
+
+<!--
+Orchestrator serial rules:
+  - Gate #2b passed → invoke @designer only (Wave 1)
+  - Wave 1 = done → invoke @technical-artist (Wave 2)
+  - Wave 2 = done → stage: integration → invoke @developer
+  - Optional: 30s spot-check ta-log Compliance + contract paths exist before @developer
+-->
+
+## Progress Checkpoint
+
+<!--
+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).
+-->
+
+| #     | Stage     | Agent     | Action            | Result      | Notes                         |
+| ----- | --------- | --------- | ----------------- | ----------- | ----------------------------- |
+| {{n}} | {{stage}} | {{agent}} | {{what_was_done}} | {{outcome}} | {{key_decisions_or_blockers}} |

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

@@ -0,0 +1,166 @@
+# Review Report
+
+## Verdict
+
+**{{pass/conditional-pass/fail}}** — Total Score: {{total}}/30
+
+## Six-Dimension Scores
+
+| Dimension               | Score     | Details                 |
+| ----------------------- | --------- | ----------------------- |
+| Experience Flow         | {{1-5}}/5 | {{specific_evaluation}} |
+| Creative Appeal         | {{1-5}}/5 | {{specific_evaluation}} |
+| Style Consistency       | {{1-5}}/5 | {{specific_evaluation}} |
+| Intent Fidelity         | {{1-5}}/5 | {{specific_evaluation}} |
+| Difficulty Balance      | {{1-5}}/5 | {{specific_evaluation}} |
+| **Intent Transmission** | {{1-5}}/5 | {{specific_evaluation}} |
+
+<!--
+Scoring guide:
+5 — Excellent: exceeds expectations, ready to ship
+4 — Good: meets standard, minor tweaks then ship
+3 — Acceptable: basically works, needs improvement
+2 — Below standard: obvious problems, partial redo
+1 — Seriously deficient: directional error, full redo
+
+Pass thresholds (6 dimensions × 5 max = 30):
+>= 24: Pass (avg 4.0 per dimension)
+18-23: Conditional pass (fix issues then re-review)
+< 18: Fail (route back to responsible agents)
+
+Intent Transmission scoring:
+5 — Zero open clarifications, TA self-check all pass, Developer mapping complete
+4 — 1-2 resolved clarifications, no impact on quality
+3 — Unresolved clarifications exist, or TA has low-confidence items
+2 — Multiple unresolved clarifications, or Developer missing visual mapping
+1 — Severe intent transmission failure, downstream agents made major wrong assumptions
+-->
+
+## DAG Coverage
+
+| Metric                              | Value                    |
+| ----------------------------------- | ------------------------ |
+| Total atoms                         | {{total}}                |
+| Completed                           | {{completed}}            |
+| Skipped                             | {{skipped}}              |
+| Blocked                             | {{blocked}}              |
+| Missing (not in plan but should be) | {{missing_list_or_none}} |
+
+## DAG Revision Audit
+
+| Revision            | Agent     | Type                  | Reasonable?             | Notes          |
+| ------------------- | --------- | --------------------- | ----------------------- | -------------- |
+| {{revision_number}} | {{agent}} | {{add/remove/modify}} | {{yes/no/questionable}} | {{assessment}} |
+
+<!--
+Assess each revision:
+- Was the change necessary?
+- Was the reason documented?
+- Did it deviate from original intent?
+- Would it have been better to escalate?
+-->
+
+## Layout Spec Compliance
+
+| Check                             | Pass?      | Details     |
+| --------------------------------- | ---------- | ----------- |
+| Asset sizes match `assetSpec`     | {{yes/no}} | {{details}} |
+| Filenames match `assetMapping`    | {{yes/no}} | {{details}} |
+| Color palette followed            | {{yes/no}} | {{details}} |
+| Element IDs aligned in code       | {{yes/no}} | {{details}} |
+| Grid config matches zones         | {{yes/no}} | {{details}} |
+| Zone coordinates in scene correct | {{yes/no}} | {{details}} |
+| Binding completeness              | {{yes/no}} | {{details}} |
+| Bidirectional closure             | {{yes/no}} | {{details}} |
+
+## Technical Checks
+
+| Check               | Pass?      | Value           | Standard                     |
+| ------------------- | ---------- | --------------- | ---------------------------- |
+| Total file size     | {{yes/no}} | {{actual_size}} | <= 5MB (ideal <= 2MB)        |
+| External requests   | {{yes/no}} | {{count}}       | 0                            |
+| CTA implementation  | {{yes/no}} | —               | Click triggers store/install |
+| Entry file exists   | {{yes/no}} | —               | game/index.html present      |
+| Viewport meta       | {{yes/no}} | —               | user-scalable=no             |
+| Orientation support | {{yes/no}} | —               | At least portrait            |
+
+## Veto Items
+
+<!-- These cause automatic FAIL regardless of score -->
+
+- [ ] First level guarantees player success
+- [ ] CTA is implemented and functional
+- [ ] Zero external network requests
+- [ ] Entry file (game/index.html) exists
+
+## Issues
+
+| #     | Severity                 | Dimension     | Description       | Suggestion     | Route To                     |
+| ----- | ------------------------ | ------------- | ----------------- | -------------- | ---------------------------- |
+| {{n}} | {{critical/major/minor}} | {{dimension}} | {{what_is_wrong}} | {{how_to_fix}} | {{PM/Designer/TA/Developer}} |
+
+<!--
+Severity levels:
+- critical: Blocks delivery, must fix
+- major: Significantly impacts quality, should fix
+- minor: Polish item, nice to fix
+
+Every issue MUST have:
+1. Specific description (not vague)
+2. Actionable fix suggestion
+3. Clear routing to responsible agent
+-->
+
+## Action Items
+
+<!--
+Aggregated from Issues table above.
+Grouped by target agent for easy handoff.
+-->
+
+### For PM
+
+| #     | Issue Ref      | Action Required     | Priority            |
+| ----- | -------------- | ------------------- | ------------------- |
+| {{n}} | Issue #{{ref}} | {{specific_action}} | {{high/medium/low}} |
+
+### For Designer
+
+| #     | Issue Ref      | Action Required     | Priority            |
+| ----- | -------------- | ------------------- | ------------------- |
+| {{n}} | Issue #{{ref}} | {{specific_action}} | {{high/medium/low}} |
+
+### For Technical Artist
+
+| #     | Issue Ref      | Action Required     | Priority            |
+| ----- | -------------- | ------------------- | ------------------- |
+| {{n}} | Issue #{{ref}} | {{specific_action}} | {{high/medium/low}} |
+
+### For Developer
+
+| #     | Issue Ref      | Action Required     | Priority            |
+| ----- | -------------- | ------------------- | ------------------- |
+| {{n}} | Issue #{{ref}} | {{specific_action}} | {{high/medium/low}} |
+
+## Rework Status
+
+<!-- Only fill if verdict is not "pass" -->
+
+| Field                    | Value                             |
+| ------------------------ | --------------------------------- |
+| Rework round             | {{1st / 2nd / N/A}}               |
+| Force Gate #3?           | {{yes (2nd round exceeded) / no}} |
+| Previous issues resolved | {{list resolved issue #s}}        |
+
+## Summary
+
+{{overall_assessment_paragraph}}
+
+<!--
+Include:
+- Overall impression from player perspective
+- Strongest dimension
+- Weakest dimension
+- Key recommendation for next iteration
+- Whether re-review is needed after fixes
+-->

package/project-template/templates/style-exploration.template.md

@@ -0,0 +1,93 @@
+# Style Exploration
+
+> Designer Phase 1 output (`designer-handoff-v2`). Gate #2 = narrative + style lock via **Master Composite (MC)** + **ASR** after option selection.
+
+## Style Direction Summary
+
+- **Art style**: {{art_style_from_brief}}
+- **Color mood**: {{color_mood}}
+- **Element theme**: {{element_theme}}
+- **References**: {{reference_games_or_styles}}
+- **Emotional Arc**: {{emotional_arc_from_brief}}
+
+## Options
+
+### Option {{A/B/C}}: {{option_name}}
+
+**Keywords**: {{3-5 keywords}}
+**Color temperature**: {{warm/cold/neutral}}
+**Art approach**: {{1-2 sentences}}
+**Alignment with design-brief**: {{brief alignment}}
+
+#### Master Composite (Gate #2a)
+
+| File                                                         | Description                                                 |
+| ------------------------------------------------------------ | ----------------------------------------------------------- |
+| `assets/images/storyboard/master_composite_option_{{a}}.png` | 5×9:16 panels: concept + Hook + Onboarding + End Card + CTA |
+
+**MC prompt** (summary or path to sidecar `.json`):
+
+```
+{{master_composite_prompt_summary}}
+```
+
+#### Panels (embedded in MC — not separate files)
+
+| Panel # | Label              | Time    | Visual intent                             |
+| ------- | ------------------ | ------- | ----------------------------------------- |
+| 1       | Main Gameplay      | —       | Full UI + all element types + static text |
+| 2       | Key Hook           | 0-3s    | {{hook intent}}                           |
+| 3       | Onboarding HUD     | 3-10s   | {{tutorial intent}}                       |
+| 4       | End Card           | 25-30s  | {{end card intent}}                       |
+| 5       | CTA Always Visible | in-game | {{persistent CTA}}                        |
+
+#### Experience Flow Design
+
+**Emotional Arc Visualization**:
+
+- Hook → {{visual signals}}
+- Tutorial → {{visual signals}}
+- Gameplay Peak → {{near-win signals}}
+- End Card → {{resolution signals}}
+
+**Near-Win Visual Composition**: {{description}}
+
+**Attention Guidance per Stage**: Hook / Tutorial / Gameplay / End Card — {{paths}}
+
+**Audio-Emotion Rhythm** (for Phase 2 BGM/SFX): {{per-stage audio notes}}
+
+---
+
+<!-- Repeat per option (2–3). Gate #2a: user picks A/B/C. Gate #2b: add ASR + Motion Notes below for selected option only. -->
+
+## Selected option (after Gate #2a)
+
+- **Selected**: {{A/B/C}}
+- **MC path**: `assets/images/storyboard/master_composite_option_{{X}}.png`
+
+### ASR (Gate #2b)
+
+| File                                                    | Role                    |
+| ------------------------------------------------------- | ----------------------- |
+| `assets/images/reference/ui_state_sheet_{{X}}.png`      | UI component states     |
+| `assets/images/reference/element_state_sheet_{{X}}.png` | Gameplay element states |
+
+Detail tables: `logs/designer-log.md` § ASR Coverage Matrix.
+
+### Motion Notes (Gate #2b)
+
+| Transition          | Type                | Duration | Notes |
+| ------------------- | ------------------- | -------- | ----- |
+| Hook → Tutorial     | {{fade/zoom/swipe}} | {{~ms}}  |       |
+| Tutorial → Gameplay |                     |          |       |
+| Gameplay → End Card |                     |          |       |
+
+## Recommendation
+
+{{Which option and why — ties to PM Emotional Arc}}
+
+## User Decision
+
+- **Selected option**: {{A/B/C}}
+- **User feedback**: {{adjustments}}
+- **Confirmed MC**: `assets/images/storyboard/master_composite_option_{{X}}.png`

package/project-template/templates/ta-log.template.md

@@ -0,0 +1,205 @@
+# Technical Artist Log
+
+## Upstream Intake
+
+> **Step 0a — mandatory before Skill Discovery or any generation.** Read each doc; one-line takeaway proves you understood upstream work. PM/Designer keep **四件套** short — detail is in `style-exploration` + this project's `designer-log`.
+
+| Doc                         | Read ✓ | One-line takeaway (what matters for TA this round)      |
+| --------------------------- | ------ | ------------------------------------------------------- |
+| `docs/project-state.md`     | ☐      | {{e.g. Wave 1 done, selectedMcOption=B}}                |
+| `docs/design-brief.md`      | ☐      | {{e.g. Competence arc, match-3, Hook=wrong-move tease}} |
+| `docs/layout-spec.md`       | ☐      | {{e.g. 42 assetMapping rows, 3 atlas groups}}           |
+| `docs/atom-plan.json`       | ☐      | {{e.g. 18 TA atoms, C₁ refs designer-sample}}           |
+| `docs/atom-plan.md`         | ☐      | TA Skill Context                                        |
+| `docs/style-exploration.md` | ☐      | {{e.g. MC path + storyboard EndCard tone}}              |
+| `logs/designer-log.md`      | ☐      | {{e.g. Palette Locked delta, Style Intent Notes}}       |
+
+```bash
+# Optional paste: ls assets/images/reference/ + key contract dirs after read
+{{intake_ls_snippet}}
+```
+
+---
+
+## Delivery Summary
+
+- **Assigned atoms**: {{total_assigned}}
+- **Completed**: {{total_completed}}
+- **Skipped**: {{total_skipped}}
+- **Blocked**: {{total_blocked}}
+- **Designer samples received**: {{designer_sample_count}} files
+- **TA-completed elements**: {{ta_completed_count}} files
+
+## Style Interpretation
+
+> **Step 0c — Mandatory before any completion work.**
+> Read `logs/designer-log.md` Style Intent Notes, write your interpretation here.
+
+| #     | Designer Intent (Quote from designer-log.md) | My Interpretation     | Confidence      | Action            |
+| ----- | -------------------------------------------- | --------------------- | --------------- | ----------------- |
+| {{n}} | "{{designer_quote}}"                         | {{my_interpretation}} | high/medium/low | proceed / clarify |
+
+<!--
+Confidence rules:
+  high    → proceed with completion
+  medium  → proceed, but include style interpretation in --reference-image prompt
+  low     → MUST write question to docs/intent-clarifications.md before proceeding
+
+Do NOT proceed with any asset type where confidence = low.
+-->
+
+## Style Reference
+
+- **Master reference (MC)**: `assets/images/storyboard/master_composite_option_{{selectedMcOption}}.png`
+- **ASR references**: `ui_state_sheet_{{selectedMcOption}}.png`, `element_state_sheet_{{selectedMcOption}}.png`
+- **Designer samples used as reference**: {{designer_sample_paths}}
+- **Reference model used**: `{{model_name}}` (must be `google/` native for style-consistent completions)
+
+---
+
+## Asset Completion Log
+
+> Records all elements derived from Designer samples.
+
+### {{atom_id}} — {{slot_name}}
+
+- **Status**: {{status}}
+- **Completion type**: {{derived_from_sample | sprite_sheet | 3d_render | animation | vfx}}
+- **Source samples**: {{designer_sample_paths}}
+- **Elements completed**:
+  | File | Dimensions | Size | Notes |
+  |------|-----------|------|-------|
+  | {{path}} | {{WxH}} | {{size}} | {{notes}} |
+- **Pipeline**:
+  ```
+  {{step 1: e.g., generate-image --reference-image ...}}
+  {{step 2: e.g., image remove-background ...}}
+  {{step 3: e.g., image resize ...}}
+  ```
+- **Model used**: {{model_name}}
+- **Reference images**: {{reference_image_paths}}
+
+<!-- Repeat for each completion atom -->
+
+---
+
+## Technical Pipeline Log
+
+> Records all technical production work (sprite sheets, 3D, animation, VFX, post-processing).
+
+### {{atom_id}} — {{slot_name}}
+
+- **Status**: {{status}}
+- **Pipeline type**: {{sprite_sheet | 3d_model | animation_frames | vfx | image_processing | audio_processing}}
+- **Input**: {{input_files}}
+- **Output**: {{output_files}}
+- **Commands executed**:
+  ```bash
+  {{command 1}}
+  {{command 2}}
+  ```
+- **Result**:
+  | File | Format | Dimensions | Size | Frame Count |
+  |------|--------|-----------|------|-------------|
+  | {{path}} | {{format}} | {{WxH}} | {{size}} | {{N or —}} |
+
+<!--
+For sprite_sheet / animation_frames / vfx pipeline types, fill the Sprite Grid Params section below.
+JSON is only auto-generated by `sprite-sheet` command. `animate` and `use-vfx` produce PNG only.
+-->
+
+- **Sprite Grid Params** _(animation_frames / vfx 必填；sprite_sheet 填"见 JSON")_:
+  - columns: {{N or "见 JSON"}}
+  - frameWidth: {{W}}px _(or "见 JSON")_
+  - frameHeight: {{H}}px _(or "见 JSON")_
+  - frameCount: {{N or "见 JSON"}}
+  - padding: {{0 or N}}px
+  - JSON available: {{yes — `<path>.json` (sprite-sheet) / no — params above are source of truth (animate/use-vfx)}}
+  - Dimensions verified: {{width = cols×frameW ✅ / ❌ mismatch}} | {{channels = 4 ✅ / ❌ no alpha}}
+
+<!-- Repeat for each pipeline atom -->
+
+---
+
+## Micro-Batch Validation
+
+> **Per asset type — first 2 completions must pass validation before continuing batch production.**
+> Compare each completion side-by-side with the Designer sample.
+
+### {{asset_type}} (e.g., tiles / ui / bg / vfx)
+
+| Batch | Files         | Consistency Score (1-5) | Deviation Items    | Adjustments Made |
+| ----- | ------------- | ----------------------- | ------------------ | ---------------- |
+| {{n}} | {{file_list}} | {{score}}               | {{deviation_list}} | {{adjustments}}  |
+
+<!--
+Consistency Score criteria:
+  5 — Perfect match: could be mistaken for original designer sample
+  4 — Good match: minor differences only visible on close inspection
+  3 — Acceptable match: style is recognizable but some attributes drift
+  2 — Poor match: obvious style deviation, needs significant adjustment
+  1 — Mismatch: completely different style, STOP and ask Designer
+
+Score < 3 → STOP this asset type, write question to docs/intent-clarifications.md
+-->
+
+---
+
+## Compliance Gate Results
+
+> Completed after Designer Ph.2 is confirmed done. Verify all assetMapping entries.
+
+### Asset Coverage Check
+
+| assetMapping Entry | Expected Path        | File Exists? | Dimensions | Size     | Status        |
+| ------------------ | -------------------- | ------------ | ---------- | -------- | ------------- |
+| {{elementId}}      | {{visualAsset_path}} | {{Yes/No}}   | {{WxH}}    | {{size}} | {{PASS/FAIL}} |
+
+<!--
+Fill one row per entry in layout-spec.md assetMapping.
+Every row must be PASS before advancing to integration.
+-->
+
+### Spec Compliance Summary
+
+| Check                    | Target                     | Actual     | Result        |
+| ------------------------ | -------------------------- | ---------- | ------------- |
+| Background dimensions    | {{assetSpec}}              | {{actual}} | {{PASS/FAIL}} |
+| Tile dimensions          | {{assetSpec}}              | {{actual}} | {{PASS/FAIL}} |
+| UI element dimensions    | {{assetSpec}}              | {{actual}} | {{PASS/FAIL}} |
+| Background file size     | < 500KB                    | {{actual}} | {{PASS/FAIL}} |
+| Tile file size           | < 100KB per tile           | {{actual}} | {{PASS/FAIL}} |
+| BGM file size            | < 300KB                    | {{actual}} | {{PASS/FAIL}} |
+| SFX file size            | < 50KB per SFX             | {{actual}} | {{PASS/FAIL}} |
+| Total assets size        | ≤ 2-3MB                    | {{actual}} | {{PASS/FAIL}} |
+| Sprite sheet JSON paired | Every .png sheet has .json | {{yes/no}} | {{PASS/FAIL}} |
+
+### Compliance Verdict
+
+- **Overall**: {{PASS / FAIL}}
+- **Blockers** (if any): {{list of FAIL items that block integration}}
+- **Ready for Developer Phase 2**: {{Yes / No — pending fixes}}
+
+---
+
+## Handoff to Developer
+
+Summary of what TA delivers to Developer:
+
+| Asset Type          | Count | Paths                  | Notes                 |
+| ------------------- | ----- | ---------------------- | --------------------- |
+| Background images   | {{N}} | `assets/images/bg/`    | {{notes}}             |
+| Tile/element images | {{N}} | `assets/images/tiles/` | {{notes}}             |
+| UI elements         | {{N}} | `assets/images/ui/`    | {{notes}}             |
+| Sprite sheet atlas  | {{N}} | `assets/images/*/`     | Each has paired .json |
+| Animation frames    | {{N}} | `assets/images/*/`     | {{notes}}             |
+| VFX sprite sheets   | {{N}} | `assets/images/vfx/`   | {{notes}}             |
+| 3D GLB models       | {{N}} | `assets/models/`       | {{notes}}             |
+| BGM audio           | {{N}} | `assets/audio/bgm/`    | {{notes}}             |
+| SFX audio           | {{N}} | `assets/audio/sfx/`    | {{notes}}             |
+
+**All files path-match `layout-spec.md` assetMapping**: {{Yes / No}}
+
+<!--
+If No, list discrepancies here so Developer knows to use alternate paths.
+-->