@playcraft/cli 0.0.44 → 0.0.47

package/project-template/.claude/agents/refs/README.md

@@ -4,70 +4,76 @@
 
 ## 分层架构
 
-| 层              | 位置                                    | 加载时机                               | 内容                                                            | 大小目标                    |
-| --------------- | --------------------------------------- | -------------------------------------- | --------------------------------------------------------------- | --------------------------- |
-| **L1 常驻指令** | `.claude/agents/<role>.md`              | sub-agent invoke 时全量加载            | Goals (Top3) / Agent Conduct / Identity / Workflow / Hard Rules | < 280 行（Developer < 220） |
-| **L2 按需细则** | `.claude/agents/refs/<role>-<topic>.md` | sub-agent 在指定 Phase/任务前主动 read | 详细流程 / 命令示例 / 决策树                                    | 不限                        |
-| **L3 平台工具** | `.claude/skills/<tool>/SKILL.md`        | sub-agent 使用工具时按 trigger 加载    | 工具用法 / 脚本模板                                             | 不限                        |
+| 层              | 位置                                    | 加载时机                            | 内容                                                                     | 大小目标                    |
+| --------------- | --------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------ | --------------------------- |
+| **L1 常驻指令** | `.claude/agents/<role>.md`              | sub-agent invoke 时全量加载         | Role identity / ownership / boundaries / workflow interface / hard rules | < 280 行（Developer < 220） |
+| **L2 按需细则** | `.claude/agents/refs/<role>-<topic>.md` | sub-agent 在当前任务需要时按需 read | 详细流程 / 命令示例 / 决策树                                             | 不限                        |
+| **L3 平台工具** | `.claude/skills/<tool>/SKILL.md`        | sub-agent 使用工具时按 trigger 加载 | 工具用法 / 脚本模板                                                      | 不限                        |
 
 ## 渐进披露原则
 
 - **L1（agent .md）必须精简**：每次 sub-agent invoke 都全量加载，token 成本高
-- **L2（refs/）按需读取**：agent .md 或 SKILL.md 在对应阶段显式指引，形如：`> Read refs/ta-pipeline-cookbook.md`
+- **L2（`.claude/agents/refs/`）按需读取**：由 role card 的 workflow interface、orchestrator dispatch、或 SKILL.md 显式指引
 - **L3（SKILL）工具触发**：使用具体工具前读取对应 SKILL
 - **每个 refs 文件必须有至少一处显式引用**：未被引用的文件应删除——LLM 无法自行发现未引用的文档
 
 ## 文件清单
 
