create-ai-project 1.20.2 → 1.20.4
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 +3 -2
- package/.claude/agents-en/code-reviewer.md +133 -25
- package/.claude/agents-en/codebase-analyzer.md +35 -9
- package/.claude/agents-en/design-sync.md +5 -6
- package/.claude/agents-en/document-reviewer.md +2 -0
- package/.claude/agents-en/integration-test-reviewer.md +2 -2
- package/.claude/agents-en/prd-creator.md +2 -4
- package/.claude/agents-en/quality-fixer-frontend.md +1 -1
- package/.claude/agents-en/quality-fixer.md +1 -1
- package/.claude/agents-en/requirement-analyzer.md +7 -7
- package/.claude/agents-en/scope-discoverer.md +2 -2
- package/.claude/agents-en/solver.md +1 -2
- package/.claude/agents-en/task-decomposer.md +2 -2
- package/.claude/agents-en/task-executor-frontend.md +1 -1
- package/.claude/agents-en/task-executor.md +1 -1
- package/.claude/agents-en/technical-designer-frontend.md +5 -5
- package/.claude/agents-en/technical-designer.md +7 -4
- package/.claude/agents-en/ui-spec-designer.md +1 -1
- package/.claude/agents-en/work-planner.md +1 -1
- package/.claude/agents-ja/acceptance-test-generator.md +3 -2
- package/.claude/agents-ja/code-reviewer.md +133 -25
- package/.claude/agents-ja/codebase-analyzer.md +35 -9
- package/.claude/agents-ja/design-sync.md +5 -5
- package/.claude/agents-ja/document-reviewer.md +2 -0
- package/.claude/agents-ja/integration-test-reviewer.md +2 -2
- package/.claude/agents-ja/prd-creator.md +2 -4
- package/.claude/agents-ja/quality-fixer-frontend.md +1 -1
- package/.claude/agents-ja/quality-fixer.md +1 -1
- package/.claude/agents-ja/requirement-analyzer.md +7 -7
- package/.claude/agents-ja/scope-discoverer.md +2 -2
- package/.claude/agents-ja/solver.md +1 -2
- package/.claude/agents-ja/task-decomposer.md +2 -2
- package/.claude/agents-ja/task-executor-frontend.md +1 -1
- package/.claude/agents-ja/task-executor.md +1 -1
- package/.claude/agents-ja/technical-designer-frontend.md +5 -5
- package/.claude/agents-ja/technical-designer.md +7 -4
- package/.claude/agents-ja/ui-spec-designer.md +1 -1
- package/.claude/agents-ja/work-planner.md +1 -1
- package/.claude/commands-en/build.md +17 -8
- package/.claude/commands-en/front-build.md +25 -41
- package/.claude/commands-en/front-design.md +49 -17
- package/.claude/commands-en/front-plan.md +17 -10
- package/.claude/commands-en/front-review.md +37 -33
- package/.claude/commands-en/review.md +10 -5
- package/.claude/commands-ja/build.md +17 -8
- package/.claude/commands-ja/front-build.md +25 -41
- package/.claude/commands-ja/front-design.md +48 -18
- package/.claude/commands-ja/front-plan.md +22 -15
- package/.claude/commands-ja/front-review.md +37 -33
- package/.claude/commands-ja/review.md +10 -5
- package/.claude/skills-en/coding-standards/references/security-checks.md +4 -2
- package/.claude/skills-en/documentation-criteria/SKILL.md +8 -28
- package/.claude/skills-en/documentation-criteria/references/adr-template.md +5 -1
- package/.claude/skills-en/documentation-criteria/references/design-template.md +18 -8
- package/.claude/skills-en/documentation-criteria/references/plan-template.md +11 -6
- package/.claude/skills-en/documentation-criteria/references/prd-template.md +32 -10
- package/.claude/skills-en/documentation-criteria/references/task-template.md +2 -2
- package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +21 -38
- package/.claude/skills-en/task-analyzer/references/skills-index.yaml +0 -2
- package/.claude/skills-ja/coding-standards/references/security-checks.md +4 -2
- package/.claude/skills-ja/documentation-criteria/SKILL.md +8 -29
- package/.claude/skills-ja/documentation-criteria/references/adr-template.md +5 -1
- package/.claude/skills-ja/documentation-criteria/references/design-template.md +18 -2
- package/.claude/skills-ja/documentation-criteria/references/plan-template.md +11 -6
- package/.claude/skills-ja/documentation-criteria/references/prd-template.md +32 -10
- package/.claude/skills-ja/documentation-criteria/references/task-template.md +2 -2
- package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +21 -36
- package/.claude/skills-ja/task-analyzer/references/skills-index.yaml +0 -2
- package/CHANGELOG.md +57 -0
- package/README.ja.md +51 -30
- package/README.md +58 -34
- package/docs/guides/en/skills-editing-guide.md +10 -0
- package/docs/guides/ja/skills-editing-guide.md +12 -2
- package/package.json +1 -1
|
@@ -79,7 +79,7 @@ documentation-criteriaスキルの計画テンプレートに従って作業計
|
|
|
79
79
|
1. **実行可能な粒度**: 論理的な意味のある1コミット単位、明確な完了条件、依存関係の明示
|
|
80
80
|
2. **品質の組み込み**: テストは同時実装、各タスクに品質チェック組み込み
|
|
81
81
|
3. **リスク管理**: 事前にリスクと対策を列挙、検知方法も定義
|
|
82
|
-
4. **柔軟性の確保**:
|
|
82
|
+
4. **柔軟性の確保**: 本質的な目的を優先し、タスク実行と検証に必要な情報のみを含める
|
|
83
83
|
5. **Design Doc準拠**: 全タスクの完了条件はDesign Docの仕様から導出
|
|
84
84
|
6. **実装方針の一貫性**: 実装サンプルを含める場合は、Design Docの実装方針に完全準拠すること
|
|
85
85
|
|
|
@@ -62,7 +62,7 @@ Invoke task-decomposer using Agent tool:
|
|
|
62
62
|
! ls -la docs/plans/tasks/*.md | head -10
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
**Flow**: Task generation → Autonomous execution (in this order)
|
|
66
66
|
|
|
67
67
|
## Pre-execution Checklist
|
|
68
68
|
|
|
@@ -101,14 +101,23 @@ Autonomous sub-agents require scope constraints for stable execution. ALWAYS app
|
|
|
101
101
|
|
|
102
102
|
After approval confirmation, start autonomous execution mode. STOP IMMEDIATELY upon detecting ANY requirement changes.
|
|
103
103
|
|
|
104
|
-
##
|
|
104
|
+
## Post-Implementation Verification (After All Tasks Complete)
|
|
105
105
|
|
|
106
|
-
After all task cycles finish,
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
|
|
106
|
+
After all task cycles finish, run verification agents **in parallel** before the completion report:
|
|
107
|
+
|
|
108
|
+
1. **Invoke both in parallel** using Agent tool:
|
|
109
|
+
- code-verifier (subagent_type: "code-verifier") → `doc_type: design-doc`, Design Doc path, `code_paths`: implementation file list (`git diff --name-only main...HEAD`)
|
|
110
|
+
- security-reviewer (subagent_type: "security-reviewer") → Design Doc path, implementation file list
|
|
111
|
+
|
|
112
|
+
2. **Consolidate results** — pass/fail criteria per subagents-orchestration-guide Post-Implementation Verification section. Present unified verification report to user.
|
|
113
|
+
|
|
114
|
+
3. **Fix cycle** (when any verifier failed, max 2 cycles):
|
|
115
|
+
- Consolidate all actionable findings into a single task file
|
|
116
|
+
- Execute task-executor with consolidated fixes → quality-fixer
|
|
117
|
+
- Re-run only the failed verifiers
|
|
118
|
+
- If still failing after 2 cycles → Escalate to user with remaining findings
|
|
119
|
+
|
|
120
|
+
4. **All passed** → Proceed to completion report
|
|
112
121
|
|
|
113
122
|
## Output Example
|
|
114
123
|
Implementation phase completed.
|
|
@@ -4,20 +4,13 @@ description: Execute frontend implementation in autonomous execution mode
|
|
|
4
4
|
|
|
5
5
|
## Orchestrator Definition
|
|
6
6
|
|
|
7
|
-
**Core Identity**: "I am
|
|
8
|
-
|
|
9
|
-
**Execution Method**:
|
|
10
|
-
- Task decomposition → performed by task-decomposer
|
|
11
|
-
- Frontend implementation → performed by task-executor-frontend
|
|
12
|
-
- Quality checks and fixes → performed by quality-fixer-frontend
|
|
13
|
-
- Commits → performed by orchestrator (Bash tool)
|
|
14
|
-
|
|
15
|
-
Orchestrator invokes sub-agents and passes structured JSON between them.
|
|
7
|
+
**Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill)
|
|
16
8
|
|
|
17
9
|
**Execution Protocol**:
|
|
18
|
-
1. **Delegate all work through Agent tool** — invoke sub-agents, pass
|
|
10
|
+
1. **Delegate all work through Agent tool** — invoke sub-agents, pass deliverable paths between them, and report results (permitted tools: see subagents-orchestration-guide "Orchestrator's Permitted Tools")
|
|
19
11
|
2. **Follow the 4-step task cycle exactly**: task-executor-frontend → escalation check → quality-fixer-frontend → commit
|
|
20
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
|
|
21
14
|
|
|
22
15
|
**CRITICAL**: Run quality-fixer-frontend before every commit.
|
|
23
16
|
|
|
@@ -69,7 +62,7 @@ Invoke task-decomposer using Agent tool:
|
|
|
69
62
|
! ls -la docs/plans/tasks/*.md | head -10
|
|
70
63
|
```
|
|
71
64
|
|
|
72
|
-
|
|
65
|
+
**Flow**: Task generation → Autonomous execution (in this order)
|
|
73
66
|
|
|
74
67
|
## Pre-execution Checklist
|
|
75
68
|
|
|
@@ -79,40 +72,22 @@ Invoke task-decomposer using Agent tool:
|
|
|
79
72
|
- If commit capability unavailable → Escalate before autonomous mode
|
|
80
73
|
- Other environments (tests, quality tools) → Subagents will escalate
|
|
81
74
|
|
|
82
|
-
## Task Execution Cycle (4-Step Cycle)
|
|
83
|
-
|
|
75
|
+
## Task Execution Cycle (4-Step Cycle)
|
|
84
76
|
**MANDATORY EXECUTION CYCLE**: `task-executor-frontend → escalation check → quality-fixer-frontend → commit`
|
|
85
77
|
|
|
86
|
-
### Sub-agent Invocation Method
|
|
87
|
-
Use Agent tool to invoke sub-agents:
|
|
88
|
-
- `subagent_type`: Agent name
|
|
89
|
-
- `description`: Brief task description (3-5 words)
|
|
90
|
-
- `prompt`: Specific instructions
|
|
91
|
-
|
|
92
|
-
### Structured Response Specification
|
|
93
|
-
Each sub-agent responds in JSON format:
|
|
94
|
-
- **task-executor-frontend**: status, filesModified, testsAdded, requiresTestReview, readyForQualityCheck
|
|
95
|
-
- **integration-test-reviewer**: status (approved/needs_revision/blocked), requiredFixes
|
|
96
|
-
- **quality-fixer-frontend**: status, checksPerformed, fixesApplied, approved
|
|
97
|
-
|
|
98
|
-
### Execution Flow for Each Task
|
|
99
|
-
|
|
100
78
|
For EACH task, YOU MUST:
|
|
101
|
-
|
|
102
79
|
1. **Register tasks using TaskCreate**: Register work steps. Always include: first "Confirm skill constraints", final "Verify skill fidelity"
|
|
103
|
-
2. **
|
|
104
|
-
- Invocation example: `subagent_type: "task-executor-frontend"`, `description: "Task execution"`, `prompt: "Task file: docs/plans/tasks/[filename].md Execute implementation"`
|
|
80
|
+
2. **Agent tool** (subagent_type: "task-executor-frontend") → Pass task file path in prompt, receive structured response
|
|
105
81
|
3. **CHECK task-executor-frontend response**:
|
|
106
82
|
- `status: "escalation_needed"` or `"blocked"` → STOP and escalate to user
|
|
107
83
|
- `requiresTestReview` is `true` → Execute **integration-test-reviewer**
|
|
108
84
|
- `needs_revision` → Return to step 2 with `requiredFixes`
|
|
109
85
|
- `approved` → Proceed to step 4
|
|
110
86
|
- `readyForQualityCheck: true` → Proceed to step 4
|
|
111
|
-
4. **
|
|
112
|
-
|
|
113
|
-
5. **EXECUTE commit**: After `approved: true` confirmation, execute git commit IMMEDIATELY. Use `changeSummary` for commit message.
|
|
87
|
+
4. **INVOKE quality-fixer-frontend**: Execute all quality checks and fixes
|
|
88
|
+
5. **COMMIT on approval**: After `approved: true` from quality-fixer-frontend → Execute git commit
|
|
114
89
|
|
|
115
|
-
**CRITICAL**:
|
|
90
|
+
**CRITICAL**: Parse every sub-agent response for status fields. Execute the matching branch in the 4-step cycle. Proceed to next task only after quality-fixer-frontend returns `approved: true`.
|
|
116
91
|
|
|
117
92
|
## Sub-agent Invocation Constraints
|
|
118
93
|
|
|
@@ -128,14 +103,23 @@ Autonomous sub-agents require scope constraints for stable execution. ALWAYS app
|
|
|
128
103
|
|
|
129
104
|
VERIFY approval status before proceeding. Once confirmed, INITIATE autonomous execution mode. STOP IMMEDIATELY upon detecting ANY requirement changes.
|
|
130
105
|
|
|
131
|
-
##
|
|
106
|
+
## Post-Implementation Verification (After All Tasks Complete)
|
|
107
|
+
|
|
108
|
+
After all task cycles finish, run verification agents **in parallel** before the completion report:
|
|
109
|
+
|
|
110
|
+
1. **Invoke both in parallel** using Agent tool:
|
|
111
|
+
- code-verifier (subagent_type: "code-verifier") → `doc_type: design-doc`, Design Doc path, `code_paths`: implementation file list (`git diff --name-only main...HEAD`)
|
|
112
|
+
- security-reviewer (subagent_type: "security-reviewer") → Design Doc path, implementation file list
|
|
113
|
+
|
|
114
|
+
2. **Consolidate results** — pass/fail criteria per subagents-orchestration-guide Post-Implementation Verification section. Present unified verification report to user.
|
|
115
|
+
|
|
116
|
+
3. **Fix cycle** (when any verifier failed, max 2 cycles):
|
|
117
|
+
- Consolidate all actionable findings into a single task file
|
|
118
|
+
- Execute task-executor-frontend with consolidated fixes → quality-fixer-frontend
|
|
119
|
+
- Re-run only the failed verifiers
|
|
120
|
+
- If still failing after 2 cycles → Escalate to user with remaining findings
|
|
132
121
|
|
|
133
|
-
|
|
134
|
-
1. **Agent tool** (subagent_type: "security-reviewer") → Pass Design Doc path and implementation file list
|
|
135
|
-
2. Check response:
|
|
136
|
-
- `approved` or `approved_with_notes` → Proceed to completion report (include notes if present)
|
|
137
|
-
- `needs_revision` → Execute task-executor-frontend with `requiredFixes`, then quality-fixer-frontend, then re-invoke security-reviewer
|
|
138
|
-
- `blocked` → Escalate to user
|
|
122
|
+
4. **All passed** → Proceed to completion report
|
|
139
123
|
|
|
140
124
|
## Output Example
|
|
141
125
|
Frontend implementation phase completed.
|
|
@@ -6,26 +6,42 @@ description: Execute from requirement analysis to frontend design document creat
|
|
|
6
6
|
|
|
7
7
|
## Orchestrator Definition
|
|
8
8
|
|
|
9
|
-
**
|
|
10
|
-
|
|
11
|
-
**Execution
|
|
12
|
-
-
|
|
13
|
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
|
|
9
|
+
**Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill)
|
|
10
|
+
|
|
11
|
+
**Execution Protocol**:
|
|
12
|
+
1. **Delegate all work** to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
|
|
13
|
+
2. **Follow the frontend design flow below** (this command covers medium/large frontend; UI Spec is created before codebase analysis so that component structure informs the technical design):
|
|
14
|
+
- Execute: requirement-analyzer → ui-spec-designer → codebase-analyzer → technical-designer-frontend → code-verifier → document-reviewer → design-sync
|
|
15
|
+
- **Stop at every `[Stop: ...]` marker** → Wait for user approval before proceeding
|
|
16
|
+
3. **Scope**: Complete when design documents receive approval
|
|
17
|
+
|
|
18
|
+
**CRITICAL**: Execute document-reviewer, design-sync, and all stopping points defined in subagents-orchestration-guide skill flows — each serves as a quality gate. Skipping any step risks undetected inconsistencies.
|
|
19
|
+
|
|
20
|
+
## Workflow Overview
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
Requirements → requirement-analyzer → [Stop: Scale determination]
|
|
24
|
+
↓
|
|
25
|
+
ui-spec-designer → [Stop: UI Spec approval]
|
|
26
|
+
↓
|
|
27
|
+
codebase-analyzer → technical-designer-frontend
|
|
28
|
+
↓
|
|
29
|
+
code-verifier → document-reviewer
|
|
30
|
+
↓
|
|
31
|
+
design-sync → [Stop: Design approval]
|
|
32
|
+
```
|
|
18
33
|
|
|
19
34
|
## Scope Boundaries
|
|
20
35
|
|
|
21
36
|
**Included in this command**:
|
|
22
37
|
- Requirement analysis with requirement-analyzer
|
|
23
|
-
- Codebase analysis with codebase-analyzer (before
|
|
38
|
+
- Codebase analysis with codebase-analyzer (before technical design)
|
|
24
39
|
- UI Specification creation with ui-spec-designer (prototype code inquiry included)
|
|
25
40
|
- ADR creation (if architecture changes, new technology, or data flow changes)
|
|
26
41
|
- Design Doc creation with technical-designer-frontend
|
|
27
42
|
- Design Doc verification with code-verifier (before document review)
|
|
28
43
|
- Document review with document-reviewer
|
|
44
|
+
- Design Doc consistency verification with design-sync
|
|
29
45
|
|
|
30
46
|
**Responsibility Boundary**: This command completes with frontend design document (UI Spec/ADR/Design Doc) approval. Work planning and beyond are outside scope.
|
|
31
47
|
|
|
@@ -39,7 +55,8 @@ Considering the deep impact on design, first engage in dialogue to understand th
|
|
|
39
55
|
- Expected outcomes and success criteria
|
|
40
56
|
- Relationship with existing systems
|
|
41
57
|
|
|
42
|
-
Once
|
|
58
|
+
Once the user has answered the three dialogue questions above, execute the process below within design scope. Follow subagents-orchestration-guide Call Examples for codebase-analyzer and code-verifier invocations.
|
|
59
|
+
|
|
43
60
|
- Invoke **requirement-analyzer** using Agent tool
|
|
44
61
|
- `subagent_type: "requirement-analyzer"`
|
|
45
62
|
- `description: "Requirement analysis"`
|
|
@@ -69,15 +86,30 @@ First, analyze the existing codebase:
|
|
|
69
86
|
- Invoke **codebase-analyzer** using Agent tool
|
|
70
87
|
- `subagent_type: "codebase-analyzer"`, `description: "Codebase analysis"`, `prompt: "requirement_analysis: [JSON from Step 1]. requirements: [user requirements]. Analyze existing codebase for frontend design guidance."`
|
|
71
88
|
|
|
72
|
-
Create appropriate design documents according to scale determination:
|
|
89
|
+
Create appropriate design documents according to scale determination. technical-designer-frontend presents at least two architecture alternatives (technology selection, data flow design) with trade-offs for each:
|
|
73
90
|
- Invoke **technical-designer-frontend** using Agent tool
|
|
74
|
-
- For ADR: `subagent_type: "technical-designer-frontend"`, `description: "ADR creation"`, `prompt: "Create ADR for [technical decision]"`
|
|
75
|
-
- For Design Doc: `subagent_type: "technical-designer-frontend"`, `description: "Design Doc creation"`, `prompt: "Create Design Doc based on requirements. Codebase analysis: [JSON from codebase-analyzer]. UI Spec is at [ui-spec path]. Inherit component structure and state design from UI Spec."`
|
|
91
|
+
- For ADR: `subagent_type: "technical-designer-frontend"`, `description: "ADR creation"`, `prompt: "Create ADR for [technical decision]. Present at least two alternatives with trade-offs."`
|
|
92
|
+
- For Design Doc: `subagent_type: "technical-designer-frontend"`, `description: "Design Doc creation"`, `prompt: "Create Design Doc based on requirements. Codebase analysis: [JSON from codebase-analyzer]. UI Spec is at [ui-spec path]. Inherit component structure and state design from UI Spec. Present at least two architecture alternatives with trade-offs."`
|
|
76
93
|
- **(Design Doc only)** Invoke **code-verifier** to verify Design Doc against existing code. Skip for ADR.
|
|
77
|
-
- `subagent_type: "code-verifier"`, `description: "Design Doc verification"`, `prompt: "doc_type: design-doc document_path: [Design Doc path] Verify Design Doc against existing code."`
|
|
94
|
+
- `subagent_type: "code-verifier"`, `description: "Design Doc verification"`, `prompt: "doc_type: design-doc document_path: [Design Doc path] mode: pre-implementation (code_paths omitted — verifier discovers scope from document). Verify Design Doc against existing code."`
|
|
78
95
|
- Invoke **document-reviewer** to verify consistency (pass code-verifier results for Design Doc; omit for ADR)
|
|
79
|
-
- `subagent_type: "document-reviewer"`, `description: "Document review"`, `prompt: "doc_type: DesignDoc target: [document path] mode: composite code_verification: [JSON from code-verifier] (Design Doc only) Review for consistency and completeness."`
|
|
80
|
-
|
|
96
|
+
- `subagent_type: "document-reviewer"`, `description: "Document review"`, `prompt: "doc_type: DesignDoc target: [document path] mode: composite code_verification: [JSON from code-verifier] (Design Doc only). Review for consistency and completeness."`
|
|
97
|
+
|
|
98
|
+
### Step 4: Design Consistency Verification
|
|
99
|
+
- Invoke **design-sync** using Agent tool
|
|
100
|
+
- `subagent_type: "design-sync"`, `description: "Design consistency check"`, `prompt: "Check consistency across all Design Docs in docs/design/. Report conflicts and overlaps."`
|
|
101
|
+
- **[STOP]**: Present design documents and design-sync results, obtain user approval
|
|
102
|
+
|
|
103
|
+
## Completion Criteria
|
|
104
|
+
|
|
105
|
+
- [ ] Executed requirement-analyzer and determined scale
|
|
106
|
+
- [ ] Executed codebase-analyzer and passed results to technical-designer-frontend
|
|
107
|
+
- [ ] Created UI Specification with ui-spec-designer (when applicable)
|
|
108
|
+
- [ ] Created appropriate design document (ADR or Design Doc) with technical-designer-frontend
|
|
109
|
+
- [ ] Executed code-verifier on Design Doc and passed results to document-reviewer (skip for ADR-only)
|
|
110
|
+
- [ ] Executed document-reviewer and addressed feedback
|
|
111
|
+
- [ ] Executed design-sync for consistency verification
|
|
112
|
+
- [ ] Obtained user approval for design document
|
|
81
113
|
|
|
82
114
|
## Output Example
|
|
83
115
|
Frontend design phase completed.
|
|
@@ -6,13 +6,16 @@ description: Create frontend work plan from design document and obtain plan appr
|
|
|
6
6
|
|
|
7
7
|
## Orchestrator Definition
|
|
8
8
|
|
|
9
|
-
**
|
|
9
|
+
**Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill)
|
|
10
10
|
|
|
11
|
-
**Execution
|
|
12
|
-
-
|
|
13
|
-
|
|
11
|
+
**Execution Protocol**:
|
|
12
|
+
1. **Delegate all work** to sub-agents — your role is to invoke sub-agents, pass data between them, and report results
|
|
13
|
+
2. **Follow subagents-orchestration-guide skill planning flow**:
|
|
14
|
+
- Execute steps defined below
|
|
15
|
+
- **Stop and obtain approval** for plan content before completion
|
|
16
|
+
3. **Scope**: See Scope Boundaries below
|
|
14
17
|
|
|
15
|
-
|
|
18
|
+
**CRITICAL**: Always execute acceptance-test-generator before work-planner — the test skeleton is a required input per subagents-orchestration-guide medium/large flow.
|
|
16
19
|
|
|
17
20
|
## Scope Boundaries
|
|
18
21
|
|
|
@@ -24,14 +27,14 @@ Orchestrator invokes sub-agents and passes structured JSON between them.
|
|
|
24
27
|
|
|
25
28
|
**Responsibility Boundary**: This command completes with work plan approval.
|
|
26
29
|
|
|
27
|
-
|
|
30
|
+
Follow the planning process below:
|
|
28
31
|
|
|
29
32
|
## Execution Process
|
|
30
33
|
|
|
31
34
|
### Step 1: Design Document Selection
|
|
32
|
-
! ls -la docs/design/*.md | head -10
|
|
33
|
-
- Check for existence of design documents, notify user if none exist
|
|
34
|
-
- Present options if multiple exist (can be specified with $ARGUMENTS)
|
|
35
|
+
! ls -la docs/design/*.md | head -10
|
|
36
|
+
- Check for existence of design documents, notify user if none exist
|
|
37
|
+
- Present options if multiple exist (can be specified with $ARGUMENTS)
|
|
35
38
|
|
|
36
39
|
### Step 2: Test Skeleton Generation
|
|
37
40
|
Invoke acceptance-test-generator using Agent tool:
|
|
@@ -40,13 +43,17 @@ Invoke acceptance-test-generator using Agent tool:
|
|
|
40
43
|
- If UI Spec exists: `prompt: "Generate test skeletons from Design Doc at [path]. UI Spec at [ui-spec path]."`
|
|
41
44
|
- If no UI Spec: `prompt: "Generate test skeletons from Design Doc at [path]."`
|
|
42
45
|
|
|
46
|
+
Pass integration test file path and E2E test file path to work-planner according to subagents-orchestration-guide "acceptance-test-generator → work-planner" section.
|
|
47
|
+
|
|
43
48
|
### Step 3: Work Plan Creation
|
|
44
49
|
Invoke work-planner using Agent tool:
|
|
45
50
|
- `subagent_type`: "work-planner"
|
|
46
51
|
- `description`: "Work plan creation"
|
|
47
52
|
- `prompt`: "Create work plan from Design Doc at [path]. Integration test file: [integration test path from step 2]. E2E test file: [E2E test path from step 2]. Integration tests are created simultaneously with each phase implementation, E2E tests are executed only in final phase."
|
|
48
53
|
|
|
49
|
-
|
|
54
|
+
- Follow subagents-orchestration-guide Prompt Construction Rule for additional prompt parameters
|
|
55
|
+
- Present work plan to user for review. If user requests changes, re-invoke work-planner with revised parameters
|
|
56
|
+
- Highlight steps with unclear scope or external dependencies and ask user to confirm
|
|
50
57
|
|
|
51
58
|
**Scope**: Up to work plan creation and obtaining approval for plan content.
|
|
52
59
|
|
|
@@ -4,24 +4,25 @@ description: Design Doc compliance and security validation with optional auto-fi
|
|
|
4
4
|
|
|
5
5
|
**Command Context**: Post-implementation quality assurance command for React/TypeScript frontend
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Orchestrator Definition
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
- Security validation -> performed by security-reviewer
|
|
11
|
-
- Rule analysis -> performed by rule-advisor
|
|
12
|
-
- Fix implementation -> performed by task-executor-frontend
|
|
13
|
-
- Quality checks -> performed by quality-fixer-frontend
|
|
14
|
-
- Re-validation -> performed by code-reviewer / security-reviewer
|
|
9
|
+
**Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill)
|
|
15
10
|
|
|
16
|
-
|
|
11
|
+
**First Action**: Register Steps 1-11 using TaskCreate before any execution.
|
|
17
12
|
|
|
18
|
-
|
|
13
|
+
## Execution Method
|
|
14
|
+
|
|
15
|
+
- Compliance validation → performed by code-reviewer
|
|
16
|
+
- Security validation → performed by security-reviewer
|
|
17
|
+
- Fix implementation → performed by task-executor-frontend
|
|
18
|
+
- Quality checks → performed by quality-fixer-frontend
|
|
19
|
+
- Re-validation → performed by code-reviewer / security-reviewer
|
|
19
20
|
|
|
20
|
-
|
|
21
|
+
Design Doc (uses most recent if omitted): $ARGUMENTS
|
|
21
22
|
|
|
22
23
|
## Execution Flow
|
|
23
24
|
|
|
24
|
-
### 1
|
|
25
|
+
### Step 1: Prerequisite Check
|
|
25
26
|
```bash
|
|
26
27
|
# Identify Design Doc
|
|
27
28
|
ls docs/design/*.md | grep -v template | tail -1
|
|
@@ -30,15 +31,15 @@ ls docs/design/*.md | grep -v template | tail -1
|
|
|
30
31
|
git diff --name-only main...HEAD
|
|
31
32
|
```
|
|
32
33
|
|
|
33
|
-
### 2
|
|
34
|
+
### Step 2: Execute code-reviewer
|
|
34
35
|
Invoke code-reviewer using Agent tool:
|
|
35
36
|
- `subagent_type`: "code-reviewer"
|
|
36
37
|
- `description`: "Code compliance review"
|
|
37
|
-
- `prompt`: "Design Doc: [path]. Implementation files: [git diff file list]. Review mode: full. Validate Design Doc compliance and return structured JSON report
|
|
38
|
+
- `prompt`: "Design Doc: [path]. Implementation files: [git diff file list]. Review mode: full. Validate Design Doc compliance and return structured JSON report."
|
|
38
39
|
|
|
39
40
|
**Store output as**: `$STEP_2_OUTPUT`
|
|
40
41
|
|
|
41
|
-
### 3
|
|
42
|
+
### Step 3: Execute security-reviewer
|
|
42
43
|
Invoke security-reviewer using Agent tool:
|
|
43
44
|
- `subagent_type`: "security-reviewer"
|
|
44
45
|
- `description`: "Security review"
|
|
@@ -46,7 +47,7 @@ Invoke security-reviewer using Agent tool:
|
|
|
46
47
|
|
|
47
48
|
**Store output as**: `$STEP_3_OUTPUT`
|
|
48
49
|
|
|
49
|
-
### 4
|
|
50
|
+
### Step 4: Verdict and Response
|
|
50
51
|
|
|
51
52
|
**If security-reviewer returned `blocked`**: Stop immediately. Report the blocked finding and escalate to user. Do not proceed to fix steps.
|
|
52
53
|
|
|
@@ -63,10 +64,15 @@ Invoke security-reviewer using Agent tool:
|
|
|
63
64
|
```
|
|
64
65
|
Code Compliance: [complianceRate from code-reviewer]
|
|
65
66
|
Verdict: [verdict from code-reviewer]
|
|
67
|
+
Identifier Match Rate: [identifierMatchRate from code-reviewer]
|
|
66
68
|
Acceptance Criteria:
|
|
67
|
-
- [fulfilled] [item]
|
|
69
|
+
- [fulfilled] [item] (confidence: [high/medium/low])
|
|
68
70
|
- [partially_fulfilled] [item]: [gap] — [suggestion]
|
|
69
71
|
- [unfulfilled] [item]: [gap] — [suggestion]
|
|
72
|
+
Identifier Mismatches:
|
|
73
|
+
- [identifier]: DD=[designDocValue] Code=[codeValue] at [location]
|
|
74
|
+
Quality Findings:
|
|
75
|
+
- [category] [location]: [description] — [rationale]
|
|
70
76
|
|
|
71
77
|
Security Review: [status from security-reviewer]
|
|
72
78
|
Findings by category:
|
|
@@ -79,46 +85,44 @@ Security Review: [status from security-reviewer]
|
|
|
79
85
|
Execute fixes? (y/n):
|
|
80
86
|
```
|
|
81
87
|
|
|
82
|
-
If both pass and user selects `n`: Skip
|
|
88
|
+
If both pass and user selects `n`: Skip Steps 5-10, proceed to Step 11.
|
|
83
89
|
|
|
84
|
-
|
|
90
|
+
### Step 5: Load Task Template
|
|
85
91
|
|
|
86
|
-
|
|
92
|
+
Read documentation-criteria skill to obtain the task file template (references/task-template.md) for Step 6.
|
|
87
93
|
|
|
88
|
-
###
|
|
89
|
-
Invoke rule-advisor using Agent tool:
|
|
90
|
-
- `subagent_type`: "rule-advisor"
|
|
91
|
-
- `description`: "Analyze fix approach"
|
|
92
|
-
- `prompt`: "Task: Fix review findings. Code issues: $STEP_2_OUTPUT. Security findings: $STEP_3_OUTPUT. Analyze fix essence and select appropriate rules."
|
|
94
|
+
### Step 6: Create Task File
|
|
93
95
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
+
Create task file at `docs/plans/tasks/review-fixes-YYYYMMDD.md`
|
|
97
|
+
Include both code compliance issues and security requiredFixes.
|
|
96
98
|
|
|
97
|
-
### 7
|
|
99
|
+
### Step 7: Execute Fixes
|
|
98
100
|
Invoke task-executor-frontend using Agent tool:
|
|
99
101
|
- `subagent_type`: "task-executor-frontend"
|
|
100
102
|
- `description`: "Execute review fixes"
|
|
101
103
|
- `prompt`: "Task file: docs/plans/tasks/review-fixes-YYYYMMDD.md. Apply staged fixes (stops at 5 files)."
|
|
102
104
|
|
|
103
|
-
### 8
|
|
105
|
+
### Step 8: Quality Check
|
|
104
106
|
Invoke quality-fixer-frontend using Agent tool:
|
|
105
107
|
- `subagent_type`: "quality-fixer-frontend"
|
|
106
108
|
- `description`: "Quality gate check"
|
|
107
109
|
- `prompt`: "Confirm quality gate passage for fixed files."
|
|
108
110
|
|
|
109
|
-
### 9
|
|
111
|
+
### Step 9: Re-validate code-reviewer
|
|
112
|
+
|
|
110
113
|
Invoke code-reviewer using Agent tool:
|
|
111
114
|
- `subagent_type`: "code-reviewer"
|
|
112
115
|
- `description`: "Re-validate compliance"
|
|
113
|
-
- `prompt`: "Re-validate Design Doc compliance after fixes.
|
|
116
|
+
- `prompt`: "Re-validate Design Doc compliance after fixes. Design Doc: [path]. Implementation files: [file list]. Prior compliance issues: $STEP_2_OUTPUT. Verify each prior issue is resolved."
|
|
114
117
|
|
|
115
|
-
### 10
|
|
116
|
-
|
|
118
|
+
### Step 10: Re-validate security-reviewer
|
|
119
|
+
|
|
120
|
+
Invoke security-reviewer using Agent tool (only if security fixes were applied):
|
|
117
121
|
- `subagent_type`: "security-reviewer"
|
|
118
122
|
- `description`: "Re-validate security"
|
|
119
123
|
- `prompt`: "Re-validate security after fixes. Prior findings: $STEP_3_OUTPUT. Design Doc: [path]. Implementation files: [file list]."
|
|
120
124
|
|
|
121
|
-
### Final Report
|
|
125
|
+
### Step 11: Final Report
|
|
122
126
|
```
|
|
123
127
|
Code Compliance:
|
|
124
128
|
Initial: [X]%
|
|
@@ -33,7 +33,7 @@ git diff --name-only main...HEAD
|
|
|
33
33
|
Invoke code-reviewer using Agent tool:
|
|
34
34
|
- `subagent_type`: "code-reviewer"
|
|
35
35
|
- `description`: "Code compliance review"
|
|
36
|
-
- `prompt`: "Design Doc: [path]. Implementation files: [git diff file list]. Review mode: full. Validate Design Doc compliance and return structured JSON report
|
|
36
|
+
- `prompt`: "Design Doc: [path]. Implementation files: [git diff file list]. Review mode: full. Validate Design Doc compliance and return structured JSON report."
|
|
37
37
|
|
|
38
38
|
**Store output as**: `$STEP_2_OUTPUT`
|
|
39
39
|
|
|
@@ -62,10 +62,15 @@ Invoke security-reviewer using Agent tool:
|
|
|
62
62
|
```
|
|
63
63
|
Code Compliance: [complianceRate from code-reviewer]
|
|
64
64
|
Verdict: [verdict from code-reviewer]
|
|
65
|
+
Identifier Match Rate: [identifierMatchRate from code-reviewer]
|
|
65
66
|
Acceptance Criteria:
|
|
66
|
-
- [fulfilled] [item]
|
|
67
|
+
- [fulfilled] [item] (confidence: [high/medium/low])
|
|
67
68
|
- [partially_fulfilled] [item]: [gap] — [suggestion]
|
|
68
69
|
- [unfulfilled] [item]: [gap] — [suggestion]
|
|
70
|
+
Identifier Mismatches:
|
|
71
|
+
- [identifier]: DD=[designDocValue] Code=[codeValue] at [location]
|
|
72
|
+
Quality Findings:
|
|
73
|
+
- [category] [location]: [description] — [rationale]
|
|
69
74
|
|
|
70
75
|
Security Review: [status from security-reviewer]
|
|
71
76
|
Findings by category:
|
|
@@ -80,9 +85,9 @@ Execute fixes? (y/n):
|
|
|
80
85
|
|
|
81
86
|
If both pass and user selects `n`: Skip Steps 5-10, proceed to Step 11.
|
|
82
87
|
|
|
83
|
-
### 5.
|
|
88
|
+
### 5. Load Task Template
|
|
84
89
|
|
|
85
|
-
|
|
90
|
+
Read documentation-criteria skill to obtain the task file template (references/task-template.md) for Step 6.
|
|
86
91
|
|
|
87
92
|
### 6. Create Task File
|
|
88
93
|
|
|
@@ -108,7 +113,7 @@ Invoke quality-fixer using Agent tool:
|
|
|
108
113
|
Invoke code-reviewer using Agent tool:
|
|
109
114
|
- `subagent_type`: "code-reviewer"
|
|
110
115
|
- `description`: "Re-validate compliance"
|
|
111
|
-
- `prompt`: "Re-validate Design Doc compliance after fixes. Prior compliance issues: $STEP_2_OUTPUT. Verify each prior issue is resolved."
|
|
116
|
+
- `prompt`: "Re-validate Design Doc compliance after fixes. Design Doc: [path]. Implementation files: [file list]. Prior compliance issues: $STEP_2_OUTPUT. Verify each prior issue is resolved."
|
|
112
117
|
|
|
113
118
|
### 10. Re-validate security-reviewer
|
|
114
119
|
|
|
@@ -62,7 +62,7 @@ Agentツールでtask-decomposerを呼び出す:
|
|
|
62
62
|
! ls -la docs/plans/tasks/*.md | head -10
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
**フロー**: タスク生成 → 自律実行(この順序で実行)
|
|
66
66
|
|
|
67
67
|
## 実行前チェックリスト
|
|
68
68
|
|
|
@@ -101,14 +101,23 @@ Agentツールでtask-decomposerを呼び出す:
|
|
|
101
101
|
|
|
102
102
|
承認確認後、自律実行モードを開始。要件変更を検知した場合は即座に停止。
|
|
103
103
|
|
|
104
|
-
##
|
|
104
|
+
## 実装後検証(全タスク完了後)
|
|
105
105
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
|
|
106
|
+
全タスクサイクル完了後、完了レポートの前に検証エージェントを**並列実行**:
|
|
107
|
+
|
|
108
|
+
1. **両方を並列で実行** (Agent tool):
|
|
109
|
+
- code-verifier (subagent_type: "code-verifier") → `doc_type: design-doc`、Design Docパス、`code_paths`: 実装ファイルリスト(`git diff --name-only main...HEAD`)
|
|
110
|
+
- security-reviewer (subagent_type: "security-reviewer") → Design Docパス、実装ファイルリスト
|
|
111
|
+
|
|
112
|
+
2. **結果の統合** — 合格/不合格の基準はsubagents-orchestration-guideの実装後検証セクション参照。統合検証レポートをユーザーに提示。
|
|
113
|
+
|
|
114
|
+
3. **修正サイクル**(いずれかの検証エージェントが不合格の場合、最大2回):
|
|
115
|
+
- 全ての対応可能な検出事項を1つのタスクファイルに統合
|
|
116
|
+
- task-executorで統合修正を実行 → quality-fixer
|
|
117
|
+
- 不合格の検証エージェントのみ再実行
|
|
118
|
+
- 2回のサイクル後も不合格が残る場合 → 残存する検出事項とともにユーザーにエスカレーション
|
|
119
|
+
|
|
120
|
+
4. **全て合格** → 完了レポートへ
|
|
112
121
|
|
|
113
122
|
## 出力例
|
|
114
123
|
実装フェーズが完了しました。
|