create-ai-project 1.16.2 → 1.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/.claude/agents-en/acceptance-test-generator.md +4 -3
  2. package/.claude/agents-en/code-reviewer.md +2 -2
  3. package/.claude/agents-en/code-verifier.md +2 -2
  4. package/.claude/agents-en/design-sync.md +2 -2
  5. package/.claude/agents-en/document-reviewer.md +4 -4
  6. package/.claude/agents-en/integration-test-reviewer.md +2 -2
  7. package/.claude/agents-en/investigator.md +2 -2
  8. package/.claude/agents-en/prd-creator.md +4 -2
  9. package/.claude/agents-en/quality-fixer-frontend.md +7 -5
  10. package/.claude/agents-en/quality-fixer.md +3 -3
  11. package/.claude/agents-en/requirement-analyzer.md +2 -2
  12. package/.claude/agents-en/scope-discoverer.md +2 -2
  13. package/.claude/agents-en/skill-creator.md +2 -2
  14. package/.claude/agents-en/skill-reviewer.md +2 -2
  15. package/.claude/agents-en/solver.md +2 -2
  16. package/.claude/agents-en/task-decomposer.md +2 -2
  17. package/.claude/agents-en/task-executor-frontend.md +3 -3
  18. package/.claude/agents-en/task-executor.md +2 -2
  19. package/.claude/agents-en/technical-designer-frontend.md +17 -6
  20. package/.claude/agents-en/technical-designer.md +2 -2
  21. package/.claude/agents-en/ui-spec-designer.md +115 -0
  22. package/.claude/agents-en/verifier.md +2 -2
  23. package/.claude/agents-en/work-planner.md +2 -2
  24. package/.claude/agents-ja/acceptance-test-generator.md +4 -3
  25. package/.claude/agents-ja/code-reviewer.md +2 -2
  26. package/.claude/agents-ja/code-verifier.md +2 -2
  27. package/.claude/agents-ja/design-sync.md +2 -2
  28. package/.claude/agents-ja/document-reviewer.md +4 -4
  29. package/.claude/agents-ja/integration-test-reviewer.md +2 -2
  30. package/.claude/agents-ja/investigator.md +2 -2
  31. package/.claude/agents-ja/prd-creator.md +4 -2
  32. package/.claude/agents-ja/quality-fixer-frontend.md +7 -5
  33. package/.claude/agents-ja/quality-fixer.md +3 -3
  34. package/.claude/agents-ja/requirement-analyzer.md +2 -2
  35. package/.claude/agents-ja/scope-discoverer.md +2 -2
  36. package/.claude/agents-ja/skill-creator.md +2 -2
  37. package/.claude/agents-ja/skill-reviewer.md +2 -2
  38. package/.claude/agents-ja/solver.md +2 -2
  39. package/.claude/agents-ja/task-decomposer.md +2 -2
  40. package/.claude/agents-ja/task-executor-frontend.md +3 -3
  41. package/.claude/agents-ja/task-executor.md +2 -2
  42. package/.claude/agents-ja/technical-designer-frontend.md +17 -6
  43. package/.claude/agents-ja/technical-designer.md +2 -2
  44. package/.claude/agents-ja/ui-spec-designer.md +115 -0
  45. package/.claude/agents-ja/verifier.md +2 -2
  46. package/.claude/agents-ja/work-planner.md +2 -2
  47. package/.claude/commands-en/add-integration-tests.md +1 -1
  48. package/.claude/commands-en/build.md +55 -19
  49. package/.claude/commands-en/create-skill.md +1 -1
  50. package/.claude/commands-en/design.md +1 -1
  51. package/.claude/commands-en/diagnose.md +2 -2
  52. package/.claude/commands-en/front-build.md +40 -20
  53. package/.claude/commands-en/front-design.md +25 -8
  54. package/.claude/commands-en/front-plan.md +17 -9
  55. package/.claude/commands-en/front-review.md +2 -2
  56. package/.claude/commands-en/implement.md +15 -10
  57. package/.claude/commands-en/project-inject.md +1 -1
  58. package/.claude/commands-en/refine-skill.md +1 -1
  59. package/.claude/commands-en/reverse-engineer.md +3 -3
  60. package/.claude/commands-en/review.md +2 -2
  61. package/.claude/commands-en/sync-skills.md +1 -1
  62. package/.claude/commands-en/update-doc.md +2 -2
  63. package/.claude/commands-ja/add-integration-tests.md +1 -1
  64. package/.claude/commands-ja/build.md +56 -18
  65. package/.claude/commands-ja/create-skill.md +1 -1
  66. package/.claude/commands-ja/design.md +1 -1
  67. package/.claude/commands-ja/diagnose.md +2 -2
  68. package/.claude/commands-ja/front-build.md +41 -21
  69. package/.claude/commands-ja/front-design.md +26 -9
  70. package/.claude/commands-ja/front-plan.md +15 -7
  71. package/.claude/commands-ja/front-review.md +2 -2
  72. package/.claude/commands-ja/implement.md +15 -10
  73. package/.claude/commands-ja/project-inject.md +1 -1
  74. package/.claude/commands-ja/refine-skill.md +1 -1
  75. package/.claude/commands-ja/reverse-engineer.md +3 -3
  76. package/.claude/commands-ja/review.md +2 -2
  77. package/.claude/commands-ja/sync-skills.md +1 -1
  78. package/.claude/commands-ja/update-doc.md +2 -2
  79. package/.claude/skills-en/documentation-criteria/SKILL.md +37 -1
  80. package/.claude/skills-en/documentation-criteria/references/design-template.md +24 -0
  81. package/.claude/skills-en/documentation-criteria/references/prd-template.md +10 -0
  82. package/.claude/skills-en/documentation-criteria/references/ui-spec-template.md +145 -0
  83. package/.claude/skills-en/{frontend/technical-spec → frontend-technical-spec}/SKILL.md +5 -5
  84. package/.claude/skills-en/{frontend/typescript-rules → frontend-typescript-rules}/SKILL.md +1 -1
  85. package/.claude/skills-en/{frontend/typescript-testing → frontend-typescript-testing}/SKILL.md +9 -2
  86. package/.claude/skills-en/frontend-typescript-testing/references/e2e.md +185 -0
  87. package/.claude/skills-en/integration-e2e-testing/SKILL.md +4 -0
  88. package/.claude/skills-en/integration-e2e-testing/references/e2e-design.md +86 -0
  89. package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +44 -22
  90. package/.claude/skills-en/task-analyzer/references/skills-index.yaml +15 -11
  91. package/.claude/skills-en/technical-spec/SKILL.md +5 -4
  92. package/.claude/skills-ja/documentation-criteria/SKILL.md +37 -1
  93. package/.claude/skills-ja/documentation-criteria/references/design-template.md +24 -0
  94. package/.claude/skills-ja/documentation-criteria/references/prd-template.md +10 -0
  95. package/.claude/skills-ja/documentation-criteria/references/ui-spec-template.md +145 -0
  96. package/.claude/skills-ja/{frontend/technical-spec → frontend-technical-spec}/SKILL.md +5 -5
  97. package/.claude/skills-ja/{frontend/typescript-rules → frontend-typescript-rules}/SKILL.md +1 -1
  98. package/.claude/skills-ja/{frontend/typescript-testing → frontend-typescript-testing}/SKILL.md +2 -2
  99. package/.claude/skills-ja/frontend-typescript-testing/references/e2e.md +185 -0
  100. package/.claude/skills-ja/integration-e2e-testing/SKILL.md +4 -0
  101. package/.claude/skills-ja/integration-e2e-testing/references/e2e-design.md +86 -0
  102. package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +44 -22
  103. package/.claude/skills-ja/task-analyzer/references/skills-index.yaml +15 -11
  104. package/.claude/skills-ja/technical-spec/SKILL.md +5 -4
  105. package/CHANGELOG.md +67 -0
  106. package/CLAUDE.en.md +2 -2
  107. package/CLAUDE.ja.md +2 -2
  108. package/CLAUDE.md +68 -86
  109. package/README.ja.md +10 -7
  110. package/README.md +10 -7
  111. package/bin/create-project.js +76 -75
  112. package/biome.json +5 -8
  113. package/package.json +11 -24
  114. package/scripts/post-setup.js +54 -57
  115. package/scripts/set-language.js +107 -112
  116. package/scripts/setup-project.js +97 -92
  117. package/scripts/show-coverage.js +36 -22
  118. package/scripts/update-project.js +205 -201
  119. package/scripts/utils.js +19 -21
  120. package/tsconfig.json +3 -3
  121. package/vitest.config.mjs +2 -2
  122. package/.tsprunerc +0 -11
  123. package/scripts/check-unused-exports.js +0 -69
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: verifier
3
3
  description: 調査結果を批判的に評価し見落としを探す。Use when investigatorの調査完了後、または「検証/本当に/確認/見落とし/他の可能性」が言及された時。ACH・Devil's Advocate手法で妥当性を検証し結論を導出。
