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.
- package/.claude/agents-en/acceptance-test-generator.md +4 -3
- package/.claude/agents-en/code-reviewer.md +2 -2
- package/.claude/agents-en/code-verifier.md +2 -2
- package/.claude/agents-en/design-sync.md +2 -2
- package/.claude/agents-en/document-reviewer.md +4 -4
- package/.claude/agents-en/integration-test-reviewer.md +2 -2
- package/.claude/agents-en/investigator.md +2 -2
- package/.claude/agents-en/prd-creator.md +4 -2
- package/.claude/agents-en/quality-fixer-frontend.md +7 -5
- package/.claude/agents-en/quality-fixer.md +3 -3
- package/.claude/agents-en/requirement-analyzer.md +2 -2
- package/.claude/agents-en/scope-discoverer.md +2 -2
- package/.claude/agents-en/skill-creator.md +2 -2
- package/.claude/agents-en/skill-reviewer.md +2 -2
- package/.claude/agents-en/solver.md +2 -2
- package/.claude/agents-en/task-decomposer.md +2 -2
- package/.claude/agents-en/task-executor-frontend.md +3 -3
- package/.claude/agents-en/task-executor.md +2 -2
- package/.claude/agents-en/technical-designer-frontend.md +17 -6
- package/.claude/agents-en/technical-designer.md +2 -2
- package/.claude/agents-en/ui-spec-designer.md +115 -0
- package/.claude/agents-en/verifier.md +2 -2
- package/.claude/agents-en/work-planner.md +2 -2
- package/.claude/agents-ja/acceptance-test-generator.md +4 -3
- package/.claude/agents-ja/code-reviewer.md +2 -2
- package/.claude/agents-ja/code-verifier.md +2 -2
- package/.claude/agents-ja/design-sync.md +2 -2
- package/.claude/agents-ja/document-reviewer.md +4 -4
- package/.claude/agents-ja/integration-test-reviewer.md +2 -2
- package/.claude/agents-ja/investigator.md +2 -2
- package/.claude/agents-ja/prd-creator.md +4 -2
- package/.claude/agents-ja/quality-fixer-frontend.md +7 -5
- package/.claude/agents-ja/quality-fixer.md +3 -3
- package/.claude/agents-ja/requirement-analyzer.md +2 -2
- package/.claude/agents-ja/scope-discoverer.md +2 -2
- package/.claude/agents-ja/skill-creator.md +2 -2
- package/.claude/agents-ja/skill-reviewer.md +2 -2
- package/.claude/agents-ja/solver.md +2 -2
- package/.claude/agents-ja/task-decomposer.md +2 -2
- package/.claude/agents-ja/task-executor-frontend.md +3 -3
- package/.claude/agents-ja/task-executor.md +2 -2
- package/.claude/agents-ja/technical-designer-frontend.md +17 -6
- package/.claude/agents-ja/technical-designer.md +2 -2
- package/.claude/agents-ja/ui-spec-designer.md +115 -0
- package/.claude/agents-ja/verifier.md +2 -2
- package/.claude/agents-ja/work-planner.md +2 -2
- package/.claude/commands-en/add-integration-tests.md +1 -1
- package/.claude/commands-en/build.md +55 -19
- package/.claude/commands-en/create-skill.md +1 -1
- package/.claude/commands-en/design.md +1 -1
- package/.claude/commands-en/diagnose.md +2 -2
- package/.claude/commands-en/front-build.md +40 -20
- package/.claude/commands-en/front-design.md +25 -8
- package/.claude/commands-en/front-plan.md +17 -9
- package/.claude/commands-en/front-review.md +2 -2
- package/.claude/commands-en/implement.md +15 -10
- package/.claude/commands-en/project-inject.md +1 -1
- package/.claude/commands-en/refine-skill.md +1 -1
- package/.claude/commands-en/reverse-engineer.md +3 -3
- package/.claude/commands-en/review.md +2 -2
- package/.claude/commands-en/sync-skills.md +1 -1
- package/.claude/commands-en/update-doc.md +2 -2
- package/.claude/commands-ja/add-integration-tests.md +1 -1
- package/.claude/commands-ja/build.md +56 -18
- package/.claude/commands-ja/create-skill.md +1 -1
- package/.claude/commands-ja/design.md +1 -1
- package/.claude/commands-ja/diagnose.md +2 -2
- package/.claude/commands-ja/front-build.md +41 -21
- package/.claude/commands-ja/front-design.md +26 -9
- package/.claude/commands-ja/front-plan.md +15 -7
- package/.claude/commands-ja/front-review.md +2 -2
- package/.claude/commands-ja/implement.md +15 -10
- package/.claude/commands-ja/project-inject.md +1 -1
- package/.claude/commands-ja/refine-skill.md +1 -1
- package/.claude/commands-ja/reverse-engineer.md +3 -3
- package/.claude/commands-ja/review.md +2 -2
- package/.claude/commands-ja/sync-skills.md +1 -1
- package/.claude/commands-ja/update-doc.md +2 -2
- package/.claude/skills-en/documentation-criteria/SKILL.md +37 -1
- package/.claude/skills-en/documentation-criteria/references/design-template.md +24 -0
- package/.claude/skills-en/documentation-criteria/references/prd-template.md +10 -0
- package/.claude/skills-en/documentation-criteria/references/ui-spec-template.md +145 -0
- package/.claude/skills-en/{frontend/technical-spec → frontend-technical-spec}/SKILL.md +5 -5
- package/.claude/skills-en/{frontend/typescript-rules → frontend-typescript-rules}/SKILL.md +1 -1
- package/.claude/skills-en/{frontend/typescript-testing → frontend-typescript-testing}/SKILL.md +9 -2
- package/.claude/skills-en/frontend-typescript-testing/references/e2e.md +185 -0
- package/.claude/skills-en/integration-e2e-testing/SKILL.md +4 -0
- package/.claude/skills-en/integration-e2e-testing/references/e2e-design.md +86 -0
- package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +44 -22
- package/.claude/skills-en/task-analyzer/references/skills-index.yaml +15 -11
- package/.claude/skills-en/technical-spec/SKILL.md +5 -4
- package/.claude/skills-ja/documentation-criteria/SKILL.md +37 -1
- package/.claude/skills-ja/documentation-criteria/references/design-template.md +24 -0
- package/.claude/skills-ja/documentation-criteria/references/prd-template.md +10 -0
- package/.claude/skills-ja/documentation-criteria/references/ui-spec-template.md +145 -0
- package/.claude/skills-ja/{frontend/technical-spec → frontend-technical-spec}/SKILL.md +5 -5
- package/.claude/skills-ja/{frontend/typescript-rules → frontend-typescript-rules}/SKILL.md +1 -1
- package/.claude/skills-ja/{frontend/typescript-testing → frontend-typescript-testing}/SKILL.md +2 -2
- package/.claude/skills-ja/frontend-typescript-testing/references/e2e.md +185 -0
- package/.claude/skills-ja/integration-e2e-testing/SKILL.md +4 -0
- package/.claude/skills-ja/integration-e2e-testing/references/e2e-design.md +86 -0
- package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +44 -22
- package/.claude/skills-ja/task-analyzer/references/skills-index.yaml +15 -11
- package/.claude/skills-ja/technical-spec/SKILL.md +5 -4
- package/CHANGELOG.md +67 -0
- package/CLAUDE.en.md +2 -2
- package/CLAUDE.ja.md +2 -2
- package/CLAUDE.md +68 -86
- package/README.ja.md +10 -7
- package/README.md +10 -7
- package/bin/create-project.js +76 -75
- package/biome.json +5 -8
- package/package.json +11 -24
- package/scripts/post-setup.js +54 -57
- package/scripts/set-language.js +107 -112
- package/scripts/setup-project.js +97 -92
- package/scripts/show-coverage.js +36 -22
- package/scripts/update-project.js +205 -201
- package/scripts/utils.js +19 -21
- package/tsconfig.json +3 -3
- package/vitest.config.mjs +2 -2
- package/.tsprunerc +0 -11
- 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,
|
|
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
|
-
|
|
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,
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
|
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 |
|
|
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
|
-
##
|
|
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
|
|
47
|
-
- `prompt`: "Read work plan
|
|
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
|
-
✅ **
|
|
56
|
-
|
|
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
|
-
|
|
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.
|
|
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/
|
|
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
|
|
@@ -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
|
-
**
|
|
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
|
-
**
|
|
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
|
|
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
|
-
**
|
|
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
|
|
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 |
|
|
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
|
|
59
|
-
- `prompt`: "Read work plan
|
|
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. **
|
|
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
|
|
92
|
-
|
|
93
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
35
|
-
Invoke
|
|
36
|
-
- `subagent_type
|
|
37
|
-
- `description
|
|
38
|
-
- `prompt: "
|
|
39
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
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 ->
|
|
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
|
|
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
|
|
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
|
|
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
|
-
**
|
|
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
|
|
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
|
|
69
|
-
Following "Autonomous Execution Task Management" in subagents-orchestration-guide skill, manage these
|
|
70
|
-
1. task-executor
|
|
71
|
-
2.
|
|
72
|
-
|
|
73
|
-
|
|
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
|
|
15
|
+
Register the following steps with TaskCreate and proceed systematically.
|
|
16
16
|
|
|
17
17
|
### Step 1: Understand Current State
|
|
18
18
|
|
|
@@ -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
|
-
**
|
|
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
|
|
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
|
|
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**: `
|
|
60
|
+
**Required**: `TaskCreate → task-executor → quality-fixer`
|
|
61
61
|
|
|
62
|
-
1. **Update
|
|
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
|
|
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
|
|
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
|
-
**
|
|
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を
|
|
13
|
+
**初動アクション**: ステップ0-8をTaskCreateで登録してから実行を開始。
|
|
14
14
|
|
|
15
15
|
**委譲理由**: オーケストレーターとして、レビュー・品質チェックを含む全てのステップを完遂させるために、必要なコンテキストを維持する必要がある。タスクファイルをコンテキスト境界とし、全ての作業をサブエージェントが担うことでこれを実現する。
|
|
16
16
|
|