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.
Files changed (74) hide show
  1. package/.claude/agents-en/acceptance-test-generator.md +3 -2
  2. package/.claude/agents-en/code-reviewer.md +133 -25
  3. package/.claude/agents-en/codebase-analyzer.md +35 -9
  4. package/.claude/agents-en/design-sync.md +5 -6
  5. package/.claude/agents-en/document-reviewer.md +2 -0
  6. package/.claude/agents-en/integration-test-reviewer.md +2 -2
  7. package/.claude/agents-en/prd-creator.md +2 -4
  8. package/.claude/agents-en/quality-fixer-frontend.md +1 -1
  9. package/.claude/agents-en/quality-fixer.md +1 -1
  10. package/.claude/agents-en/requirement-analyzer.md +7 -7
  11. package/.claude/agents-en/scope-discoverer.md +2 -2
  12. package/.claude/agents-en/solver.md +1 -2
  13. package/.claude/agents-en/task-decomposer.md +2 -2
  14. package/.claude/agents-en/task-executor-frontend.md +1 -1
  15. package/.claude/agents-en/task-executor.md +1 -1
  16. package/.claude/agents-en/technical-designer-frontend.md +5 -5
  17. package/.claude/agents-en/technical-designer.md +7 -4
  18. package/.claude/agents-en/ui-spec-designer.md +1 -1
  19. package/.claude/agents-en/work-planner.md +1 -1
  20. package/.claude/agents-ja/acceptance-test-generator.md +3 -2
  21. package/.claude/agents-ja/code-reviewer.md +133 -25
  22. package/.claude/agents-ja/codebase-analyzer.md +35 -9
  23. package/.claude/agents-ja/design-sync.md +5 -5
  24. package/.claude/agents-ja/document-reviewer.md +2 -0
  25. package/.claude/agents-ja/integration-test-reviewer.md +2 -2
  26. package/.claude/agents-ja/prd-creator.md +2 -4
  27. package/.claude/agents-ja/quality-fixer-frontend.md +1 -1
  28. package/.claude/agents-ja/quality-fixer.md +1 -1
  29. package/.claude/agents-ja/requirement-analyzer.md +7 -7
  30. package/.claude/agents-ja/scope-discoverer.md +2 -2
  31. package/.claude/agents-ja/solver.md +1 -2
  32. package/.claude/agents-ja/task-decomposer.md +2 -2
  33. package/.claude/agents-ja/task-executor-frontend.md +1 -1
  34. package/.claude/agents-ja/task-executor.md +1 -1
  35. package/.claude/agents-ja/technical-designer-frontend.md +5 -5
  36. package/.claude/agents-ja/technical-designer.md +7 -4
  37. package/.claude/agents-ja/ui-spec-designer.md +1 -1
  38. package/.claude/agents-ja/work-planner.md +1 -1
  39. package/.claude/commands-en/build.md +17 -8
  40. package/.claude/commands-en/front-build.md +25 -41
  41. package/.claude/commands-en/front-design.md +49 -17
  42. package/.claude/commands-en/front-plan.md +17 -10
  43. package/.claude/commands-en/front-review.md +37 -33
  44. package/.claude/commands-en/review.md +10 -5
  45. package/.claude/commands-ja/build.md +17 -8
  46. package/.claude/commands-ja/front-build.md +25 -41
  47. package/.claude/commands-ja/front-design.md +48 -18
  48. package/.claude/commands-ja/front-plan.md +22 -15
  49. package/.claude/commands-ja/front-review.md +37 -33
  50. package/.claude/commands-ja/review.md +10 -5
  51. package/.claude/skills-en/coding-standards/references/security-checks.md +4 -2
  52. package/.claude/skills-en/documentation-criteria/SKILL.md +8 -28
  53. package/.claude/skills-en/documentation-criteria/references/adr-template.md +5 -1
  54. package/.claude/skills-en/documentation-criteria/references/design-template.md +18 -8
  55. package/.claude/skills-en/documentation-criteria/references/plan-template.md +11 -6
  56. package/.claude/skills-en/documentation-criteria/references/prd-template.md +32 -10
  57. package/.claude/skills-en/documentation-criteria/references/task-template.md +2 -2
  58. package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +21 -38
  59. package/.claude/skills-en/task-analyzer/references/skills-index.yaml +0 -2
  60. package/.claude/skills-ja/coding-standards/references/security-checks.md +4 -2
  61. package/.claude/skills-ja/documentation-criteria/SKILL.md +8 -29
  62. package/.claude/skills-ja/documentation-criteria/references/adr-template.md +5 -1
  63. package/.claude/skills-ja/documentation-criteria/references/design-template.md +18 -2
  64. package/.claude/skills-ja/documentation-criteria/references/plan-template.md +11 -6
  65. package/.claude/skills-ja/documentation-criteria/references/prd-template.md +32 -10
  66. package/.claude/skills-ja/documentation-criteria/references/task-template.md +2 -2
  67. package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +21 -36
  68. package/.claude/skills-ja/task-analyzer/references/skills-index.yaml +0 -2
  69. package/CHANGELOG.md +57 -0
  70. package/README.ja.md +51 -30
  71. package/README.md +58 -34
  72. package/docs/guides/en/skills-editing-guide.md +10 -0
  73. package/docs/guides/ja/skills-editing-guide.md +12 -2
  74. package/package.json +1 -1
@@ -104,7 +104,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
104
104
  - [ ] プロトタイプ提供時: ACトレーサビリティ表が採用判定付きで完成している