4
- tools: Read, Grep, Glob, LS, Bash, WebSearch, TodoWrite
4
+ tools: Read, Grep, Glob, LS, Bash, WebSearch, TaskCreate, TaskUpdate
5
5
  skills: project-context, technical-spec, coding-standards
6
6
  ---
7
7
 
@@ -11,7 +11,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
11
11
 
12
12
  ## 初回必須タスク
13
13
 
14
- **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
14
+ **タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
15
15
 
16
16
  **現在日時の確認**: 作業開始前に`date`コマンドで現在年月日を確認し、最新情報の判断基準とする。
17
17
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: work-planner
3
3
  description: Design Docから作業計画書を作成し実装タスクを構造化。Use when Design Doc完成後に実装計画が必要な時、または「作業計画/計画書/plan/スケジュール」が言及された時。進捗追跡可能な実行計画を立案。
4
- tools: Read, Write, Edit, MultiEdit, Glob, LS, TodoWrite
4
+ tools: Read, Write, Edit, MultiEdit, Glob, LS, TaskCreate, TaskUpdate
5
5
  skills: documentation-criteria, project-context, technical-spec, implementation-approach, typescript-testing, typescript-rules
6
6
  ---
7
7
 
@@ -11,7 +11,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
11
11
 
12
12
  ## 初回必須タスク
13
13
 
14
- **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
14
+ **タスク登録**: TaskCreateで作業ステップを登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時にTaskUpdateで更新。
15
15
 
16
16
  ### 実装への反映
17
17
  - documentation-criteriaスキルでドキュメント作成基準を適用
@@ -10,7 +10,7 @@ description: Add integration/E2E tests to existing backend codebase using Design
10
10
 
11
11
  **Core Identity**: "I am not a worker. I am an orchestrator."
12
12
 
13
- **First Action**: Register Steps 0-8 to TodoWrite before any execution.
13
+ **First Action**: Register Steps 0-8 with TaskCreate before any execution.
14
14
 
15
15
  **Why Delegate**: Orchestrator's context is shared across all steps. Direct implementation consumes context needed for review and quality check phases. Task files create context boundaries. Subagents work in isolated context.
16
16
 