-| 文件                                   | 引用来源                                                       | 内容摘要                                                                |
-| -------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------- |
-| `pm-workflow-detail.md`                | `agents/pm.md`                                                 | Step 1-8 详细分析流程 + 调度元信息指南 + 直接意图模式                   |
-| `docs/team/atom-plan-format.md`        | `pm.md`, `atom-plan.template.md`, `playcraft-workflow`         | atom-plan JSON 主 + MD 辅；Gate #1 validate/link 流程                   |
-| `designer-dimension-axis.md`           | `agents/designer.md`                                           | 2D/2.5D/Isometric/3D 维度处理指南                                       |
-| `designer-master-composite-recipes.md` | `skills/playcraft-storyboard`, `agents/designer.md`            | 游戏类型 MC prompt 配方 + 模型多样性策略 + 故障恢复                     |
-| `designer-art-style-catalog.md`        | `skills/playcraft-art-style-guide`                             | 9 种美术风格完整目录（prompt/模型/管线/错误）                           |
-| `designer-color-audio-recipes.md`      | `skills/playcraft-ad-psychology`, `agents/designer.md`         | 按游戏类型配色方案 + 音频情绪弧参数                                     |
-| `designer-deliverable-spec.md`         | `agents/designer.md`                                           | designer-handoff-v2 交付规格、Handoff Pack、Phase 2 规则                |
-| `designer-handoff-v2-checklist.md`     | `designer-style-exploration-flow.md` Step 5                    | Gate #2b：Coverage Matrix、Palette Locked、Motion Notes                 |
-| `skills/playcraft-asset-state-sheet`   | `agents/designer.md`, `designer-deliverable-spec.md`           | ASR 双板规范                                                            |
-| `designer-style-exploration-flow.md`   | `agents/designer.md`                                           | Phase 1 Step 2–5：MC 生成、#2a 包、ASR 双板、#2b 收尾与 STOP            |
-| `developer-impl-cookbook.md`           | `agents/developer.md`, `refs/developer-phase1-flow.md`         | index.html 骨架 + Atlas/WebP+JSON 绑定 + CTA handler                    |
-| `developer-phase1-flow.md`             | `agents/developer.md`                                          | `ui_pass` + `gameplay_pass` + `ui_rework` 全流程                        |
-| `developer-dev-handoff.md`             | `agents/developer.md`, `refs/developer-impl-cookbook.md`       | Dev 迭代节奏 + ui_ready/ready + upstream blockers                       |
-| `reviewer-convergence-eval.md`         | `agents/reviewer.md`                                           | design_check + ui_diff + load_check 流程                                |
-| `reviewer-six-dimension-eval.md`       | _(deprecated)_                                                 | 指向 `reviewer-convergence-eval.md`                                     |
-| `ta-tools-reference.md`                | `agents/technical-artist.md`                                   | 全工具命令表（AI 生成/3D/精灵图/图像/音频）                             |
-| `ta-pipeline-cookbook.md`              | `agents/technical-artist.md`                                   | **Step 0–2** 脚本 + TA Step 0–D pipeline + Compliance 全表 + 引用图规则 |
-| `ta-atlas-deliverable-standard.md`     | `agents/technical-artist.md`, `refs/ta-pipeline-cookbook.md`   | WebP 运行时默认、atlas `.webp`+`.json`、分组与合规、转码示例            |
-| `ta-3d-flip-recipe.md`                 | `agents/technical-artist.md`, `skills/playcraft-vfx-animation` | 素材重刷 + 3D 翻转动画教程                                              |
-| `ta-image-generation-detail.md`        | `skills/playcraft-image-generation`                            | 精灵图直出策略 + Edit 工作流 + 错误恢复 + 批量最佳实践                  |
-| `ta-image-ops-reference.md`            | `skills/playcraft-image-ops`                                   | `playcraft image` 全子命令 CLI 参数速查表                               |
-| `ta-batch-pipeline-recipes.md`         | `skills/playcraft-batch-pipeline`                              | batch/pipeline 实用配方集                                               |
-| `ta-vfx-preset-catalog.md`             | `skills/playcraft-vfx-animation`                               | VFX/animate 预设完整目录 + 游戏类型配方                                 |
+| 文件                                 | 引用来源                                                       | 内容摘要                                                                                 |
+| ------------------------------------ | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `game-designer-workflow-detail.md`   | `agents/game-designer.md` workflow interface                   | Game Designer 在 ring 1 `loop: clarify` 主设计任务下的执行流程                           |
+| `skill-selector-guide.md`            | `docs/team/atom-tree-format.md`                                | temporary ref-flow atom-selection subagent 产出 `atom-tree` 双文件时使用的速查式选择指南 |
+| `docs/team/atom-tree-format.md`      | `atom-tree.template.md`, future atom workflow docs             | atom-tree JSON 主 + markdown skill/reference companion                                   |
+| `implementation-plan-guide.md`       | `templates/plan.template.md`, ref-flow implementation planning | ref-flow subagent 产出 Developer execution plan 时使用的执行计划指南                     |
+| `artist-dimension-axis.md`           | `agents/artist.md`                                             | 2D/2.5D/Isometric/3D 维度处理指南                                                        |
+| `artist-master-composite-recipes.md` | `skills/playcraft-storyboard`, `agents/artist.md`              | 游戏类型 MC prompt 配方 + 模型多样性策略 + 故障恢复                                      |
+| `artist-art-style-catalog.md`        | `skills/playcraft-art-style-guide`                             | 9 种美术风格完整目录（prompt/模型/管线/错误）                                            |
+| `artist-color-audio-recipes.md`      | `skills/playcraft-ad-psychology`, `agents/artist.md`           | 按游戏类型配色方案 + 音频情绪弧参数                                                      |
+| `artist-deliverable-spec.md`         | `agents/artist.md`                                             | artist-handoff-v2 交付规格、Handoff Pack、Phase 2 规则                                   |
+| `artist-handoff-v2-checklist.md`     | `artist-style-exploration-flow.md` Step 5                      | Ring 3 verify：Coverage Matrix、Palette Locked、Motion Notes                             |
+| `skills/playcraft-asset-state-sheet` | `agents/artist.md`, `artist-deliverable-spec.md`               | ASR 双板规范                                                                             |
+| `artist-style-exploration-flow.md`   | `agents/artist.md`                                             | Ring 3 build：MC 引用、ASR 双板、Handoff Pack 与 STOP                                    |
+| `developer-impl-cookbook.md`         | `agents/developer.md`, `refs/developer-phase1-flow.md`         | Developer 实现模式参考：index.html 骨架 + Atlas/WebP+JSON 绑定 + CTA handler             |
+| `developer-phase1-flow.md`           | `agents/developer.md`                                          | Developer 执行流程：`loop: build` + ring 4 ui_diff 修复                                  |
+| `developer-dev-handoff.md`           | `agents/developer.md`, `refs/developer-impl-cookbook.md`       | Developer 验证与交接：dev 迭代节奏 + devStatus + upstream blockers                       |
+| `reviewer-convergence-eval.md`       | `agents/reviewer.md`                                           | design_check + gameplay_conformance + ui_diff + load_check 流程                          |
+| `reviewer-six-dimension-eval.md`     | _(deprecated)_                                                 | 指向 `reviewer-convergence-eval.md`                                                      |
+| `ta-tools-reference.md`              | `agents/technical-artist.md`                                   | 全工具命令表（AI 生成/3D/精灵图/图像/音频）                                              |
+| `ta-pipeline-cookbook.md`            | `agents/technical-artist.md`                                   | **Step 0–2** 脚本 + TA Step 0–D pipeline + Compliance 全表 + 引用图规则                  |
+| `ta-atlas-deliverable-standard.md`   | `agents/technical-artist.md`, `refs/ta-pipeline-cookbook.md`   | WebP 运行时默认、atlas `.webp`+`.json`、分组与合规、转码示例                             |
+| `ta-3d-flip-recipe.md`               | `agents/technical-artist.md`, `skills/playcraft-vfx-animation` | 素材重刷 + 3D 翻转动画教程                                                               |
+| `ta-image-generation-detail.md`      | `skills/playcraft-image-generation`                            | 精灵图直出策略 + Edit 工作流 + 错误恢复 + 批量最佳实践                                   |
+| `ta-image-ops-reference.md`          | `skills/playcraft-image-ops`                                   | `playcraft image` 全子命令 CLI 参数速查表                                                |
+| `ta-batch-pipeline-recipes.md`       | `skills/playcraft-batch-pipeline`                              | batch/pipeline 实用配方集                                                                |
+| `ta-vfx-preset-catalog.md`           | `skills/playcraft-vfx-animation`                               | VFX/animate 预设完整目录 + 游戏类型配方                                                  |
 