105
105
  - [ ] プロトタイプ提供時: プロトタイプが`docs/ui-spec/assets/`に配置されている
106
106
  - [ ] 未確定事項の全TBDに担当者と期限がある
107
- - [ ] PRD要件との矛盾がない
107
+ - [ ] UI Specの全要件がPRD要件と整合している
108
108
 
109
109
  ## 重要な設計原則
110
110
 
@@ -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
- **Flow**: Task generation → Autonomous execution (in this order)
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
- ## Security Review (After All Tasks Complete)
104
+ ## Post-Implementation Verification (After All Tasks Complete)
105
105
 
106
- After all task cycles finish, invoke security-reviewer before the completion report:
107
- 1. **Agent tool** (subagent_type: "security-reviewer") → Pass Design Doc path and implementation file list
108
- 2. Check response:
109
- - `approved` or `approved_with_notes`Proceed to completion report (include notes if present)
110
- - `needs_revision` Execute task-executor with `requiredFixes`, then quality-fixer, then re-invoke security-reviewer
111
- - `blocked` → Escalate to user
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 not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
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 data between them, and report results (permitted tools: see subagents-orchestration-guide "Orchestrator's Permitted Tools")
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
- **Flow**: Task generation → Autonomous execution (in this order)
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) - Frontend Specialized
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. **USE task-executor-frontend**: Execute frontend implementation
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. **USE quality-fixer-frontend**: Execute all quality checks and fixes
112
- - Invocation example: `subagent_type: "quality-fixer-frontend"`, `description: "Quality check"`, `prompt: "Execute all frontend quality checks and fixes"`
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**: Monitor ALL structured responses WITHOUT EXCEPTION and ENSURE every quality gate is passed.
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
- ## Security Review (After All Tasks Complete)
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
- After all task cycles finish, invoke security-reviewer before the completion report:
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
- **Role**: Orchestrator
10
-
11
- **Execution Method**:
12
- - Requirement analysis performed by requirement-analyzer
13
- - UI Specification creation performed by ui-spec-designer
14
- - Design document creationperformed by technical-designer-frontend
15
- - Document reviewperformed by document-reviewer
16
-
17
- Orchestrator invokes sub-agents and passes structured JSON between them.
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 Design Doc creation)
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 requirements are moderately clarified:
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
- - **[STOP]**: Present design alternatives and trade-offs, obtain user approval
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
- **Role**: Orchestrator
9
+ **Core Identity**: "I am an orchestrator." (see subagents-orchestration-guide skill)
10
10
 
11
- **Execution Method**:
12
- - Test skeleton generation performed by acceptance-test-generator
13
- - Work plan creation performed by work-planner
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
- Orchestrator invokes sub-agents and passes structured JSON between them.
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
- Create frontend work plan with the following process:
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
- Interact with user to complete plan and obtain approval for plan content. Clarify specific implementation steps and risks.
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
- ## Execution Method
7
+ ## Orchestrator Definition
8
8
 
9
- - Compliance validation -> performed by code-reviewer
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
- Orchestrator invokes sub-agents and passes structured JSON between them.
11
+ **First Action**: Register Steps 1-11 using TaskCreate before any execution.
17
12
 
18
- Design Doc (uses most recent if omitted): $ARGUMENTS
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
- **Think deeply** Understand the essence of compliance validation and execute:
21
+ Design Doc (uses most recent if omitted): $ARGUMENTS
21
22
 
22
23
  ## Execution Flow
23
24
 
24
- ### 1. Prerequisite Check
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. Execute code-reviewer
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 with complianceRate, verdict, acceptanceCriteria, and qualityIssues."
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. Execute security-reviewer
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. Verdict and Response
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 fix steps, proceed to Final Report.
88
+ If both pass and user selects `n`: Skip Steps 5-10, proceed to Step 11.
83
89
 
84
- If user selects `y`:
90
+ ### Step 5: Load Task Template
85
91
 
86
- ## Pre-fix Metacognition
92
+ Read documentation-criteria skill to obtain the task file template (references/task-template.md) for Step 6.
87
93
 
88
- ### 5. Execute rule-advisor
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
- ### 6. Create Task File
95
- Register work steps using TaskCreate. 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`. Include both code compliance issues and security requiredFixes.
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. Execute Fixes
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. Quality Check
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. Re-validate code-reviewer
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. Prior issues: $STEP_2_OUTPUT. Design Doc: [path]. Implementation files: [file list]."
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. Re-validate security-reviewer (only if security fixes were applied)
116
- Invoke security-reviewer using Agent tool:
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 with complianceRate, verdict, acceptanceCriteria, and qualityIssues."
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. Execute Skill
88
+ ### 5. Load Task Template
84
89
 
85
- Execute Skill: documentation-criteria (for task file template)
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
- ## Security Review(全タスク完了後)
104
+ ## 実装後検証(全タスク完了後)
105
105
 
106
- 全タスクサイクル完了後、完了レポートの前にsecurity-reviewerを実行:
107
- 1. **Agent tool** (subagent_type: "security-reviewer") → Design Docパスと実装ファイルリストを渡す
108
- 2. レスポンスを確認:
109
- - `approved` または `approved_with_notes`完了レポートへ(notesがあれば含める)
110
- - `needs_revision` task-executorで`requiredFixes`を実行、quality-fixer実行後、security-reviewerを再実行
111
- - `blocked` → ユーザーにエスカレーション
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
  実装フェーズが完了しました。