@@ -2,11 +2,21 @@
2
2
  description: Execute decomposed tasks in autonomous execution mode
3
3
  ---
4
4
 
5
- Follow subagents-orchestration-guide skill strictly and act as the **orchestrator** — your role is to invoke sub-agents, pass data between them, and report results.
5
+ ## Orchestrator Definition
6
+
7
+ **Core Identity**: "I am not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
8
+
9
+ **Execution Protocol**:
10
+ 1. **Delegate all work** to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
11
+ 2. **Follow the 4-step task cycle exactly**: task-executor → escalation check → quality-fixer → commit
12
+ 3. **Enter autonomous mode** when user provides execution instruction with existing task files — this IS the batch approval
13
+ 4. **Scope**: Complete when all tasks are committed or escalation occurs
14
+
15
+ **CRITICAL**: Run quality-fixer before every commit.
6
16
 
7
17
  Work plan: $ARGUMENTS
8
18
 
9
- ## 📋 Pre-execution Prerequisites
19
+ ## Pre-execution Prerequisites
10
20
 
11
21
  ### Task File Existence Check
12
22
  ```bash
@@ -19,15 +29,15 @@ Work plan: $ARGUMENTS
19
29
 
20
30
  ### Task Generation Decision Flow
21
31
 
22
- Analyze task file existence state and determine the appropriate action:
32
+ Analyze task file existence state and determine the action required:
23
33
 
24
34
  | State | Criteria | Next Action |
25
35
  |-------|----------|-------------|
26
- | Tasks exist | .md files in tasks/ directory | Proceed to autonomous execution |
36
+ | Tasks exist | .md files in tasks/ directory | User's execution instruction serves as batch approval → Enter autonomous execution immediately |
27
37
  | No tasks + plan exists | Plan exists but no task files | Confirm with user → run task-decomposer |
28
38
  | Neither exists | No plan or task files | Error: Prerequisites not met |
29
39
 
30
- ## 🔄 Task Decomposition Phase (Conditional)
40
+ ## Task Decomposition Phase (Conditional)
31
41
 
32
42
  When task files don't exist:
33
43
 
@@ -40,11 +50,10 @@ Generate tasks from the work plan? (y/n):
40
50
  ```
41
51
 
42
52
  ### 2. Task Decomposition (if approved)
43
-
44
53
  Invoke task-decomposer using Task tool:
45
54
  - `subagent_type`: "task-decomposer"
46
- - `description`: "Decompose work plan into tasks"
47
- - `prompt`: "Read work plan and decompose into atomic tasks. Input: docs/plans/[plan-name].md. Output: Individual task files in docs/plans/tasks/. Granularity: 1 task = 1 commit = independently executable"
55
+ - `description`: "Decompose work plan"
56
+ - `prompt`: "Read work plan at docs/plans/[plan-name].md and decompose into atomic tasks. Output: Individual task files in docs/plans/tasks/. Granularity: 1 task = 1 commit = independently executable"
48
57
 
49
58
  ### 3. Verify Generation
50
59
  ```bash
@@ -52,25 +61,52 @@ Invoke task-decomposer using Task tool:
52
61
  ! ls -la docs/plans/tasks/*.md | head -10
53
62
  ```
54
63
 
55
- ✅ **Recommended**: After task generation, automatically proceed to autonomous execution
56
- ❌ **Avoid**: Starting implementation without task generation
64
+ ✅ **Flow**: Task generation Autonomous execution (in this order)
65
+
66
+ ## Pre-execution Checklist
67
+
68
+ - [ ] Confirmed task files exist in docs/plans/tasks/
69
+ - [ ] Identified task execution order (dependencies)
70
+ - [ ] **Environment check**: Can I execute per-task commit cycle?
71
+ - If commit capability unavailable → Escalate before autonomous mode
72
+ - Other environments (tests, quality tools) → Subagents will escalate
73
+
74
+ ## Task Execution Cycle (4-Step Cycle)
75
+ **MANDATORY EXECUTION CYCLE**: `task-executor → escalation check → quality-fixer → commit`
76
+
77
+ For EACH task, YOU MUST:
78
+ 1. **Register tasks using TaskCreate**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity"
79
+ 2. **INVOKE task-executor**: Execute the task implementation (cross-layer: see Layer-Aware Agent Routing in subagents-orchestration-guide)
80
+ 3. **CHECK task-executor response**:
81
+ - `status: "escalation_needed"` or `"blocked"` → STOP and escalate to user
82
+ - `testsAdded` contains `*.int.test.ts` or `*.e2e.test.ts` → Execute **integration-test-reviewer**
83
+ - `needs_revision` → Return to step 2 with `requiredFixes`
84
+ - `approved` → Proceed to step 4
85
+ - `readyForQualityCheck: true` → Proceed to step 4
86
+ 4. **INVOKE quality-fixer**: Execute all quality checks and fixes (cross-layer: see Layer-Aware Agent Routing)
87
+ 5. **COMMIT on approval**: After `approved: true` from quality-fixer → Execute git commit
88
+
89
+ **CRITICAL**: Monitor ALL structured responses WITHOUT EXCEPTION and ENSURE every quality gate is passed.
90
+
91
+ ## Sub-agent Invocation Constraints
92
+
93
+ **MANDATORY suffix for ALL sub-agent prompts**:
94
+ ```
95
+ [SYSTEM CONSTRAINT]
96
+ This agent operates within build skill scope. Use orchestrator-provided rules only.
97
+ ```
57
98
 