-## 按 invoke 场景反查
+## 按 invoke 场景反查（growth-rings-v1）
 
-| Stage / 触发                     | Sub-agent        | 应该读的 refs（按顺序）                                                                                          |
-| -------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------- |
-| `pm` 首次 invoke                 | PM               | `pm-workflow-detail.md` (Steps 1–8)                                                                              |
-| `style_exploration`, Gate #2a 前 | Designer         | `designer-style-exploration-flow.md` (Steps 2–3) + `designer-deliverable-spec.md` § MC                           |
-| `style_exploration`, Gate #2b 前 | Designer         | `designer-style-exploration-flow.md` (4–5) + `designer-handoff-v2-checklist.md` + `designer-deliverable-spec.md` |
-| `production`, Wave 1             | Designer         | `designer-deliverable-spec.md` § Phase 2 + audio skills                                                          |
-| `production`, Wave 2 (TA)        | Technical Artist | `ta-pipeline-cookbook.md` (**Step 0a** intake → Step 0 → 2) → `ta-atlas-deliverable-standard.md`                 |
-| `pm` STOP, Gate #1 pending       | Reviewer         | `reviewer-convergence-eval.md` § design_check Gate #1                                                            |
-| `style_exploration`, Gate #2b 前 | Reviewer         | `reviewer-convergence-eval.md` § design_check Gate #2b                                                           |
-| `ui_pass`, Developer             | Developer        | `developer-phase1-flow.md` Part A → `developer-impl-cookbook.md` → `developer-dev-handoff.md`                    |
-| `ui_review`                      | Reviewer         | `reviewer-convergence-eval.md` § ui_diff + `playwright-cli` skill                                                |
-| `ui_rework`, Developer           | Developer        | `developer-phase1-flow.md` Part B + UI Diff Report                                                               |
-| `gameplay_pass`, Developer       | Developer        | `developer-phase1-flow.md` Part C → `developer-impl-cookbook.md`                                                 |
-| `gameplay_pass`, load_check      | Reviewer         | `reviewer-convergence-eval.md` § load_check + `playwright-cli` skill                                             |
-| `ui_rework`, routeTo TA          | Technical Artist | `ta-pipeline-cookbook.md` (scoped fixes) + `ta-atlas-deliverable-standard.md`                                    |
-| `ui_rework`, routeTo Designer    | Designer         | `designer-deliverable-spec.md` + `designer-handoff-v2-checklist.md` + `designer-color-audio-recipes.md`          |
-| spec-gap (any)                   | PM               | `pm-workflow-detail.md` § Atlas grouping + layout/atom patch                                                     |
+| iteration / loop / 触发              | Sub-agent                   | 应该读的 refs（按顺序）                                                                                    |
+| ------------------------------------ | --------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| ring 1 `loop: clarify`               | Game Designer               | `game-designer-workflow-detail.md`                                                                         |
+| ring 1 `loop: clarify`（atom-tree）  | temporary ref-flow subagent | `skill-selector-guide.md` + `docs/team/atom-tree-format.md`                                                |
+| ring 2+ `loop: clarify`（atom-tree） | ref-flow subagent           | `skill-selector-guide.md` + `docs/team/atom-tree-format.md`                                                |
+| ring 2 `loop: clarify`（plan）       | ref-flow subagent           | `implementation-plan-guide.md` + `templates/plan.template.md`                                              |
+| ring 3 `loop: clarify`（MC）         | storyboard subagent         | `storyboard-generation-guide.md` + `artist-master-composite-recipes.md`                                    |
+| ring 3 `loop: build`（ASR 前）       | Artist                      | `artist-style-exploration-flow.md` (Steps 2–3) + `artist-deliverable-spec.md` § MC                         |
+| ring 3 `loop: build/verify`（ASR）   | Artist                      | `artist-style-exploration-flow.md` (4–5) + `artist-handoff-v2-checklist.md` + `artist-deliverable-spec.md` |
+| ring 4 `loop: build` Wave 1          | Artist                      | `artist-deliverable-spec.md` § Phase 2 + audio skills                                                      |
+| ring 4 `loop: build` Wave 2 (TA)     | Technical Artist            | `ta-pipeline-cookbook.md` (**Step 0a** intake → Step 0 → 2) → `ta-atlas-deliverable-standard.md`           |
+| ring 1 verify `design_check`         | Reviewer                    | `reviewer-convergence-eval.md` § design_check ring 1                                                       |
+| ring 3 verify `design_check`         | Reviewer                    | `reviewer-convergence-eval.md` § design_check ring 3 (ASR)                                                 |
+| ring 1–2 `loop: build`               | Developer                   | `developer-phase1-flow.md` → `developer-impl-cookbook.md` → `developer-dev-handoff.md`                     |
+| ring verify `gameplay_conformance`   | Reviewer                    | `reviewer-convergence-eval.md` § gameplay_conformance + `playwright-cli` skill                             |
+| ring verify `load_check`             | Reviewer                    | `reviewer-convergence-eval.md` § load_check + `playwright-cli` skill                                       |
+| ring 4 verify `ui_diff`              | Reviewer                    | `reviewer-convergence-eval.md` § ui_diff + `playwright-cli` skill                                          |
+| ring 4 verify ui_diff fail → rework  | Developer                   | `developer-phase1-flow.md` § Rework + UI Diff Report                                                       |
+| ring 4 verify routeTo TA             | Technical Artist            | `ta-pipeline-cookbook.md` (scoped fixes) + `ta-atlas-deliverable-standard.md`                              |
+| ring 4 verify routeTo Artist         | Artist                      | `artist-deliverable-spec.md` + `artist-handoff-v2-checklist.md` + `artist-color-audio-recipes.md`          |
+| spec-gap (any)                       | Game Designer               | global collaboration / layout/atom workflow docs                                                           |
 
 ## 维护规则
 
