@playcraft/cli 0.0.42 → 0.0.44

package/project-template/.claude/agents/refs/designer-handoff-v2-checklist.md

@@ -8,17 +8,24 @@
 - [ ] `selectedMcOption` set (Gate #2a passed)
 - [ ] MC path: `assets/images/storyboard/master_composite_option_[X].png`
 - [ ] ASR paths exist and pass zero-overlap visual check
+- [ ] ASR cells: isolated elements, no white box / scene inside cells (whole sheet opaque is OK)
+- [ ] § **Image Production Preflight** filled (Phase 1 — three Skills read)
 
-## 1. ASR Coverage Matrix (100%)
+## 1. ASR Coverage Matrix (100% rows)
 
 In `logs/designer-log.md` § ASR Coverage Matrix:
 
-1. List every `elementId` from `layout-spec.md` § Asset Mapping (and atlas `frameId` groups count as one row per logical element).
+1. List every `elementId` from `layout-spec.md` § Asset Mapping (atlas `frameId` groups = one row per logical element).
 2. List every static text `id` from § Text Assets → Static Text.
-3. For each row: `ASR sheet` = `ui` | `element` | `MC-crop` | `ICP-pending`.
-4. `TA extends?` = `no` only when ASR shows final representative state; else `yes`.
+3. **Row count** must equal assetMapping + static text id count (verify before STOP).
+4. For each row, set **CoverageLayer** = `on-asr` | `mc-crop` | `ta-extends`.
+5. For each row: `ASR sheet` = `ui` | `element` | `element_2` | `MC-crop` | `ICP-pending`.
+6. `TA extends?` = `no` only when on-asr shows final representative state; else `yes`.
+7. **Sheet grid metadata** table filled with real numbers (not `{{placeholder}}`).
 
-**Stop rule**: any row missing → do not set `#2b` pending.
+**Type representative rule**: each distinct **elementType** (Matrix column or `layout-spec` § Element Type Registry) must have at least one row with CoverageLayer `on-asr` or `mc-crop`.
+
+**Stop rule**: any contract row missing → do not set `#2b` pending.
 
 ## 2. Palette Locked
 
@@ -50,9 +57,9 @@ In `docs/style-exploration.md` under confirmed option:
 ```
 For each atom-plan row where assignTo = Designer:
 ├─ VisualAtom + covered in Coverage Matrix?
-│   └─ yes → status=done, actualOutput=ASR:...
+│   └─ yes → status=done, actualOutput=ASR:... (on-asr rows → asrSlot in atom-plan.json)
 ├─ AudioAtom?
-│   └─ deliver MP3 at path → done
+│   └─ deliver MP3 at path → done (Phase 2 only)
 ├─ Gap / TA extract failed (ICP)?
 │   └─ generate one PNG → done with path, or blocked until answered
 └─ Never: done with only "will extract later"
@@ -60,9 +67,10 @@ For each atom-plan row where assignTo = Designer:
 
 ## 5. Files to verify before STOP
 
-| File                                                  | Contains                                                    |
-| ----------------------------------------------------- | ----------------------------------------------------------- |
-| `docs/style-exploration.md`                           | MC paths, Motion Notes, Experience Flow                     |
-| `logs/designer-log.md`                                | Coverage Matrix, Palette Locked, Style Intent, Anti-Pattern |
-| `assets/images/reference/ui_state_sheet_[X].png`      | exists                                                      |
-| `assets/images/reference/element_state_sheet_[X].png` | exists                                                      |
+| File                                                    | Contains                                                                  |
+| ------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `docs/style-exploration.md`                             | MC paths, Motion Notes, Experience Flow                                   |
+| `logs/designer-log.md`                                  | Image Production Preflight, Coverage Matrix, Palette Locked, Style Intent |
+| `assets/images/reference/ui_state_sheet_[X].png`        | exists                                                                    |
+| `assets/images/reference/element_state_sheet_[X].png`   | exists                                                                    |
+| `assets/images/reference/element_state_sheet_[X]_2.png` | if types > 12 / overflow                                                  |

package/project-template/.claude/agents/refs/designer-style-exploration-flow.md

@@ -1,15 +1,26 @@
 # Designer — Style exploration flow (Phase 1, steps 2–5)
 
-> **Scope**: After **Step 1 — Skill Discovery** in `agents/designer.md`, follow this document for MC generation through Gate #2b STOP. **Exit criteria** for Phase 1: see `agents/designer.md` Goals § Success criteria.
+> **Scope**: After **Step 1 — Skill Discovery** in `agents/designer.md`, follow this document for **image production** (MC + ASR) through Gate #2b STOP. **Exit criteria**: see `agents/designer.md` Goals § Success criteria.
 >
 > **Deliverable shapes & tables**: `refs/designer-deliverable-spec.md`.
 
 **Trigger**: `project-state.md` stage = `style_exploration`
 
+## Step 1.5 — Image Production Preflight (before MC option B+ or before ASR)
+
+Fill `logs/designer-log.md` § **Image Production Preflight**:
+
+1. Read `playcraft-storyboard`, `playcraft-asset-state-sheet`, `playcraft-image-generation` (§3 + §3.1)
+2. Mark each Skill row ✓ with one-line decision summary
+3. Read `layout-spec.md` — count assetMapping rows + note Element Type Registry (if present)
+
+**Do not generate ASR until this section is complete.**
+
 ## Step 2 — Generate Master Composite only (one image per option A/B[/C])
 
 - Follow `playcraft-storyboard` skill：**每格完整 9:16 H5**；`45:16` + `--width 3600 --height 1280`（2K）或 `4096×1455`（4K）；**禁止 `1:1` / `10:3`**
-- 每个方案用不同模型（见 `refs/designer-master-composite-recipes.md`）
+- **Panel 1 must show every element type** from `layout-spec` (or Element Type Registry)
+- 每个方案用不同 prompt/美术方向（模型均用白名单，见 `refs/designer-master-composite-recipes.md`）
 - 生成后立即 `playcraft image info`：总比例 **width/height ≈ 2.81**，**(width÷5)/height ≈ 0.5625**；不合格则重生成
 - **Review the auto-generated `.json` sidecar** — 确认 `aspectRatio` / `imageSize` / 实际像素正确
 
@@ -22,16 +33,35 @@
 ## Step 4 — Generate ASR sheets（仅针对 `project-state.selectedMcOption`）
 
 - Read `selectedMcOption` from `docs/project-state.md` — if missing, **STOP**
-- Follow `playcraft-asset-state-sheet` skill
-- 输出两张 4K 板：`ui_state_sheet_[X].png` + `element_state_sheet_[X].png`（见 `designer-deliverable-spec.md` §2）
-- `--reference-image` = `master_composite_option_[selectedMcOption].png`
-- 生成后 `playcraft image info` 检查；若槽位重叠，必须重生成
+- **Re-read** `playcraft-asset-state-sheet` + `playcraft-image-generation` §3.1 (cell chroma / isolated)
+- 输出：`ui_state_sheet_[X].png` + `element_state_sheet_[X].png`（类型 >12 时可加 `element_state_sheet_[X]_2.png`）
+- `--reference-image` = `master_composite_option_[selectedMcOption].png`；`--image-model` 与 MC 一致
+- Prompt：sheet `#808080` 或统一色幕；每格 **one isolated element**；金/橙格用蓝幕
+- 生成后 `playcraft image info`；目视：零重叠、格内无白盒/场景底
+- **Do not** `remove-background` on ASR — TA handles post-crop
 
 ## Step 5 — Gate #2b Handoff Pack
 
 > **Checklist**: `refs/designer-handoff-v2-checklist.md`
 
 1. 补全 `docs/style-exploration.md`（ASR 路径、**Motion Notes**、Experience Flow）
-2. 更新 `logs/designer-log.md`：**ASR Coverage Matrix**（100% contract rows）、**Palette Locked**、Style Intent / Anti-Pattern
-3. 更新 handoff + `gates.#2b = pending`
-4. **STOP** — 禁止 Phase 2 音频与批量视觉样本 PNG
+2. 更新 `logs/designer-log.md`：
+   - **ASR Coverage Matrix** — 100% contract rows + **CoverageLayer** column
+   - 每种 **elementType** ≥1 行 `on-asr` 或 `mc-crop`
+   - **Palette Locked**、Style Intent / Anti-Pattern
+   - Mirror `on-asr` rows → `atom-plan.json` → `atoms[].asrSlot`
+3. **Self-check before STOP**:
+
+```bash
+# MC ratio
+playcraft image info --input assets/images/storyboard/master_composite_option_[X].png
+
+# Count contract rows (adjust grep to your layout-spec format)
+grep -c 'elementId\|"id":' docs/layout-spec.md   # approximate — Matrix row count must match
+
+# ASR files exist
+ls assets/images/reference/ui_state_sheet_[X].png assets/images/reference/element_state_sheet_[X].png
+```
+
+4. 更新 handoff + `gates.#2b = pending`
+5. **STOP** — 禁止 Phase 2 音频与批量视觉样本 PNG

package/project-template/.claude/agents/refs/developer-dev-handoff.md

@@ -96,7 +96,7 @@ Set `project-state.md`:
 2. `npm run dev`
 3. Re-run UI + gameplay + runtime checklists for affected areas
 4. Close blocker rows (`status: resolved`) or escalate if still wrong
-5. Only then set `devStatus: ready` and stage → `review`
+5. Only then set `devStatus: ui_ready` (after `ui_pass`) or `devStatus: ready` (after `gameplay_pass`) and handoff `next_orchestrator_action: "Invoke @reviewer ui_diff"` (or `load_check`)
 
 ## Dev ready checklist (`devStatus: ready` — all required)
 

package/project-template/.claude/agents/refs/pm-workflow-detail.md

@@ -141,7 +141,7 @@ Design the shared contract between Designer, TA, and Developer:
 3. **Asset specifications** — size, format, naming for each type
 4. **Asset mapping** — element ID → file path (the integration bridge)
 
-**Critical**: `assetMapping` paths are **locked after Gate #1**. No agent may unilaterally change paths — this is the Asset Contract: TA fills paths in production Wave 2; Developer binds **real files** in `integration` after TA Compliance green.
+**Critical**: `assetMapping` paths are **locked after Gate #1**. No agent may unilaterally change paths — this is the Asset Contract: TA fills paths in production Wave 2; Developer binds **real files** in `ui_pass` after TA Compliance green.
 
 **Transparency**: TA auto-derives transparency requirements from `assetMapping` path conventions (`bg/` = opaque, `ui/`/`vfx/`/`txt/` = needs alpha, `tiles/` = needs alpha unless card faces). PM does NOT need to define transparency fields — chroma key selection and background removal are TA's technical domain. See `ta-pipeline-cookbook.md` Step 0e.
 
@@ -163,6 +163,22 @@ Single-element groups stay as single-file paths; do not invent atlases for one t
 
 ---
 
+## Element Type Registry + ASR budget (Gate #1)
+
+After atlas groups, add **§ Element Type Registry** in `layout-spec.md`:
+
+- Group variant elementIds under a shared `typeId` (e.g. `tile` → red/blue/green ids)
+- Count **unique types** — target **≤ 20** for playable ads
+- ASR physical slot budget: ~12 ui + ~12 element states; overflow → second element sheet or mc-crop/ta-extends plan
+- If user request implies >20 types, PM degrades or splits variants to TA-extends in Gate #1 options
+
+Pre-Write checklist addition:
+
+- [ ] Element Type Registry present; unique type count documented
+- [ ] Variant-only ids marked for TA-extends in Designer handoff notes (optional one line in atom-plan.md)
+
+---
+
 ## Step 7: Experience Flow Design
 
 Design each stage with four fields — from "what happens" to "what the player feels" (MDA player perspective):
@@ -244,7 +260,7 @@ playcraft skills link --from-atom-plan --prune
 - `validate-atom-plan`：PM 定稿前手动跑；**PM STOP** 时 hook 再拦一层（invalid skillRef 无法 STOP）。
 - `link`：读取 `atom-plan.json` 中所有非空 `skillRef`。
 
-**PM does not** pre-fill `atom-plan.md` § Impl Skill Context — **Developer** in `integration`.
+**PM does not** pre-fill `atom-plan.md` § Impl Skill Context — **Developer** in `ui_pass` / `gameplay_pass`.
 
 ### 8e. `atom-plan.md`（可选）
 

package/project-template/.claude/agents/refs/reviewer-convergence-eval.md

@@ -21,16 +21,28 @@ Soft checklist only — **do not judge subjective design quality**.
 
 **Fail →** list missing items + `routeTo: pm` (or `designer` if visual doc gap).
 
-### Gate #2b additional checklist
+### Gate #2b additional checklist (structural — hard fail)
+
+Gate #2b **structural** gaps are hard fails (missing files, row count, type representatives). Do not fail for subjective aesthetics.
 
 ```
 [ ] MC five panels complete (concept + 4 storyboard)
-[ ] MC aspect ratio correct — verify with: playcraft image info <mc-path>
-[ ] ASR dual sheets (UI + element) exist under assets/images/reference/
-[ ] ASR covers main assetMapping element ids
+[ ] MC aspect ratio correct — playcraft image info <mc-path> (width/height ≈ 2.81)
+[ ] MC Panel 1 shows every element type from layout-spec § Element Type Registry (or assetMapping)
+[ ] ASR dual sheets exist: ui_state_sheet_[X].png + element_state_sheet_[X].png
+[ ] Optional overflow: element_state_sheet_[X]_2.png when types > 12
+[ ] logs/designer-log.md § Image Production Preflight complete (3 image Skills)
+[ ] ASR Coverage Matrix row count == assetMapping rows + static text ids
+[ ] CoverageLayer column present; each elementType has ≥1 on-asr OR mc-crop row
+[ ] Sheet grid metadata filled (no {{placeholders}})
+[ ] on-asr rows mirrored to atom-plan.json asrSlot where applicable
+[ ] ASR semantic split: UI board has no gameplay tiles; element board has no full HUD screenshot
+[ ] Spot-check: ASR cells look isolated (no white box / scene floor inside cells) — note in report if obvious
 ```
 
-**Pass →** handoff `Run Gate #1` or `Run Gate #2b`. **Fail →** routeTo PM/Designer with specific gaps.
+Optional CLI: `playcraft skills validate-asr-coverage --project-dir .`
+
+**Pass →** handoff `Run Gate #2b`. **Fail →** routeTo Designer (or PM if layout-spec/type budget issue).
 
 ---
 

package/project-template/.claude/agents/refs/ta-pipeline-cookbook.md

@@ -742,21 +742,55 @@ Designer's **ASR sheets** (UI + element state reference) contain **representativ
 
 1. From **ASR** (preferred): `crop` each state slot → `resize` to spec → these become your `--reference-image` for Stage A batch generation
 2. From **Master Composite** (fallback): extract elements not covered in ASR
-3. Check `designer-log.md` **ASR State Inventory** — note which states are covered vs which need expansion
+3. Check `designer-log.md` § **ASR Coverage Matrix** — note which states are covered vs which need expansion; Sheet grid metadata table at the top has `rows × cols + cell W×H + padding` for pixel-coordinate computation
 4. Background: generate clean bg using composite as `--reference-image`
 5. Text assets: → **invoke `playcraft-text-rendering` skill**
 6. Representative quality insufficient → ICP request to Designer for supplementary samples
 
+**若 ASR crop 后不可抠**（白边/色幕残留/元素截断/格内场景底）→ **`routeTo: designer`** 重生成 ASR 对应格；**不要** TA 自行用 AI 重画整张 ASR。
+
 **ASR 提取方法（按优先级）**：
 
 > ⚠️ **严禁对 ASR 网格布局图使用纯 text prompt 的 segment！** 使用 `designer-log` 中的槽位坐标 + `crop`。
 
+**优先路径：直接读 `atom-plan.json` → `atoms[].asrSlot`（最高优先级）**
+
+Designer 在 Phase 1 完成 ASR 后会把每个 VisualAtom 的网格坐标写到 `atom-plan.json` → `atoms[i].asrSlot: { sheet, row, col }`（详见 [`docs/team/atom-plan-format.md` § `asrSlot`](../../../docs/team/atom-plan-format.md#asrslot-字段可选--visualatom-基线绑定)）。TA 直接用这个字段 + `designer-log` § Sheet grid metadata，省去手翻 Coverage Matrix 的步骤：
+
+```bash
+# 1) 从 atom-plan.json 读取所有有 asrSlot 的 VisualAtom
+cat docs/atom-plan.json | jq -r '
+  .atoms[]
+  | select(.asrSlot != null)
+  | "\(.atomId)\t\(.asrSlot.sheet)\t\(.asrSlot.row)\t\(.asrSlot.col)"
+'
+# 输出格式: <atomId>\t<sheet>\t<row>\t<col>
+
+# 2) 从 designer-log.md § ASR Coverage Matrix § Sheet grid metadata 读 cellW / cellH / padding
+#    (单独读一次，缓存到 ta-log 备查)
+
+# 3) 计算像素坐标并 crop（脚本化 — ta-workspace/scripts/asr-extract.mjs）
+#    x = (col - 1) * (cellW + padding) + padding
+#    y = (row - 1) * (cellH + padding) + padding
+#    sheetPath 映射:
+#      ui       → assets/images/reference/ui_state_sheet_<selectedMcOption>.png
+#      element  → assets/images/reference/element_state_sheet_<selectedMcOption>.png
+#      element_2 → assets/images/reference/element_state_sheet_<selectedMcOption>_2.png
+#    contractPath 从 layout-spec assetMapping 中按 atom slot 反查
+#
+#    playcraft image crop --input <sheetPath> --x <x> --y <y> --width <cellW> --height <cellH> --output <contractPath>
+```
+
 ```
-ASR 是已知网格布局？（ui_state_sheet / element_state_sheet，行列分明）
-├─ 是 → 方法 1: crop 直切（最可靠，零歧义）
+ASR 是已知网格布局？（ui_state_sheet / element_state_sheet / element_state_sheet_*_2，行列分明）
+├─ atom-plan.json 有 asrSlot 字段 → 方法 0（推荐）: 上面脚本化批量 crop
+│
+├─ 是但 asrSlot 缺失 → 方法 1: crop 直切（手动查 Coverage Matrix R#C#）
 │        1. playcraft image info --input assets/images/reference/ui_state_sheet_<X>.png  → 获取尺寸
-│        2. 从 designer-log ASR State Inventory 读取行列与 bbox
-│        3. playcraft image crop --input <asr_sheet> --x <x> --y <y> --width <w> --height <h> --output <out>
+│        2. 从 designer-log § ASR Coverage Matrix 读取 Sheet grid 元数据 + 目标行列 (R#C#)
+│           pixel coords:  x = (C-1) × (cellW + padding) + padding
+│                          y = (R-1) × (cellH + padding) + padding
+│        3. playcraft image crop --input <asr_sheet> --x <x> --y <y> --width <cellW> --height <cellH> --output <out>
 │        4. 对有背景底色的元素：crop 后再 remove-background --method floodfill
 │
 ├─ 元素位置不规则但 bbox 已知 → 方法 2: segment --boxes（精确框选）
@@ -765,6 +799,8 @@ ASR 是已知网格布局？（ui_state_sheet / element_state_sheet，行列分
 └─ 仅 MC 有该类型 → 方法 3: decompose-layers 或 segment --text（最后手段，见 playcraft-masking）
 ```
 
+> **若 Designer 没有填 `asrSlot`** — 不需要重新 invoke Designer，TA 可以手动从 `designer-log § ASR Coverage Matrix § Coverage` 反查 R#C# 并继续。在 ICP 中提示 PM/Designer 下次预填可加速。
+
 **常见踩坑**：
 
 - ❌ `segment --text "apple tile icon"` → SAM3 可能只切出苹果图案，丢失 tile 方块底板
@@ -858,7 +894,7 @@ assetMapping 路径所在目录？
 | ----------------------------- | ---------- | ------------- | ------------------------------------- | ------------------------------------------- | -------------------- | -------- |
 | assets/images/bg/bg_main.webp | false      | full-coverage | N/A                                   | N/A                                         | 边缘全覆盖检查       | ❓       |
 | assets/images/ui/btn_cta.webp | true       | greenscreen   | `remove-background --floodfill -t 25` | `segment --boxes` / `remove-bg --method ai` | 深色背景 overlay     | ❓       |
-| assets/images/ui/digits.webp  | true       | bluescreen    | `remove-background --floodfill -t 25` | `segment --boxes` / `remove-bg --method ai` | 深色背景 overlay     | ❓       |
+| assets/images/txt/digits.webp | true       | bluescreen    | `remove-background --floodfill -t 25` | `segment --boxes` / `remove-bg --method ai` | 深色背景 overlay     | ❓       |
 | assets/images/vfx/glow.webp   | true       | bluescreen    | `remove-background --floodfill -t 25` | `segment --boxes`                           | 逐帧深色背景 overlay | ❓       |
 | assets/images/tiles/tile.webp | true       | greenscreen   | `remove-background --floodfill -t 25` | `segment --boxes` / `remove-bg --method ai` | 深色背景 overlay     | ❓       |
 | assets/images/txt/title.webp  | true       | bluescreen    | `remove-background --floodfill -t 25` | `remove-bg --method ai`                     | 深色背景 overlay     | ❓       |

package/project-template/.claude/agents/reviewer.md

@@ -20,6 +20,8 @@ allowedTools:
 ---
 
 > **First Step**: Read `docs/project-state.md` → **`## Agent handoff`** → **## Runtime** → branch; read `refs/` only when Runtime says so. STOP: [STOP sync checklist](../../docs/team/collaboration.md#stop-sync-checklist).
+>
+> **Workflow spec**: `convergence-v1` — three modes: `design_check` (Gate #1/#2b pre-check), `ui_diff` (screenshots vs MC), `load_check` (before Gate #3). Increment `uiReworkRound` on `ui_diff` fail (max 5). See [workflow-changelog.md](../../docs/team/workflow-changelog.md).
 
 # Reviewer — Playable Ads Convergence Review Agent
 
@@ -120,8 +122,9 @@ Afterward update handoff per **Runtime**. **Never** write mainline `stage`.
 ## Important Rules
 
 1. **Never modify production files** — only `logs/review-report.md` and `docs/project-state.md` checkpoint.
-2. **`design_check` is soft** — block missing docs / wrong MC ratio / empty assetMapping; do not fail for aesthetics.
-3. **`ui_diff` uses playwright-cli** — save screenshots under `logs/`; each diff needs severity + `routeTo: developer | ta | designer`.
-4. **`load_check` is not gameplay QA** — only load + console errors; gameplay = user at Gate #3.
-5. **`uiReworkRound` max 5** — increment on `ui_diff` fail; minor issues log only, do not block pass.
-6. **Orchestrator owns stage** — you set handoff `next_orchestrator_action` only.
+2. **`design_check` is soft for Gate #1** — block missing docs / wrong MC ratio / empty assetMapping; do not fail for aesthetics.
+3. **`design_check` Gate #2b structural items are hard fails** — missing ASR files, Coverage Matrix row count mismatch, missing type representative (on-asr/mc-crop), empty Sheet grid metadata.
+4. **`ui_diff` uses playwright-cli** — save screenshots under `logs/`; each diff needs severity + `routeTo: developer | ta | designer`.
+5. **`load_check` is not gameplay QA** — only load + console errors; gameplay = user at Gate #3.
+6. **`uiReworkRound` max 5** — increment on `ui_diff` fail; minor issues log only, do not block pass.
+7. **Orchestrator owns stage** — you set handoff `next_orchestrator_action` only.

package/project-template/.claude/agents/technical-artist.md

@@ -23,6 +23,8 @@ allowedTools:
 ---
 
 > **First Step**: Read `docs/project-state.md` → **`## Agent handoff`** → **## Runtime** → branch; read `refs/` only when Runtime says so. STOP: [STOP sync checklist](../../docs/team/collaboration.md#stop-sync-checklist).
+>
+> **Workflow spec**: `convergence-v1` — stage chain `pm → style_exploration → production → ui_pass → ui_review ⇄ ui_rework → gameplay_pass → done`. TA runs in `production` Wave 2 (after Designer Ph.2). See [workflow-changelog.md](../../docs/team/workflow-changelog.md).
 
 # Technical Artist — Playable Ads Production Agent
 

package/project-template/.claude/hooks/README.md

@@ -16,25 +16,53 @@ On failure: exit `2` — PM must fix atom-plan before STOP.
 
 ## `validate-workflow-stop.mjs`
 
-When a **Technical Artist** or **Developer** subagent stops, checks `logs/ta-log.md` or `logs/developer-log.md`:
+When a **Designer**, **Technical Artist** or **Developer** subagent stops, checks the corresponding `logs/<role>-log.md`. `stage` is read from `docs/project-state.md` (supports YAML form `stage: ui_pass` in `## Agent handoff` block, markdown bold `**ui_pass**`, and backticked `` stage: `ui_pass` `` forms — full `convergence-v1` stage list).
+
+### Designer (`logs/designer-log.md`)
+
+Validated only when `stage = production` (Phase 2). Phase 1 (`style_exploration`) is covered by Gate #2a / #2b instead.
+
+**§ Skill Preflight**
+
+- Section present
+- Each row's Read column has ✓
+- Each row's decision summary ≥ 8 chars, no `{{placeholders}}`
+
+### Technical Artist (`logs/ta-log.md`)
 
 **§ Upstream Intake**
 
 - Every required doc row has Read ✓
 - Every takeaway is filled (no `{{placeholders}}`, min 8 chars)
 
-**§ Production Plan** (TA) or **§ UI Pass Plan** / **§ Gameplay Pass Plan** (Developer — validated by `stage` in project-state)
+**§ Production Plan**
 
-- Required subsections present (TA: Coverage / Atlas / Risk; Developer ui_pass: Scene-Asset / Scene navigation / Risk; gameplay_pass: PGS / Risk)
+- Required subsections present: Coverage Plan / Atlas Assembly Plan / Risk Checklist
 - Risk Checklist fully checked `[x]`
 - No `{{placeholders}}` in plan section
 
-On failure:
+### Developer (`logs/developer-log.md`)
+
+**§ Upstream Intake** — same as TA (also requires `logs/ta-log.md` row).
+
+**§ UI Pass Plan** (when `stage = ui_pass` / `ui_rework`)
+
+- Required subsections: Scene-Asset Binding Plan / Scene navigation / Risk Checklist
+- Risk Checklist fully checked `[x]`
+- No `{{placeholders}}`
+
+**§ Gameplay Pass Plan** (when `stage = gameplay_pass`)
+
+- Required subsections: PGS Strategy / Risk Checklist
+- Risk Checklist fully checked `[x]`
+- No `{{placeholders}}`
+
+### On failure
 
-- **Claude Code**: exit `2` + JSON `{"decision":"block","reason":"..."}` — subagent must fix intake before stopping
+- **Claude Code**: exit `2` + JSON `{"decision":"block","reason":"..."}` — subagent must fix log before stopping
 - **Cursor**: exit `2` — blocks subagent stop; stderr shows the same reason
 
-Role detection: `agent_type` / `PLAYCRAFT_STOP` footer `role:` in the last message. Other agents (PM, Designer, Reviewer) are skipped.
+Role detection: `agent_type` / `subagent_type` / `PLAYCRAFT_STOP` footer `role:` in the last message. PM and Reviewer agents are skipped.
 
 ## Enable