58
- ## 🧠 Task Execution Flow
59
- Following "Autonomous Execution Task Management" in subagents-orchestration-guide skill, manage 4 steps with TodoWrite. Always include: first "Confirm skill constraints", final "Verify skill fidelity":
60
- 1. task-executor execution (cross-layer: see Layer-Aware Agent Routing)
61
- 2. Escalation judgment and follow-up
62
- 3. quality-fixer execution (cross-layer: see Layer-Aware Agent Routing)
63
- 4. git commit
99
+ Autonomous sub-agents require scope constraints for stable execution. ALWAYS append this constraint to every sub-agent prompt.
64
100
 
65
- After approval confirmation, start autonomous execution mode. Stop immediately when requirement changes detected.
101
+ After approval confirmation, start autonomous execution mode. STOP IMMEDIATELY upon detecting ANY requirement changes.
66
102
 
67
103
  ## Output Example
68
104
  Implementation phase completed.
69
- - Task decomposition: Generated under docs/plans/tasks/ (if executed)
105
+ - Task decomposition: Generated under docs/plans/tasks/
70
106
  - Implemented tasks: [number] tasks
71
107
  - Quality checks: All passed
72
108
  - Commits: [number] commits created
73
109
 
74
110
  **Responsibility Boundary**:
75
111
  - IN SCOPE: Task decomposition to implementation completion
76
- - OUT OF SCOPE: Design phase, planning phase
112
+ - OUT OF SCOPE: Design phase, planning phase
@@ -8,7 +8,7 @@ Skill topic: $ARGUMENTS
8
8
 
9
9
  ## Execution Process
10
10
 
11
- Register the following steps in TodoWrite and proceed systematically.
11
+ Register the following steps with TaskCreate and proceed systematically.
12
12
 
13
13
  ### Step 1: Pre-flight Check
14
14
 
@@ -72,4 +72,4 @@ Design phase completed.
72
72
  - Design document: docs/design/[document-name].md
73
73
  - Consistency: No conflicts with other Design Docs (or fixes completed)
74
74
 
75
- **Important**: This command ends with design approval + consistency verification. Does not propose transition to next phase.
75
+ **Responsibility Boundary**: This command ends with design approval + consistency verification. Work planning and beyond are outside scope.
@@ -15,7 +15,7 @@ Target problem: $ARGUMENTS
15
15
 
16
16
  Orchestrator invokes sub-agents and passes structured JSON between them.
17
17
 
18
- **TodoWrite Registration**: Register execution steps in TodoWrite and proceed systematically
18
+ **Task Registration**: Register execution steps with TaskCreate and proceed systematically
19
19
 
20
20
  ## Step 0: Problem Structuring (Before investigator invocation)
21
21
 
@@ -74,7 +74,7 @@ confidence=high reached → Report
74
74
 
75
75
  ## Execution Steps
76
76
 
77
- Register the following in TodoWrite and execute:
77
+ Register the following with TaskCreate and execute:
78
78
 
79
79
  ### Step 1: Investigation (investigator)
80
80
 
@@ -14,7 +14,12 @@ description: Execute frontend implementation in autonomous execution mode
14
14
 
15
15
  Orchestrator invokes sub-agents and passes structured JSON between them.
16
16
 
17
- **CRITICAL**: Run quality-fixer-frontend before every commit. Obtain batch approval before autonomous mode.
17
+ **Execution Protocol**:
18
+ 1. **Delegate all work** to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
19
+ 2. **Follow the 4-step task cycle exactly**: task-executor-frontend → escalation check → quality-fixer-frontend → commit
20
+ 3. **Enter autonomous mode** when user provides execution instruction with existing task files — this IS the batch approval
21
+
22
+ **CRITICAL**: Run quality-fixer-frontend before every commit.
18
23
 
19
24
  Work plan: $ARGUMENTS
20
25
 
@@ -31,11 +36,11 @@ Work plan: $ARGUMENTS
31
36
 
32
37
  ### Task Generation Decision Flow
33
38
 
34
- Analyze task file existence state and determine the appropriate action:
39
+ Analyze task file existence state and determine the action required:
35
40
 
36
41
  | State | Criteria | Next Action |
37
42
  |-------|----------|-------------|
38
- | Tasks exist | .md files in tasks/ directory | Proceed to autonomous execution |
43
+ | Tasks exist | .md files in tasks/ directory | User's execution instruction serves as batch approval → Enter autonomous execution immediately |
39
44
  | No tasks + plan exists | Plan exists but no task files | Confirm with user → run task-decomposer |
40
45
  | Neither exists | No plan or task files | Error: Prerequisites not met |
41
46
 
@@ -52,11 +57,10 @@ Generate tasks from the work plan? (y/n):
52
57
  ```
53
58
 
54
59
  ### 2. Task Decomposition (if approved)
55
-
56
60
  Invoke task-decomposer using Task tool:
57
61
  - `subagent_type`: "task-decomposer"
58
- - `description`: "Decompose work plan into tasks"
59
- - `prompt`: "Read work plan and decompose into atomic tasks. Input: docs/plans/[plan-name].md. Output: Individual task files in docs/plans/tasks/. Granularity: 1 task = 1 commit = independently executable"
62
+ - `description`: "Decompose work plan"
63
+ - `prompt`: "Read work plan at docs/plans/[plan-name].md and decompose into atomic tasks. Output: Individual task files in docs/plans/tasks/. Granularity: 1 task = 1 commit = independently executable"
60
64
 
61
65
  ### 3. Verify Generation
62
66
  ```bash
@@ -66,6 +70,14 @@ Invoke task-decomposer using Task tool:
66
70
 
67
71
  ✅ **Flow**: Task generation → Autonomous execution (in this order)
68
72
 