-1. **不要在 refs/ 里写应该放在 agent .md 的内容**：Hard Rules、Identity、File Access 矩阵必须留在 L1
+1. **不要在 refs/ 里写应该放在 agent .md 的内容**：Role ownership、boundaries、success criteria、hard rules 留在 L1；refs 只写执行细节 / 配方 / checklist
 2. **每份 refs/ 文档必须有对应的显式引用入口**：agent .md 或 SKILL.md 里有明确的 "read refs/xxx.md" 指令
 3. **未被引用的 refs 文件必须删除**：LLM 无法自行发现未引用的文档，孤立文件只是噪音
-4. **refs/ 不进入 project-state.md 文件读写矩阵**：这些是只读参考，不是产出文件
+4. **refs/ 不进入状态文件读写矩阵**：这些是只读参考，不是产出文件

package/project-template/.claude/agents/refs/{designer-color-audio-recipes.md → artist-color-audio-recipes.md}

@@ -87,7 +87,7 @@
 | -------- | --------- | -------- | --------- | --------- |
 | BPM 区间 | 90-115    | 100-125  | 120-150   | 130-160   |
 
-**Designer 生成 BGM 时的组合写法**：
+**Artist 生成 BGM 时的组合写法**：
 
 ```bash
 # 示例：休闲消除游戏，Tutorial 阶段风格
@@ -142,7 +142,7 @@ playcraft tools generate-sfx \
 
 ## 音频-视觉对齐检查清单
 
-Designer 完成音频生成后，对照以下清单验证情绪一致性：
+Artist 完成音频生成后，对照以下清单验证情绪一致性：
 
 - [ ] Hook BGM 第一个节拍 <= 0.5s 内出现（不要淡入铺垫）
 - [ ] Tutorial 段 BPM 比 Gameplay 低 15-30（有感知上的降速）

package/project-template/.claude/agents/refs/{designer-deliverable-spec.md → artist-deliverable-spec.md}

@@ -1,6 +1,6 @@
-# Designer — Deliverable spec (designer-handoff-v2)
+# Artist — Deliverable spec (artist-handoff-v2)
 
-> **When to read**: Before generating Master Composite, ASR, audio, or digit strip. Cross-reference `playcraft-storyboard`, `playcraft-asset-state-sheet`, `playcraft-text-rendering`, `playcraft-image-generation`, and `refs/designer-handoff-v2-checklist.md`.
+> **When to read**: Before generating Master Composite, ASR, audio, or digit strip. Cross-reference `playcraft-storyboard`, `playcraft-asset-state-sheet`, `playcraft-text-rendering`, `playcraft-image-generation`, and `.claude/agents/refs/artist-handoff-v2-checklist.md`.
 
 ## Resolution Strategy
 
@@ -12,38 +12,38 @@ All image generation MUST use maximum supported resolution.
 
 All visible text is image assets — **zero font files**. Static text is baked into the MC concept panel; dynamic numbers use a Digit Sprite Strip.
 
-> **Invoke `playcraft-text-rendering`** for static-text extraction (TA default) and digit strip (Designer Phase 2).
+> **Invoke `playcraft-text-rendering`** for static-text extraction (TA default) and digit strip (Artist Phase 2).
 
 ### Static text (default)
 
-| Step                           | Role                                        |
-| ------------------------------ | ------------------------------------------- |
-| Bake into MC                   | Designer (concept panel)                    |
-| Extract to `layout-spec` paths | TA (`crop` / `segment`)                     |
-| Extract fails                  | ICP → Designer **one isolated PNG** per row |
+| Step                           | Role                                      |
+| ------------------------------ | ----------------------------------------- |
+| Bake into MC                   | Artist (concept panel)                    |
+| Extract to `layout-spec` paths | TA (`crop` / `segment`)                   |
+| Extract fails                  | ICP → Artist **one isolated PNG** per row |
 
 ### Background (default)
 
-| Step                                  | Role                                                             |
-| ------------------------------------- | ---------------------------------------------------------------- |
-| Extract from MC concept panel         | TA → `layout-spec` bg path                                       |
-| 2.5D / hero bg needs dedicated sample | PM marks VisualAtom `assignTo: Designer` → ICP isolated PNG only |
+| Step                                  | Role                                                                   |
+| ------------------------------------- | ---------------------------------------------------------------------- |
+| Extract from MC concept panel         | TA → `layout-spec` bg path                                             |
+| 2.5D / hero bg needs dedicated sample | Game Designer routes ICP supplementary art request → isolated PNG only |
 
 ## Phase 1 Deliverables — Image production (MC + ASR)
 
-Gate #2a: **one MC per option** + Experience Flow text. Gate #2b (after `selectedMcOption`): **ASR dual sheets** + **Handoff Pack** (below).
+Ring 3 clarify: **one MC per option** + Experience Flow text. Ring 3 build (after `selectedMcOption`): **ASR dual sheets** + **Handoff Pack** (below).
 
-> **Phase 1 scope = images only.** Audio/digit strip is **Phase 2** after Gate #2b — see § Phase 2 Deliverables.
+> **Phase 1 scope = images only.** Audio/digit strip is **Phase 2** after ring 3 verify — see § Phase 2 Deliverables.
 
-| #   | Deliverable                       | Format | Spec                                                       |
-| --- | --------------------------------- | ------ | ---------------------------------------------------------- |
-| 1   | **Master Composite**              | PNG 4K | 5 panels: concept + 4 storyboard scenes                    |
-| 2a  | **UI State Reference Sheet**      | PNG 4K | UI/HUD per interaction state                               |
-| 2b  | **Element State Reference Sheet** | PNG 4K | Gameplay elements per event/special state                  |
-| 3   | **Experience Flow Design**        | Text   | `style-exploration.md`                                     |
-| 4   | **Gate #2b Handoff Pack**         | Text   | `designer-log.md` + Motion Notes in `style-exploration.md` |
+| #   | Deliverable                       | Format | Spec                                                     |
+| --- | --------------------------------- | ------ | -------------------------------------------------------- |
+| 1   | **Master Composite**              | PNG 4K | 5 panels: concept + 4 storyboard scenes                  |
+| 2a  | **UI State Reference Sheet**      | PNG 4K | UI/HUD per interaction state                             |
+| 2b  | **Element State Reference Sheet** | PNG 4K | Gameplay elements per event/special state                |
+| 3   | **Experience Flow Design**        | Text   | `style-exploration.md`                                   |
+| 4   | **Ring 3 Handoff Pack**           | Text   | `artist-log.md` + Motion Notes in `style-exploration.md` |
 
-> **ASR** = authoring-time reference sprite sheets. **Not** runtime `.webp` + `.json` atlases (TA in `production`).
+> **ASR** = authoring-time reference sprite sheets. **Not** runtime `.webp` + `.json` atlases (TA in ring 4 build).
 
 Every generation outputs a sidecar `.json` (prompt + parameters).
 
@@ -51,7 +51,7 @@ Every generation outputs a sidecar `.json` (prompt + parameters).
 
 ### Deliverable 1: Master Composite
 
-> **Skills**: `playcraft-storyboard` + `refs/designer-master-composite-recipes.md`
+> **Skills**: `playcraft-storyboard` + `.claude/agents/refs/artist-master-composite-recipes.md`
 
 | #   | Panel              | Content                                              |
 | --- | ------------------ | ---------------------------------------------------- |
@@ -63,7 +63,7 @@ Every generation outputs a sidecar `.json` (prompt + parameters).
 
 Paths: `assets/images/storyboard/master_composite_option_[A|B|C].png`
 
-**MC options count**: ≥2 before Gate #2a (see option table in prior spec — 2 or 3 by clarity).
+**MC options count**: ≥2 before ring 3 Ring Gate (see option table in prior spec — 2 or 3 by clarity).
 
 ---
 
@@ -80,7 +80,7 @@ assets/images/reference/element_state_sheet_[X].png
 assets/images/reference/element_state_sheet_[X]_2.png
 ```
 
-**ASR whole PNG is opaque by design** — TA crops cells then `remove-background`. Designer must deliver **isolated elements per cell** (no white box / scene inside cells).
+**ASR whole PNG is opaque by design** — TA crops cells then `remove-background`. Artist must deliver **isolated elements per cell** (no white box / scene inside cells).
 
 #### Three-layer coverage model
 
@@ -99,11 +99,11 @@ Physical slot budget: **8–12 slots per sheet**; overflow → second element sh
 
 ---
 
-### Gate #2b Handoff Pack (mandatory before `#2b` STOP)
+### Ring 3 Handoff Pack (mandatory before ring 3 verify STOP)
 
-> **Checklist**: `refs/designer-handoff-v2-checklist.md`
+> **Checklist**: `.claude/agents/refs/artist-handoff-v2-checklist.md`
 
-#### 1. ASR Coverage Matrix (`logs/designer-log.md`)
+#### 1. ASR Coverage Matrix (`logs/artist-log.md`)
 
 One row per contract item from `layout-spec.md`:
 
@@ -116,16 +116,16 @@ One row per contract item from `layout-spec.md`:
 
 **CoverageLayer rules**:
 
-- **on-asr**: must have valid `Grid` (R#C#) and matching PNG slot; mirror to `atom-plan.json` → `asrSlot`
+- **on-asr**: must have valid `Grid` (R#C#) and matching PNG slot; mirror to `atom-tree.json` → `asrSlot`
 - **mc-crop**: MC Panel 1 shows type; document region in Style Intent Notes
 - **ta-extends**: color variants / full state sets; `TA extends? = yes` + one-line extension hint
 
 **Forbidden**: missing rows; all rows `ta-extends` with no on-asr/mc-crop type representative; overlapping ASR slots.
 
-#### 2. Palette Locked (`logs/designer-log.md`)
+#### 2. Palette Locked (`logs/artist-log.md`)
 
 - 6–10 hex swatches sampled from confirmed MC (background, accent, CTA, key elements).
-- One line: **delta vs `layout-spec` Color Palette** (match / PM update needed).
+- One line: **delta vs `layout-spec` Color Palette** (match / Game Designer update needed).
 
 #### 3. Motion Notes (`docs/style-exploration.md`)
 
@@ -141,22 +141,22 @@ No per-frame animation assets — VFX/Animation atoms remain TA.
 
 #### 4. Style Intent + Anti-Pattern Notes
 
-Existing `designer-log` sections — required for TA Step 0c.
+Existing `artist-log` sections — required for TA Step 0c.
 
 ---
 
 ### Phase 1 exception: True 3D
 
-When `design-brief` dimension = True 3D, Designer also delivers (Phase 1, same Gate #2b):
+When `design-brief` dimension = True 3D, Artist also delivers (Phase 1, same ring 3 verify):
 
-- 2D reference texture PNG at path noted in `designer-log` (see `refs/designer-dimension-axis.md`).
-- TA runs `generate-3d`; Designer does **not** output GLB.
+- 2D reference texture PNG at path noted in `artist-log` (see `.claude/agents/refs/artist-dimension-axis.md`).
+- TA runs `generate-3d`; Artist does **not** output GLB.
 
 ---
 
 ## Phase 2 Deliverables — Audio + Digit + Atom status
 
-**Designer does not batch-export visual samples at `assetMapping` paths in v2.** Visual baseline = Phase 1 MC + ASR.
+**Artist does not batch-export visual samples at `assetMapping` paths in v2.** Visual baseline = Phase 1 MC + ASR.
 
 ### Phase 2 Skill Preflight (mandatory, before production)
 
@@ -168,9 +168,9 @@ cat .claude/skills/playcraft-text-rendering/SKILL.md     # Digit strip green/blu
 cat .claude/skills/playcraft-image-generation/SKILL.md   # §3 background decision tree (for digit)
 ```
 
-**mediaGroups check** (mandatory): Read `atom-plan.json` → `skillsMatch.mediaGroups` for any `.aiaudio` matches. If matched → `playcraft skills link --atom <atomId>` → verify quality/mood → mark `status: done`. Skip only when mood/style mismatch (document in `dagRevisions`).
+**mediaGroups check** (mandatory): Read `atom-tree.json` → `skillsMatch.mediaGroups` for any `.aiaudio` matches. If matched → `playcraft skills link --atom <atomId>` → verify quality/mood → record linked path and decision in `artist-log.md` / `handoffContext`. Skip only when mood/style mismatch (document in `artist-log.md`).
 
-Record in `logs/designer-log.md` § Skill Preflight:
+Record in `logs/artist-log.md` § Skill Preflight:
 
 ```markdown
 ## Skill Preflight
@@ -182,38 +182,38 @@ Record in `logs/designer-log.md` § Skill Preflight:
 | mediaGroups (audio)        | ✅   | bg_music.aiaudio linked; click_sfx 需重做 (风格不符) |
 ```
 
-| #   | Deliverable            | Format | Spec                                  |
-| --- | ---------------------- | ------ | ------------------------------------- |
-| 1   | **BGM**                | MP3    | Mood matches locked MC                |
-| 2   | **SFX**                | MP3    | One per interaction in `assetMapping` |
-| 3   | **Digit sprite strip** | PNG    | `layout-spec` `textAssets.digitStrip` |
-| 4   | **VisualAtom status**  | —      | See below                             |
+| #   | Deliverable                    | Format | Spec                                  |
+| --- | ------------------------------ | ------ | ------------------------------------- |
+| 1   | **BGM**                        | MP3    | Mood matches locked MC                |
+| 2   | **SFX**                        | MP3    | One per interaction in `assetMapping` |
+| 3   | **Digit sprite strip**         | PNG    | `layout-spec` `textAssets.digitStrip` |
+| 4   | **Production handoff context** | —      | `artist-log.md` + `handoffContext`    |
 
-### VisualAtom rules (`atom-plan.json` → `atoms[]`)
+### Production handoff rules
 
-For each `assignTo: Designer` VisualAtom:
+For each Artist-owned production item:
 
-| Condition                           | `status`  | `actualOutput`                                                                      |
-| ----------------------------------- | --------- | ----------------------------------------------------------------------------------- |
-| Type covered in ASR Coverage Matrix | `done`    | `ASR:ui_state_sheet_[X]:R{row}C{col}` or `ASR:element_state_sheet_[X]:R{row}C{col}` |
-| Not covered; ICP gap                | `blocked` | ICP id + path when file delivered                                                   |
-| ICP supplementary PNG delivered     | `done`    | file path                                                                           |
+| Condition                           | Record in `artist-log.md` / `handoffContext` |
+| ----------------------------------- | -------------------------------------------- |
+| Type covered in ASR Coverage Matrix | ASR sheet + grid slot or MC crop region      |
+| Not covered; ICP gap                | ICP id + path when file delivered            |
+| ICP supplementary PNG delivered     | file path                                    |
 
-**Forbidden**: mark VisualAtom `done` without ASR row or supplementary file.
+**Forbidden**: write execution status or produced output paths into `atom-tree.json`.
 
 #### ICP supplementary PNG — when (and only when) to produce
 
-Designer Phase 2 supplementary PNGs are a **fallback path**, not a default. Produce one **only if all three** are true:
+Artist Phase 2 supplementary PNGs are a **fallback path**, not a default. Produce one **only if all three** are true:
 
-1. **TA Step 0c Style Interpretation** marks that atom's `confidence = low` in `logs/ta-log.md` (i.e. Designer's MC/ASR didn't tell TA enough).
+1. **TA Step 0c Style Interpretation** marks that atom's `confidence = low` in `logs/ta-log.md` (i.e. Artist's MC/ASR didn't tell TA enough).
 2. **Crop / segment from ASR or MC failed** — TA tried `playcraft image crop` (grid coord from ASR Coverage Matrix) and `playcraft image segment --boxes` / `--text` on the MC concept panel, and the extracted region is unusable (chroma residue, partial element, wrong perspective).
-3. **TA opens an ICP entry** in `docs/intent-clarifications.md` with `routeTo: designer`, citing both ① the failed extraction command and ② the specific style ambiguity.
+3. **TA opens an ICP entry** in `docs/intent-clarifications.md` with `routeTo: artist`, citing both ① the failed extraction command and ② the specific style ambiguity.
 
-If any of ①②③ is missing, the fix lives elsewhere (TA tool chain, Designer Style Intent Notes patch, or PM contract patch) — not a supplementary PNG. Document the chosen route in `designer-log.md`.
+If any of ①②③ is missing, the fix lives elsewhere (TA tool chain, Artist Style Intent Notes patch, or Game Designer contract patch) — not a supplementary PNG. Document the chosen route in `artist-log.md`.
 
 Run **`playcraft-style-qa` §1** only for **ICP supplementary** image files (not for ASR sheets themselves).
 
-### TA ownership in Phase 2 (not Designer)
+### TA ownership in Phase 2 (not Artist)
 
 - Static text extraction → contract paths
 - Background webp

package/project-template/.claude/agents/refs/{designer-dimension-axis.md → artist-dimension-axis.md}

@@ -1,6 +1,6 @@
-# Designer Dimension Axis Workflow
+# Artist Dimension Axis Workflow
 
-> Read in Phase 1 after confirming Dimension Axis from `docs/design-brief.md`. **designer-handoff-v2**: visual baseline = MC + ASR (not scattered sample PNGs). TA handles mass production.
+> Read in Phase 1 after confirming Dimension Axis from `docs/design-brief.md`. **artist-handoff-v2**: visual baseline = MC + ASR (not scattered sample PNGs). TA handles mass production.
 
 ## Flat 2D (Standard)
 
@@ -12,7 +12,7 @@
 
 - MC concept panel: perspective scene + layered elements.
 - ASR: angled sprites in element sheet; note depth layers in Style Intent Notes.
-- Background: default **TA extract from MC**; dedicated bg sample only if PM atom `assignTo: Designer` via ICP.
+- Background: default **TA extract from MC**; dedicated bg sample only if Game Designer routes an ICP supplementary art request.
 
 ## Isometric
 
@@ -22,6 +22,6 @@
 
 ## True 3D
 
-- Designer does **not** output GLB.
-- Phase 1 Gate #2b: 2D reference texture PNG (path in `designer-log`) per `designer-deliverable-spec.md` § Phase 1 exception.
+- Artist does **not** output GLB.
+- Phase 1 ring 3 verify: 2D reference texture PNG (path in `artist-log`) per `artist-deliverable-spec.md` § Phase 1 exception.
 - TA: `generate-3d`, GLB, flip sprites.

package/project-template/.claude/agents/refs/{designer-handoff-v2-checklist.md → artist-handoff-v2-checklist.md}

@@ -1,19 +1,19 @@
-# Designer Handoff v2 — Gate #2b checklist
+# Artist Handoff v2 — Ring 3 verify checklist
 
-> Read at **Step 5** of `designer-style-exploration-flow.md` before `gates.#2b = pending` STOP.
+> Read at **Step 5** of `artist-style-exploration-flow.md` before ring 3 verify STOP (`ringGate: pending`).
 
 ## Prerequisites
 
-- [ ] `workflowSpecVersion` = `designer-handoff-v2` in `project-state.md` (or migrating per `workflow-changelog.md`)
-- [ ] `selectedMcOption` set (Gate #2a passed)
+- [ ] `workflowSpecVersion` = `growth-rings-v1` in `npm run state:get -- --json`
+- [ ] `selectedMcOption` set (ring 3 Ring Gate — MC selection 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)
+- [ ] § **Image Production Preflight** filled (ring 3 build — three Skills read)
 
 ## 1. ASR Coverage Matrix (100% rows)
 
-In `logs/designer-log.md` § ASR Coverage Matrix:
+In `logs/artist-log.md` § ASR Coverage Matrix:
 
 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.
@@ -25,7 +25,7 @@ In `logs/designer-log.md` § ASR Coverage Matrix:
 
 **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.
+**Stop rule**: any contract row missing → do not set `ringGate: pending`.
 
 ## 2. Palette Locked
 
@@ -39,7 +39,7 @@ In `logs/designer-log.md` § ASR Coverage Matrix:
 | cta        | #**\_\_** |       |
 | element_1  | #**\_\_** |       |
 
-**Delta vs layout-spec**: match | PM update: <one line>
+**Delta vs layout-spec**: match | Game Designer update: <one line>
 ```
 
 ## 3. Motion Notes
@@ -52,17 +52,17 @@ In `docs/style-exploration.md` under confirmed option:
 | Tutorial → Gameplay |      |          |       |
 | Gameplay → End Card |      |          |       |
 
-## 4. Phase 2 VisualAtom decision tree
+## 4. Phase 2 production handoff decision tree
 
 ```
-For each atom-plan row where assignTo = Designer:
+For each Artist-owned production item:
 ├─ VisualAtom + covered in Coverage Matrix?
-│   └─ yes → status=done, actualOutput=ASR:... (on-asr rows → asrSlot in atom-plan.json)
+│   └─ yes → record ASR sheet/grid or MC crop in artist-log + handoffContext
 ├─ AudioAtom?
-│   └─ deliver MP3 at path → done (Phase 2 only)
+│   └─ deliver MP3 at path → record in artist-log + handoffContext
 ├─ Gap / TA extract failed (ICP)?
-│   └─ generate one PNG → done with path, or blocked until answered
-└─ Never: done with only "will extract later"
+│   └─ generate one PNG → record path, or block until answered
+└─ Never: write execution status or output paths into atom-tree.json
 ```
 
 ## 5. Files to verify before STOP
@@ -70,7 +70,7 @@ For each atom-plan row where assignTo = Designer:
 | 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 |
+| `logs/artist-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/artist-legacy-fallback.md

@@ -0,0 +1,14 @@
+# Artist Legacy Fallback
+
+Use this reference only when `dispatchPacket` is null and `sliceState` is empty.
+
+This preserves the older visual handoff path for existing projects. It is not part of slice-axis dispatch.
+
+Legacy behavior:
+
+- Read `npm run state:get -- --json` and follow the disclosed current action.
+- Use the existing Artist reference guides only when the orchestrator-disclosed task asks for them.
+- Produce visual handoff context and artifact references, not runtime implementation.
+- Route missing design or asset contract gaps instead of guessing.
+
+When `sliceState` exists, return to the main Artist role contract.

package/project-template/.claude/agents/refs/{designer-master-composite-recipes.md → artist-master-composite-recipes.md}

@@ -1,6 +1,6 @@
 # Master Composite — 游戏类型 Prompt 配方 & 参考
 
-> 本文件供 Designer 在生成 Master Composite 时按需查阅。核心规则见 `playcraft-storyboard` skill。
+> 本文件供 Artist 在生成 Master Composite 时按需查阅。核心规则见 `playcraft-storyboard` skill。
 
 ## 模型策略（MC 专用 — 仅高质量模型）
 
@@ -198,10 +198,10 @@ playcraft tools generate-image \
 ```
 assets/images/storyboard/master_composite_option_A.png  ← 方案 A
 assets/images/storyboard/master_composite_option_B.png  ← 方案 B
-assets/images/storyboard/master_composite.png           ← Gate #2 确认后复制
+assets/images/storyboard/master_composite.png           ← ring 3 Ring Gate 确认后复制
 ```
 
-Gate #2 确认后：
+ring 3 Ring Gate 确认后：
 
 ```bash
 cp assets/images/storyboard/master_composite_option_[X].png assets/images/storyboard/master_composite.png

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

@@ -0,0 +1,55 @@
+# Artist — Style exploration flow (Phase 1: ASR + Handoff Pack)
+
+> **Scope**: After MC is delivered by storyboard subagent and `selectedMcOption` is set (ring 3 Ring Gate passed), follow this document for **ASR production** through ring 3 verify STOP. **Exit criteria**: see `agents/artist.md` Goals § Success criteria.
+>
+> **Deliverable shapes & tables**: `.claude/agents/refs/artist-deliverable-spec.md`.
+>
+> **Pre-condition**: `npm run state:get -- --json` reports `selectedMcOption` (MC already exists at `assets/images/storyboard/master_composite_option_[X].png`).
+
+**Trigger**: `state:get` reports `iteration: 3`, `loop: build`, `selectedMcOption` set.
+
+## Step 1 — Image Production Preflight (before ASR)
+
+Fill `logs/artist-log.md` § **Image Production Preflight**:
+
+1. Read `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 ASR sheets（仅针对 state `selectedMcOption`）
+
+- Read `selectedMcOption` from `npm run state:get -- --json` — if missing, **STOP**
+- **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 3 — Ring 3 Handoff Pack
+
+> **Checklist**: `.claude/agents/refs/artist-handoff-v2-checklist.md`
+
+1. 补全 `docs/style-exploration.md`（ASR 路径、**Motion Notes**、Experience Flow）
+2. 更新 `logs/artist-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-tree.json` → `meta.selectedAtoms.asrSlot`
+3. **Self-check before STOP**:
+
+```bash
+# MC ratio (confirm MC from storyboard subagent is valid)
+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 + `ringGate: pending`
+5. **STOP** — 禁止 Phase 2 音频与批量视觉样本 PNG