73
+ ## Pre-execution Checklist
74
+
75
+ - [ ] Confirmed task files exist in docs/plans/tasks/
76
+ - [ ] Identified task execution order (dependencies)
77
+ - [ ] **Environment check**: Can I execute per-task commit cycle?
78
+ - If commit capability unavailable → Escalate before autonomous mode
79
+ - Other environments (tests, quality tools) → Subagents will escalate
80
+
69
81
  ## Task Execution Cycle (4-Step Cycle) - Frontend Specialized
70
82
 
71
83
  **MANDATORY EXECUTION CYCLE**: `task-executor-frontend → escalation check → quality-fixer-frontend → commit`
@@ -79,37 +91,45 @@ Use Task tool to invoke sub-agents:
79
91
  ### Structured Response Specification
80
92
  Each sub-agent responds in JSON format:
81
93
  - **task-executor-frontend**: status, filesModified, testsAdded, readyForQualityCheck
94
+ - **integration-test-reviewer**: status (approved/needs_revision/blocked), requiredFixes
82
95
  - **quality-fixer-frontend**: status, checksPerformed, fixesApplied, approved
83
96
 
84
97
  ### Execution Flow for Each Task
85
98
 
86
99
  For EACH task, YOU MUST:
87
100
 
88
- 1. **UPDATE TodoWrite**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity"
101
+ 1. **Register tasks using TaskCreate**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity"
89
102
  2. **USE task-executor-frontend**: Execute frontend implementation
90
103
  - Invocation example: `subagent_type: "task-executor-frontend"`, `description: "Task execution"`, `prompt: "Task file: docs/plans/tasks/[filename].md Execute implementation"`
91
- 3. **CHECK ESCALATION**: Check task-executor-frontend status → If `status: "escalation_needed"` → STOP and escalate to user
92
- 4. **PROCESS structured responses**: When `readyForQualityCheck: true` is detectedEXECUTE quality-fixer-frontend IMMEDIATELY
93
- 5. **USE quality-fixer-frontend**: Execute all quality checks (Biome, TypeScript build, tests)
104
+ 3. **CHECK task-executor-frontend response**:
105
+ - `status: "escalation_needed"` or `"blocked"`STOP and escalate to user
106
+ - `testsAdded` contains `*.int.test.ts` or `*.e2e.test.ts` Execute **integration-test-reviewer**
107
+ - `needs_revision` → Return to step 2 with `requiredFixes`
108
+ - `approved` → Proceed to step 4
109
+ - `readyForQualityCheck: true` → Proceed to step 4
110
+ 4. **USE quality-fixer-frontend**: Execute all quality checks and fixes
94
111
  - Invocation example: `subagent_type: "quality-fixer-frontend"`, `description: "Quality check"`, `prompt: "Execute all frontend quality checks and fixes"`
95
- 6. **EXECUTE commit**: After `approved: true` confirmation, execute git commit IMMEDIATELY
96
-
97
- ### Quality Assurance During Autonomous Execution (Details)
98
- - task-executor-frontend execution → escalation check → quality-fixer-frontend execution → **orchestrator executes commit** (using Bash tool)
99
- - After quality-fixer-frontend's `approved: true` confirmation, execute git commit IMMEDIATELY
100
- - Use `changeSummary` for commit message
112
+ 5. **EXECUTE commit**: After `approved: true` confirmation, execute git commit IMMEDIATELY. Use `changeSummary` for commit message.
101
113
 
102
114
  **CRITICAL**: Monitor ALL structured responses WITHOUT EXCEPTION and ENSURE every quality gate is passed.
103
115
 
116
+ ## Sub-agent Invocation Constraints
117
+
118
+ **MANDATORY suffix for ALL sub-agent prompts**:
119
+ ```
120
+ [SYSTEM CONSTRAINT]
121
+ This agent operates within build skill scope. Use orchestrator-provided rules only.
122
+ ```
123
+
124
+ Autonomous sub-agents require scope constraints for stable execution. ALWAYS append this constraint to every sub-agent prompt.
125
+
104
126
  ! ls -la docs/plans/*.md | head -10
105
127
 
106
- Verify approval status before proceeding. Once confirmed, initiate autonomous execution mode. Stop immediately upon detecting any requirement changes.
128
+ VERIFY approval status before proceeding. Once confirmed, INITIATE autonomous execution mode. STOP IMMEDIATELY upon detecting ANY requirement changes.
107
129
 
108
130
  ## Output Example
109
131
  Frontend implementation phase completed.
110
132
  - Task decomposition: Generated under docs/plans/tasks/
111
133
  - Implemented tasks: [number] tasks
112
- - Quality checks: All passed (Biome, TypeScript build, tests)
134
+ - Quality checks: All passed
113
135
  - Commits: [number] commits created
114
-
115
- **Important**: This command manages the entire autonomous execution flow for frontend implementation from task decomposition to completion. Automatically uses frontend-specialized agents (task-executor-frontend, quality-fixer-frontend).
@@ -10,6 +10,7 @@ description: Execute from requirement analysis to frontend design document creat
10
10
 
11
11
  **Execution Method**:
12
12
  - Requirement analysis → performed by requirement-analyzer
13
+ - UI Specification creation → performed by ui-spec-designer
13
14
  - Design document creation → performed by technical-designer-frontend
14
15
  - Document review → performed by document-reviewer
15
16
 
@@ -19,17 +20,18 @@ Orchestrator invokes sub-agents and passes structured JSON between them.
19
20
 
20
21
  **Included in this command**:
21
22
  - Requirement analysis with requirement-analyzer
23
+ - UI Specification creation with ui-spec-designer (prototype code inquiry included)
22
24
  - ADR creation (if architecture changes, new technology, or data flow changes)
23
25
  - Design Doc creation with technical-designer-frontend
24
26
  - Document review with document-reviewer
25
27
 
26
- **Responsibility Boundary**: This command completes with design document approval.
28
+ **Responsibility Boundary**: This command completes with frontend design document (UI Spec/ADR/Design Doc) approval. Work planning and beyond are outside scope.
27
29
 
28
30
  Requirements: $ARGUMENTS
29
31
 
30
32
  ## Execution Flow
31
33
 
32
- ### 1. Requirement Analysis Phase
34
+ ### Step 1: Requirement Analysis Phase
33
35
  Considering the deep impact on design, first engage in dialogue to understand the background and purpose of requirements:
34
36
  - What problems do you want to solve?
35
37
  - Expected outcomes and success criteria
@@ -42,20 +44,35 @@ Once requirements are moderately clarified:
42
44
  - `prompt: "Requirements: [user requirements] Execute requirement analysis and scale determination"`
43
45
  - **[STOP]**: Review requirement analysis results and address question items
44
46
 
45
- ### 2. Design Document Creation Phase
47
+ ### Step 2: UI Specification Phase
48
+ After requirement analysis approval, ask the user about prototype code:
49
+
50
+ **Ask the user**: "Do you have prototype code for this feature? If so, please provide the path to the code. The prototype will be placed in `docs/ui-spec/assets/` as reference material for the UI Spec."
51
+
52
+ - **[STOP]**: Wait for user response about prototype code availability
53
+
54
+ Then create the UI Specification:
55
+ - Invoke **ui-spec-designer** using Task tool
56
+ - `subagent_type: "ui-spec-designer"`
57
+ - `description: "UI Spec creation"`
58
+ - If PRD exists and prototype provided: `prompt: "Create UI Spec from PRD at [path]. Prototype code is at [user-provided path]. Place prototype in docs/ui-spec/assets/{feature-name}/"`
59
+ - If PRD exists and no prototype: `prompt: "Create UI Spec from PRD at [path]. No prototype code available."`
60
+ - If no PRD (medium scale): `prompt: "Create UI Spec based on the following requirements: [pass requirement-analyzer output]. No PRD available."` (add prototype path if provided)
61
+ - Invoke **document-reviewer** to verify UI Spec
62
+ - `subagent_type: "document-reviewer"`, `description: "UI Spec review"`, `prompt: "doc_type: UISpec target: [ui-spec path] Review for consistency and completeness"`
63
+ - **[STOP]**: Present UI Spec for user approval
64
+
65
+ ### Step 3: Design Document Creation Phase
46
66
  Create appropriate design documents according to scale determination:
47
67
  - Invoke **technical-designer-frontend** using Task tool
48
68
  - For ADR: `subagent_type: "technical-designer-frontend"`, `description: "ADR creation"`, `prompt: "Create ADR for [technical decision]"`
49
- - For Design Doc: `subagent_type: "technical-designer-frontend"`, `description: "Design Doc creation"`, `prompt: "Create Design Doc based on requirements"`
69
+ - For Design Doc: `subagent_type: "technical-designer-frontend"`, `description: "Design Doc creation"`, `prompt: "Create Design Doc based on requirements. UI Spec is at [ui-spec path]. Inherit component structure and state design from UI Spec."`
50
70
  - Invoke **document-reviewer** to verify consistency
51
71
  - `subagent_type: "document-reviewer"`, `description: "Document review"`, `prompt: "Review [document path] for consistency and completeness"`
52
72
  - **[STOP]**: Present design alternatives and trade-offs, obtain user approval
53
73
 
54
- **Scope**: Up to frontend design document (ADR/Design Doc) approval. Work planning and beyond are outside the scope of this command.
55
-
56
74
  ## Output Example
57
75
  Frontend design phase completed.
76
+ - UI Specification: docs/ui-spec/[feature-name]-ui-spec.md
58
77
  - Design document: docs/design/[document-name].md or docs/adr/[document-name].md
59
78
  - Approval status: User approved
60
-
61
- **Important**: This command ends with design approval. Does not propose transition to next phase.
@@ -9,6 +9,7 @@ description: Create frontend work plan from design document and obtain plan appr
9
9
  **Role**: Orchestrator
10
10
 
11
11
  **Execution Method**:
12
+ - Test skeleton generation → performed by acceptance-test-generator
12
13
  - Work plan creation → performed by work-planner
13
14
 
14
15
  Orchestrator invokes sub-agents and passes structured JSON between them.
@@ -17,6 +18,7 @@ Orchestrator invokes sub-agents and passes structured JSON between them.
17
18
 
18
19
  **Included in this command**:
19
20
  - Design document selection
21
+ - Test skeleton generation with acceptance-test-generator
20
22
  - Work plan creation with work-planner
21
23
  - Plan approval obtainment
22
24
 
@@ -26,24 +28,30 @@ Create frontend work plan with the following process:
26
28
 
27
29
  ## Execution Process
28
30
 
29
- ### 1. Design Document Selection
31
+ ### Step 1: Design Document Selection
30
32
  ! ls -la docs/design/*.md | head -10
31
33
  - Check for existence of design documents, notify user if none exist
32
34
  - Present options if multiple exist (can be specified with $ARGUMENTS)
33
35
 
34
- ### 2. Work Plan Creation
35
- Invoke **work-planner** using Task tool:
36
- - `subagent_type: "work-planner"`
37
- - `description: "Work plan creation"`
38
- - `prompt: "Create work plan from Design Doc at [path]"`
39
- - Interact with user to complete plan and obtain approval for plan content
36
+ ### Step 2: Test Skeleton Generation
37
+ Invoke acceptance-test-generator using Task tool:
38
+ - `subagent_type`: "acceptance-test-generator"
39
+ - `description`: "Test skeleton generation"
40
+ - If UI Spec exists: `prompt: "Generate test skeletons from Design Doc at [path]. UI Spec at [ui-spec path]."`
41
+ - If no UI Spec: `prompt: "Generate test skeletons from Design Doc at [path]."`
40
42
 
41
- Create a work plan from the selected design document, clarifying specific implementation steps and risks.
43
+ ### Step 3: Work Plan Creation
44
+ Invoke work-planner using Task tool:
45
+ - `subagent_type`: "work-planner"
46
+ - `description`: "Work plan creation"
47
+ - `prompt`: "Create work plan from Design Doc at [path]. Integration test file: [path from step 2]. E2E test file: [path from step 2]. Integration tests are created simultaneously with each phase implementation, E2E tests are executed only in final phase."
48
+
49
+ Interact with user to complete plan and obtain approval for plan content. Clarify specific implementation steps and risks.
42
50
 
43
51
  **Scope**: Up to work plan creation and obtaining approval for plan content.
44
52
 
45
53
  ## Response at Completion
46
- ✅ **Recommended**: End with the following standard response after plan content approval
54
+ End with the following standard response after plan content approval
47
55
  ```
48
56
  Frontend planning phase completed.
49
57
  - Work plan: docs/plans/[plan-name].md
@@ -56,10 +56,10 @@ Execute fixes? (y/n):
56
56
  If user selects `y`:
57
57
 
58
58
  ## Pre-fix Metacognition
59
- **Required**: `rule-advisor -> TodoWrite -> task-executor-frontend -> quality-fixer-frontend`
59
+ **Required**: `rule-advisor -> TaskCreate -> task-executor-frontend -> quality-fixer-frontend`
60
60
 
61
61
  1. **Execute rule-advisor**: Understand fix essence (symptomatic treatment vs root solution)
62
- 2. **Update TodoWrite**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity". Create task file following task template (see documentation-criteria skill) -> `docs/plans/tasks/review-fixes-YYYYMMDD.md`
62
+ 2. **Update with TaskUpdate**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity". Create task file following task template (see documentation-criteria skill) -> `docs/plans/tasks/review-fixes-YYYYMMDD.md`
63
63
  3. **Execute task-executor-frontend**: Staged auto-fixes (stops at 5 files)
64
64
  4. **Execute quality-fixer-frontend**: Confirm quality gate passage
65
65
  5. **Re-validate**: Measure improvement with code-reviewer
@@ -37,13 +37,13 @@ When user responds to questions:
37
37
  - If scale changes → Re-execute requirement-analyzer with updated context
38
38
  - If `confidence: "confirmed"` or no scale change → Proceed to next step
39
39
 
40
- ### 5. After Scale Determination: Register All Flow Steps to TodoWrite (Required)
40
+ ### 5. After Scale Determination: Register All Flow Steps with TaskCreate (Required)
41
41
 
42
- After scale determination, **register all steps of the applicable subagents-orchestration-guide skill flow to TodoWrite**. Always include: first "Confirm skill constraints", final "Verify skill fidelity". After registration, proceed through the flow referencing TodoWrite.
42
+ After scale determination, **register all steps of the applicable subagents-orchestration-guide skill flow with TaskCreate**. Always include: first "Confirm skill constraints", final "Verify skill fidelity". After registration, proceed through the flow referencing TaskList.
43
43
 
44
44
  ### 6. Execute Next Action
45
45
 
46
- **Execute the next pending task in TodoWrite**.
46
+ **Check next pending task with TaskList**.
47
47
 
48
48
  ## 📋 subagents-orchestration-guide skill Compliance Execution
49
49
 
@@ -54,7 +54,7 @@ After scale determination, **register all steps of the applicable subagents-orch
54
54
  - [ ] Recognized stopping points → **Use AskUserQuestion for confirmation at all Stop points**
55
55
  - [ ] Understood the 4-step cycle after task execution (task-executor → escalation judgment/follow-up → quality-fixer → commit)
56
56
 
57
- **Flow Adherence**: Follow "Autonomous Execution Task Management" in subagents-orchestration-guide skill, managing 4 steps with TodoWrite
57
+ **Flow Adherence**: Follow "Autonomous Execution Task Management" in subagents-orchestration-guide skill, managing 4 steps with TaskCreate/TaskUpdate
58
58
 
59
59
  ## 🚨 Sub-agent Invocation Constraints
60
60
 
@@ -65,12 +65,17 @@ Include the following at the end of prompts when invoking sub-agents, as rule-ad
65
65
 
66
66
  ## 🎯 Mandatory Orchestrator Responsibilities
67
67
 
68
- ### Task Execution Flow
69
- Following "Autonomous Execution Task Management" in subagents-orchestration-guide skill, manage these 4 steps with TodoWrite:
70
- 1. task-executor execution (cross-layer: see Layer-Aware Agent Routing)
71
- 2. Escalation judgment and follow-up
72
- 3. quality-fixer execution (cross-layer: see Layer-Aware Agent Routing)
73
- 4. git commit
68
+ ### Task Execution Quality Cycle
69
+ Following "Autonomous Execution Task Management" in subagents-orchestration-guide skill, manage these steps with TaskCreate/TaskUpdate:
70
+ 1. **INVOKE task-executor**: Execute implementation (cross-layer: see Layer-Aware Agent Routing)
71
+ 2. **CHECK task-executor response**:
72
+ - `status: "escalation_needed"` or `"blocked"` → STOP and escalate to user
73
+ - `testsAdded` contains `*.int.test.ts` or `*.e2e.test.ts` → Execute **integration-test-reviewer**
74
+ - `needs_revision` → Return to step 1 with `requiredFixes`
75
+ - `approved` → Proceed to step 3
76
+ - Otherwise → Proceed to step 3
77
+ 3. **INVOKE quality-fixer**: Execute all quality checks and fixes (cross-layer: see Layer-Aware Agent Routing)
78
+ 4. **COMMIT on approval**: After `approved: true` → Execute git commit
74
79
 
75
80
  ### Test Information Communication
76
81
  After acceptance-test-generator execution, when calling work-planner, communicate:
@@ -12,7 +12,7 @@ CLAUDE.md's Session Initialization reads `project-context` skill at the start of
12
12
 
13
13
  ## Execution Process
14
14
 
15
- Register the following steps in TodoWrite and proceed systematically.
15
+ Register the following steps with TaskCreate and proceed systematically.
16
16
 
17
17
  ### Step 1: Understand Current State
18
18
 
@@ -8,7 +8,7 @@ Change request: $ARGUMENTS
8
8
 
9
9
  ## Execution Process
10
10
 
11
- Register the following steps in TodoWrite and proceed systematically.
11
+ Register the following steps with TaskCreate and proceed systematically.
12
12
 
13
13
  ### Step 1: Understand the Request
14
14
 
@@ -15,7 +15,7 @@ Target: $ARGUMENTS
15
15
  2. **Pass structured JSON** between steps using `$STEP_N_OUTPUT` placeholder notation
16
16
  3. **Never investigate code yourself** — all code reading is done by sub-agents
17
17
 
18
- **TodoWrite**: Register phases first, then steps within each phase as you enter it.
18
+ **Task Registration**: Register phases first with TaskCreate, then steps within each phase as you enter it.
19
19
 
20
20
  ## Step 0: Initial Configuration
21
21
 
@@ -50,7 +50,7 @@ Phase 2: Design Doc Generation (if requested)
50
50
 
51
51
  ## Phase 1: PRD Generation
52
52
 
53
- **Register in TodoWrite**:
53
+ **Register with TaskCreate**:
54
54
  - Step 1: PRD Scope Discovery
55
55
  - Per-unit processing (Steps 2-5 for each unit)
56
56
 
@@ -189,7 +189,7 @@ prompt: |
189
189
 
190
190
  *Execute only if Design Docs were requested in Step 0*
191
191
 
192
- **Register in TodoWrite**:
192
+ **Register with TaskCreate**:
193
193
  - Step 6: Design Doc Scope Mapping
194
194
  - Per-unit processing (Steps 7-10 for each unit)
195
195
 
@@ -57,9 +57,9 @@ Execute fixes? (y/n):
57
57
  If user selects `y`:
58
58
 
59
59
  #### Fix Execution Steps
60
- **Required**: `TodoWrite → task-executor → quality-fixer`
60
+ **Required**: `TaskCreate → task-executor → quality-fixer`
61
61
 
62
- 1. **Update TodoWrite**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity". Create task file following task template (see documentation-criteria skill) -> `docs/plans/tasks/review-fixes-YYYYMMDD.md`
62
+ 1. **Update with TaskUpdate**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity". Create task file following task template (see documentation-criteria skill) -> `docs/plans/tasks/review-fixes-YYYYMMDD.md`
63
63
  2. **Execute task-executor**: Staged auto-fixes (stops at 5 files)
64
64
  3. **Execute quality-fixer**: Confirm quality gate passage
65
65
  4. **Re-validate**: Re-validate Design Doc compliance after fixes. Prior compliance issues: $STEP_2_OUTPUT. Verify each prior issue is resolved.
@@ -10,7 +10,7 @@ Not mere consistency maintenance, but rule-advisor selection accuracy enhancemen
10
10
 
11
11
  ## Execution Process
12
12
 
13
- Register the following steps in TodoWrite and proceed systematically.
13
+ Register the following steps with TaskCreate and proceed systematically.
14
14
 
15
15
  ### Step 1: Scan Skill Files
16
16
 
@@ -8,7 +8,7 @@ description: Update existing design documents (Design Doc / PRD / ADR) with revi
8
8
 
9
9
  **Core Identity**: "I am not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
10
10
 
11
- **First Action**: Register Steps 1-6 to TodoWrite before any execution.
11
+ **First Action**: Register Steps 1-6 with TaskCreate before any execution.
12
12
 
13
13
  **Execution Protocol**:
14
14
  1. **Delegate all work** to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
@@ -195,4 +195,4 @@ Document update completed.
195
195
  - Updated document: docs/design/[document-name].md
196
196
  - Approval status: User approved
197
197
 
198
- **Important**: This command ends with document approval. Does not propose transition to next phase.
198
+ **Responsibility Boundary**: This command ends with document approval. Work planning and beyond are outside scope.
@@ -10,7 +10,7 @@ description: Design Docを使用して既存バックエンドコードベース
10
10
 
11
11
  **コアアイデンティティ**: 「私は作業者ではない。オーケストレーターである。」
12
12
 
13
- **初動アクション**: ステップ0-8をTodoWriteに登録してから実行を開始。
13
+ **初動アクション**: ステップ0-8をTaskCreateで登録してから実行を開始。
14
14
 
15
15
  **委譲理由**: オーケストレーターとして、レビュー・品質チェックを含む全てのステップを完遂させるために、必要なコンテキストを維持する必要がある。タスクファイルをコンテキスト境界とし、全ての作業をサブエージェントが担うことでこれを実現する。
16
16