create-ai-project 1.11.2

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 (150) hide show
  1. package/.claude/agents/acceptance-test-generator.md +316 -0
  2. package/.claude/agents/code-reviewer.md +193 -0
  3. package/.claude/agents/document-reviewer.md +182 -0
  4. package/.claude/agents/prd-creator.md +186 -0
  5. package/.claude/agents/quality-fixer.md +295 -0
  6. package/.claude/agents/requirement-analyzer.md +161 -0
  7. package/.claude/agents/rule-advisor.md +194 -0
  8. package/.claude/agents/task-decomposer.md +291 -0
  9. package/.claude/agents/task-executor.md +270 -0
  10. package/.claude/agents/technical-designer.md +343 -0
  11. package/.claude/agents/work-planner.md +181 -0
  12. package/.claude/agents-en/acceptance-test-generator.md +256 -0
  13. package/.claude/agents-en/code-reviewer.md +195 -0
  14. package/.claude/agents-en/design-sync.md +225 -0
  15. package/.claude/agents-en/document-reviewer.md +190 -0
  16. package/.claude/agents-en/integration-test-reviewer.md +195 -0
  17. package/.claude/agents-en/prd-creator.md +196 -0
  18. package/.claude/agents-en/quality-fixer-frontend.md +334 -0
  19. package/.claude/agents-en/quality-fixer.md +291 -0
  20. package/.claude/agents-en/requirement-analyzer.md +165 -0
  21. package/.claude/agents-en/rule-advisor.md +194 -0
  22. package/.claude/agents-en/task-decomposer.md +291 -0
  23. package/.claude/agents-en/task-executor-frontend.md +276 -0
  24. package/.claude/agents-en/task-executor.md +272 -0
  25. package/.claude/agents-en/technical-designer-frontend.md +441 -0
  26. package/.claude/agents-en/technical-designer.md +371 -0
  27. package/.claude/agents-en/work-planner.md +216 -0
  28. package/.claude/agents-ja/acceptance-test-generator.md +256 -0
  29. package/.claude/agents-ja/code-reviewer.md +195 -0
  30. package/.claude/agents-ja/design-sync.md +225 -0
  31. package/.claude/agents-ja/document-reviewer.md +192 -0
  32. package/.claude/agents-ja/integration-test-reviewer.md +195 -0
  33. package/.claude/agents-ja/prd-creator.md +194 -0
  34. package/.claude/agents-ja/quality-fixer-frontend.md +335 -0
  35. package/.claude/agents-ja/quality-fixer.md +292 -0
  36. package/.claude/agents-ja/requirement-analyzer.md +164 -0
  37. package/.claude/agents-ja/rule-advisor.md +194 -0
  38. package/.claude/agents-ja/task-decomposer.md +291 -0
  39. package/.claude/agents-ja/task-executor-frontend.md +276 -0
  40. package/.claude/agents-ja/task-executor.md +272 -0
  41. package/.claude/agents-ja/technical-designer-frontend.md +442 -0
  42. package/.claude/agents-ja/technical-designer.md +370 -0
  43. package/.claude/agents-ja/work-planner.md +213 -0
  44. package/.claude/commands/build.md +78 -0
  45. package/.claude/commands/design.md +27 -0
  46. package/.claude/commands/implement.md +79 -0
  47. package/.claude/commands/plan.md +43 -0
  48. package/.claude/commands/project-inject.md +76 -0
  49. package/.claude/commands/refine-rule.md +206 -0
  50. package/.claude/commands/review.md +78 -0
  51. package/.claude/commands/sync-rules.md +116 -0
  52. package/.claude/commands/task.md +13 -0
  53. package/.claude/commands-en/build.md +77 -0
  54. package/.claude/commands-en/design.md +39 -0
  55. package/.claude/commands-en/front-build.md +103 -0
  56. package/.claude/commands-en/front-design.md +42 -0
  57. package/.claude/commands-en/front-plan.md +40 -0
  58. package/.claude/commands-en/implement.md +75 -0
  59. package/.claude/commands-en/plan.md +45 -0
  60. package/.claude/commands-en/project-inject.md +76 -0
  61. package/.claude/commands-en/refine-rule.md +208 -0
  62. package/.claude/commands-en/review.md +78 -0
  63. package/.claude/commands-en/sync-rules.md +116 -0
  64. package/.claude/commands-en/task.md +13 -0
  65. package/.claude/commands-ja/build.md +75 -0
  66. package/.claude/commands-ja/design.md +37 -0
  67. package/.claude/commands-ja/front-build.md +103 -0
  68. package/.claude/commands-ja/front-design.md +42 -0
  69. package/.claude/commands-ja/front-plan.md +40 -0
  70. package/.claude/commands-ja/implement.md +73 -0
  71. package/.claude/commands-ja/plan.md +43 -0
  72. package/.claude/commands-ja/project-inject.md +76 -0
  73. package/.claude/commands-ja/refine-rule.md +206 -0
  74. package/.claude/commands-ja/review.md +78 -0
  75. package/.claude/commands-ja/sync-rules.md +116 -0
  76. package/.claude/commands-ja/task.md +13 -0
  77. package/.claude/settings.local.json +74 -0
  78. package/.husky/pre-commit +1 -0
  79. package/.husky/pre-push +3 -0
  80. package/.madgerc +14 -0
  81. package/.tsprunerc +11 -0
  82. package/CLAUDE.en.md +102 -0
  83. package/CLAUDE.ja.md +102 -0
  84. package/CLAUDE.md +111 -0
  85. package/LICENSE +21 -0
  86. package/README.ja.md +233 -0
  87. package/README.md +243 -0
  88. package/bin/create-project.js +87 -0
  89. package/biome.json +51 -0
  90. package/docs/adr/template-en.md +64 -0
  91. package/docs/adr/template-ja.md +64 -0
  92. package/docs/design/template-en.md +281 -0
  93. package/docs/design/template-ja.md +285 -0
  94. package/docs/guides/en/quickstart.md +111 -0
  95. package/docs/guides/en/rule-editing-guide.md +266 -0
  96. package/docs/guides/en/sub-agents.md +343 -0
  97. package/docs/guides/en/use-cases.md +308 -0
  98. package/docs/guides/ja/quickstart.md +112 -0
  99. package/docs/guides/ja/rule-editing-guide.md +266 -0
  100. package/docs/guides/ja/sub-agents.md +343 -0
  101. package/docs/guides/ja/use-cases.md +290 -0
  102. package/docs/guides/sub-agents.md +306 -0
  103. package/docs/plans/20250123-integration-test-improvement.md +993 -0
  104. package/docs/plans/template-en.md +130 -0
  105. package/docs/plans/template-ja.md +130 -0
  106. package/docs/prd/template-en.md +109 -0
  107. package/docs/prd/template-ja.md +109 -0
  108. package/docs/rules/ai-development-guide.md +260 -0
  109. package/docs/rules/architecture/implementation-approach.md +136 -0
  110. package/docs/rules/documentation-criteria.md +180 -0
  111. package/docs/rules/project-context.md +38 -0
  112. package/docs/rules/rules-index.yaml +137 -0
  113. package/docs/rules/technical-spec.md +47 -0
  114. package/docs/rules/typescript-testing.md +188 -0
  115. package/docs/rules/typescript.md +166 -0
  116. package/docs/rules-en/architecture/implementation-approach.md +136 -0
  117. package/docs/rules-en/coding-standards.md +333 -0
  118. package/docs/rules-en/documentation-criteria.md +184 -0
  119. package/docs/rules-en/frontend/technical-spec.md +143 -0
  120. package/docs/rules-en/frontend/typescript-testing.md +124 -0
  121. package/docs/rules-en/frontend/typescript.md +131 -0
  122. package/docs/rules-en/integration-e2e-testing.md +149 -0
  123. package/docs/rules-en/project-context.md +38 -0
  124. package/docs/rules-en/rules-index.yaml +211 -0
  125. package/docs/rules-en/technical-spec.md +86 -0
  126. package/docs/rules-en/typescript-testing.md +149 -0
  127. package/docs/rules-en/typescript.md +116 -0
  128. package/docs/rules-ja/architecture/implementation-approach.md +136 -0
  129. package/docs/rules-ja/coding-standards.md +333 -0
  130. package/docs/rules-ja/documentation-criteria.md +180 -0
  131. package/docs/rules-ja/frontend/technical-spec.md +143 -0
  132. package/docs/rules-ja/frontend/typescript-testing.md +124 -0
  133. package/docs/rules-ja/frontend/typescript.md +131 -0
  134. package/docs/rules-ja/integration-e2e-testing.md +149 -0
  135. package/docs/rules-ja/project-context.md +38 -0
  136. package/docs/rules-ja/rules-index.yaml +196 -0
  137. package/docs/rules-ja/technical-spec.md +86 -0
  138. package/docs/rules-ja/typescript-testing.md +149 -0
  139. package/docs/rules-ja/typescript.md +116 -0
  140. package/package.json +98 -0
  141. package/scripts/check-unused-exports.js +69 -0
  142. package/scripts/cleanup-test-processes.sh +32 -0
  143. package/scripts/post-setup.js +110 -0
  144. package/scripts/set-language.js +310 -0
  145. package/scripts/setup-project.js +199 -0
  146. package/scripts/show-coverage.js +74 -0
  147. package/src/index.ts +11 -0
  148. package/templates/.gitignore.template +52 -0
  149. package/tsconfig.json +50 -0
  150. package/vitest.config.mjs +47 -0
@@ -0,0 +1,208 @@
1
+ ---
2
+ description: Optimize rule changes for maximum AI execution accuracy
3
+ ---
4
+
5
+ Change request: $ARGUMENTS
6
+
7
+ **THINK DEEPLY AND SYSTEMATICALLY** Extract the TRUE INTENT behind user's change request and implement with MAXIMUM PRECISION to eliminate ALL ambiguity:
8
+
9
+ ## 9 Optimization Perspectives
10
+ 1. Context efficiency vs execution accuracy - Maximum accuracy with minimal description
11
+ 2. Deduplication - Consistency within and across rule files
12
+ 3. Proper responsibility aggregation - Group related content (minimize read operations)
13
+ 4. Clear decision criteria - Measurable standards
14
+ 5. Transform negatives to recommendations - Recommended format (background: including NG examples)
15
+ 6. Consistent notation - Unified expressions
16
+ 7. Explicit prerequisites - Make implicit assumptions visible
17
+ 8. Optimized description order - Most important first, exceptions last
18
+ 9. Clear scope boundaries - What's covered vs what's not
19
+
20
+ ## Execution Flow
21
+
22
+ ### 1. Understand the Request
23
+
24
+ Question template when unspecified:
25
+ ```
26
+ 1. Which rule file to modify?
27
+ e.g.: typescript.md / ai-development-guide.md / documentation-criteria.md
28
+
29
+ 2. Select change type:
30
+ a) Add new rule (add new criteria)
31
+ b) Modify existing rule (clarify ambiguous descriptions)
32
+ c) Delete rule (remove obsolete criteria)
33
+
34
+ 3. Specific changes:
35
+ e.g.: "Add rule prohibiting 'any' type usage"
36
+ e.g.: "Clarify error handling criteria"
37
+ [User input]
38
+ ```
39
+
40
+ ### 2. Create Design Proposal
41
+
42
+ Target file identification and current state check:
43
+
44
+ ```
45
+ # Tool selection criteria (measurable decisions)
46
+ if file path is explicitly provided:
47
+ Read: Direct file read (background: Skip Glob to save context)
48
+ else if partial filename known:
49
+ Glob: docs/rules/*{keyword}*.md search
50
+ Read: Check identified file's current state
51
+ else:
52
+ Glob: docs/rules/*.md for full scan (background: comprehensive search when unclear)
53
+ Confirm target file selection with user
54
+ ```
55
+
56
+ Design template:
57
+ ```
58
+ 【Current】
59
+ "Handle errors appropriately" (ambiguous: "appropriately" undefined)
60
+
61
+ 【Understanding User Request】
62
+ "Want stricter error handling" → Set measurable criteria
63
+
64
+ 【Proposal】
65
+ "Error handling implementation criteria:
66
+ 1. try-catch required for:
67
+ - External API calls (fetch, axios, etc.)
68
+ - File I/O operations (fs.readFile, etc.)
69
+ - Parsing operations (JSON.parse, parseInt, etc.)
70
+ 2. Required error log items:
71
+ - error.name (error type)
72
+ - error.stack (location)
73
+ - Timestamp (ISO 8601 format)
74
+ 3. User notification criteria:
75
+ - No technical details (NG: stack trace display)
76
+ - Clear action items (recommended: "Please try again")"
77
+
78
+ Proceed with this design? (y/n)
79
+ ```
80
+
81
+ ### 3. Three-Pass Review Process
82
+
83
+ #### Pass 1: Add for Maximum Accuracy【Addition-Only Mode】
84
+ **MANDATORY DECLARATION**: "Pass 1: Addition mode execution. Deletions are STRICTLY PROHIBITED."
85
+ **REQUIRED ACTIONS**:
86
+ - CONVERT all ambiguous expressions → measurable criteria
87
+ Example: "large" → "100+ lines" "5+ files"
88
+ - MAKE all implicit prerequisites explicit
89
+ Example: "In TypeScript environment" "Within async functions"
90
+ - DEFINE all exceptions and edge cases
91
+ Example: "When null/undefined" "For empty arrays"
92
+ **MANDATORY REPORT**: Count added items (MINIMUM 5 items required)
93
+
94
+ #### Pass 2: Critical Modification to Reduce Redundancy【Actual Modification Mode】
95
+ **MANDATORY DECLARATION**: "Pass 2: Critical modification mode execution. ACTUALLY DELETE and CONSOLIDATE redundant parts."
96
+
97
+ **REQUIRED MODIFICATION WORK**:
98
+ 1. CRITICALLY REVIEW all Pass 1 additions
99
+ 2. APPLY modifications using these EXACT criteria:
100
+ - Duplicate concepts → MUST consolidate
101
+ - Overly detailed explanations → MUST simplify
102
+ - Overlap with other rules → MUST replace with references
103
+ 3. RECORD complete before/after diff (deletion reasons REQUIRED)
104
+
105
+ Report format:
106
+ ```
107
+ Modified locations: X items
108
+ Deleted/consolidated content:
109
+ - [Before]: "Detailed description"
110
+ [After]: "Concise description"
111
+ [Reason]: Redundancy elimination
112
+ ```
113
+
114
+ #### Pass 3: Accuracy Assurance via Diff Evaluation【Restoration Decision Mode】
115
+ **MANDATORY DECLARATION**: "Pass 3: Diff evaluation mode execution. REVIEW all Pass 2 modifications and RESTORE if accuracy compromised."
116
+
117
+ **REQUIRED VERIFICATION WORK**:
118
+ 1. EVALUATE EACH Pass 2 modification against these criteria:
119
+ - Does deletion create implementation ambiguity? YES = RESTORE
120
+ - Are ALL edge cases still covered? NO = RESTORE
121
+ 2. Action mapping:
122
+ - Deletions with accuracy risks → MUST restore
123
+ - Valid deletions → KEEP
124
+
125
+ **MANDATORY FINAL CONFIRMATION** (MUST answer explicitly):
126
+ "Are necessary and sufficient conditions present for accurate implementation of user requirements? YES/NO with justification"
127
+
128
+ **MANDATORY REPORT**: Number of restored items AND final reduction percentage
129
+
130
+ ### 4. Get Approval
131
+
132
+ Present before/after comparison for user approval.
133
+
134
+ ### 5. Implementation
135
+
136
+ 1. Apply changes with appropriate tool (after user approval)
137
+ 2. Final verification with git diff
138
+ 3. Suggest `/sync-rules` execution
139
+
140
+ ## Decision Criteria Checklist
141
+ - [ ] Expressible in "if-then" format ("if X then Y")
142
+ - [ ] Measurable by numbers/counts/states (eliminate subjective judgment)
143
+ - [ ] Related content aggregated in single file (minimize read operations)
144
+ - [ ] Relationships with other rules specified (dependencies/references/delegation)
145
+ - [ ] NG examples included as background information
146
+ - [ ] All prerequisites explicitly stated
147
+
148
+ ## Reduction Pattern Examples
149
+ | Pattern | Before | After |
150
+ |---------|--------|-------|
151
+ | Emotional expressions | "must always" | "execute when (background: build error if skipped)" |
152
+ | Time expressions | "immediately" | "execute first after error detection" |
153
+ | Implicit prerequisites | "implement error handling" | "TypeScript async function error handling" |
154
+ | Unclear order | "consider: A, B, C" | "Priority: 1.A (required), 2.B (recommended), 3.C (optional)" |
155
+ | Redundant explanation | "ensure type safety by defining types, checking types, and preventing type errors" | "type safety (define・check・prevent errors)" |
156
+ | Ambiguous scope | "write tests" | "write unit tests (see test-guide for E2E tests)" |
157
+
158
+ ## Output Example
159
+
160
+ ```
161
+ === Change Implementation Complete ===
162
+
163
+ 【User Request】
164
+ "Strengthen TypeScript error handling rules"
165
+
166
+ 【Changes】
167
+ Target: docs/rules/typescript.md
168
+ Section: ## Error Handling
169
+
170
+ Before:
171
+ "Handle errors appropriately"
172
+
173
+ After (3-pass review complete):
174
+ "Error handling implementation criteria:
175
+ 1. try-catch block required for:
176
+ - External API calls (fetch, axios, etc.)
177
+ - File I/O operations (fs.readFile, fs.writeFile, etc.)
178
+ - Exception-prone operations (JSON.parse, parseInt, etc.)
179
+ 2. Required error log items:
180
+ - error.name (error type)
181
+ - error.stack (location)
182
+ - new Date().toISOString() (timestamp)
183
+ 3. User-facing messages:
184
+ - No technical details (NG: stack trace display)
185
+ - Clear action items (recommended: "Please try again")"
186
+
187
+ 【Improvement Metrics】
188
+ - Decision clarity: 0% → 100% (all measurable)
189
+ - Ambiguous expressions: 1 → 0
190
+ - NG examples included as background
191
+
192
+ Run /sync-rules for metadata synchronization.
193
+ ```
194
+
195
+ ## Execution Order
196
+ 1. Understand user request
197
+ 2. Analyze current state
198
+ 3. Design changes with 9 perspectives
199
+ 4. 3-pass review process
200
+ 5. User approval
201
+ 6. Apply changes
202
+ 7. Suggest sync-rules
203
+
204
+ **Scope**: Understanding user change requests and implementing with maximum accuracy
205
+
206
+ ## Error Handling
207
+ - **File not found**: Display available rule list
208
+ - **Large change detected**: Suggest phased implementation for 50%+ changes
@@ -0,0 +1,78 @@
1
+ ---
2
+ description: Design Doc compliance validation with optional auto-fixes
3
+ ---
4
+
5
+ **Command Context**: Post-implementation quality assurance command
6
+
7
+ Design Doc (uses most recent if omitted): $ARGUMENTS
8
+
9
+ **Think deeply** Understand the essence of compliance validation and execute:
10
+
11
+ ## Execution Flow
12
+
13
+ ### 1. Prerequisite Check
14
+ ```bash
15
+ # Identify Design Doc
16
+ ls docs/design/*.md | grep -v template | tail -1
17
+
18
+ # Check implementation files
19
+ git diff --name-only main...HEAD
20
+ ```
21
+
22
+ ### 2. Execute code-reviewer
23
+ Validate Design Doc compliance:
24
+ - Acceptance criteria fulfillment
25
+ - Code quality check
26
+ - Implementation completeness assessment
27
+
28
+ ### 3. Verdict and Response
29
+
30
+ **Criteria (considering project stage)**:
31
+ - Prototype: Pass at 70%+
32
+ - Production: 90%+ recommended
33
+ - Critical items (security, etc.): Required regardless of rate
34
+
35
+ **Compliance-based response**:
36
+
37
+ For low compliance (production <90%):
38
+ ```
39
+ Validation Result: [X]% compliance
40
+ Unfulfilled items:
41
+ - [item list]
42
+
43
+ Execute fixes? (y/n):
44
+ ```
45
+
46
+ If user selects `y`:
47
+
48
+ ## 🧠 Pre-fix Metacognition
49
+ **Required**: `rule-advisor → TodoWrite → task-executor → quality-fixer`
50
+
51
+ 1. **Execute rule-advisor**: Understand fix essence (symptomatic treatment vs root solution)
52
+ 2. **Update TodoWrite**: Structure fix tasks → `docs/plans/tasks/review-fixes-YYYYMMDD.md`
53
+ 3. **Execute task-executor**: Staged auto-fixes (stops at 5 files)
54
+ 4. **Execute quality-fixer**: Confirm quality gate passage
55
+ 5. **Re-validate**: Measure improvement with code-reviewer
56
+
57
+ ### 4. Final Report
58
+ ```
59
+ Initial compliance: [X]%
60
+ Final compliance: [Y]% (if fixes executed)
61
+ Improvement: [Y-X]%
62
+
63
+ Remaining issues:
64
+ - [items requiring manual intervention]
65
+ ```
66
+
67
+ ## Auto-fixable Items
68
+ - Simple unimplemented acceptance criteria
69
+ - Error handling additions
70
+ - Type definition fixes
71
+ - Function splitting (length/complexity improvements)
72
+
73
+ ## Non-fixable Items
74
+ - Fundamental business logic changes
75
+ - Architecture-level modifications
76
+ - Design Doc deficiencies
77
+
78
+ **Scope**: Design Doc compliance validation and auto-fixes.
@@ -0,0 +1,116 @@
1
+ ---
2
+ description: Synchronize rule metadata and optimize rule-advisor precision after rule edits
3
+ ---
4
+
5
+ **Command Context**: Post-editing maintenance workflow for rule files
6
+
7
+ **Think deeply** Maximize rule-advisor execution precision through systematic synchronization:
8
+
9
+ ## Execution Flow
10
+
11
+ ### 1. Scan Rule Files
12
+ ```bash
13
+ # Runtime rules directory
14
+ RULES_DIR="docs/rules"
15
+ INDEX_FILE="${RULES_DIR}/rules-index.yaml"
16
+
17
+ # Analyze all rule files
18
+ find "${RULES_DIR}" -name "*.md" -type f | sort
19
+ ```
20
+
21
+ ### 2. Synchronize and Optimize Metadata
22
+
23
+ #### Automatic Section Synchronization
24
+ - Extract `## ` sections from each file
25
+ - Update sections in rules-index.yaml automatically
26
+
27
+ #### Tag Optimization
28
+ - Analyze file content for relevant keywords
29
+ - Propose addition of missing tags
30
+ - Suggest removal of obsolete tags
31
+
32
+ #### Typical-Use Enhancement
33
+ - Infer usage scenarios from file changes
34
+ - Propose more specific and actionable descriptions
35
+
36
+ #### Key-References Completion
37
+ - Detect newly introduced concepts or methodologies
38
+ - Suggest relevant reference additions
39
+
40
+ ### 3. Rule-Advisor Precision Optimization
41
+
42
+ Enhance metadata quality to enable accurate rule selection by rule-advisor:
43
+
44
+ ```
45
+ === Rule Metadata Synchronization ===
46
+ Target: docs/rules
47
+
48
+ Updates executed:
49
+ ✅ Sections synchronized
50
+ - typescript-testing.md: 2 sections added
51
+ - ai-development-guide.md: 1 section updated
52
+
53
+ ✅ Tags optimized
54
+ - typescript.md: Suggest adding [functional-programming]
55
+ - technical-spec.md: Suggest removing [deprecated]
56
+
57
+ ✅ Typical-use improved
58
+ - 3 files updated with more specific descriptions
59
+
60
+ Final result: Rule-advisor precision optimization complete
61
+ ```
62
+
63
+ ## 🧠 Metacognitive Points
64
+
65
+ **Essential Purpose**:
66
+ - Not mere consistency maintenance, but rule-advisor selection accuracy enhancement
67
+ - Metadata optimization as the final step of rule editing workflow
68
+
69
+ **Quality Criteria**:
70
+ - Sections must achieve 100% synchronization
71
+ - Tags must accurately reflect content
72
+ - Typical-use must specify concrete usage scenarios
73
+ - Key-references must cover current methodologies
74
+
75
+ ## Change Necessity Evaluation
76
+
77
+ **EVALUATION SEQUENCE**:
78
+ - IF sections achieve 100% synchronization → OUTPUT "Synchronization verified. No updates required." THEN TERMINATE
79
+ - IF content-to-tag mapping shows zero mismatches → DETERMINE no_changes_needed = true THEN TERMINATE
80
+ - IF AND ONLY IF measurable improvements exist → GENERATE specific modification proposals WITH exact before/after values
81
+
82
+ **NOTE**: You MUST NOT force changes. When no improvements are detected, you SHALL report "No modifications necessary" and STOP execution.
83
+
84
+ ## Execution Timing
85
+
86
+ - After rule file edits (mandatory)
87
+ - When adding new rule files
88
+ - After major rule revisions
89
+ - When rule-advisor selection accuracy appears degraded
90
+
91
+ ## Example Output
92
+
93
+ ```
94
+ === Rule Metadata Synchronization Started ===
95
+ Target: docs/rules (9 files)
96
+
97
+ [1/9] typescript.md
98
+ ✅ sections: 7 synchronized
99
+ 💡 tags proposed: +[functional-programming, dependency-injection]
100
+ 💡 typical-use: "General TypeScript implementation" → "Type-safe implementation with modern TypeScript features"
101
+
102
+ [2/9] typescript-testing.md
103
+ ✅ sections: 2 added (Test Granularity Principles, Mock Type Safety Enforcement)
104
+ ✅ tags: No changes needed
105
+ ✅ typical-use: Maintained
106
+
107
+ ...
108
+
109
+ === Synchronization Complete ===
110
+ Updated: 3 files
111
+ Proposals: 5 items (approval required)
112
+
113
+ Rule-advisor precision improvement: Estimated 15% enhancement
114
+ ```
115
+
116
+ **Scope**: Post-edit rule metadata synchronization and rule-advisor precision optimization.
@@ -0,0 +1,13 @@
1
+ ---
2
+ description: Execute tasks following appropriate rules
3
+ ---
4
+
5
+ Task: $ARGUMENTS
6
+
7
+ **Pre-execution Checklist** (MUST clarify BEFORE starting):
8
+
9
+ 1. **Applicable Rules**: Which development rules apply to this task?
10
+ 2. **Initial Action**: Based on the rules, what is the FIRST step?
11
+ 3. **Scope Boundary**: What are the completion criteria and scope of responsibility?
12
+
13
+ Proceed with the task ONLY AFTER making the above explicit.
@@ -0,0 +1,75 @@
1
+ ---
2
+ description: 分解済みタスクを自律実行モードで実装
3
+ ---
4
+
5
+ @docs/guides/sub-agents.md を厳守し、**オーケストレーター**として振る舞います。
6
+
7
+ 作業計画書: $ARGUMENTS
8
+
9
+ ## 📋 実行前の前提確認
10
+
11
+ ### タスクファイル存在チェック
12
+ ```bash
13
+ # 計画書の確認
14
+ ! ls -la docs/plans/*.md | grep -v template | tail -5
15
+
16
+ # タスクファイルの確認
17
+ ! ls docs/plans/tasks/*.md 2>/dev/null || echo "⚠️ タスクファイルが見つかりません"
18
+ ```
19
+
20
+ ### タスク生成判定フロー
21
+
22
+ **Think deeply** タスクファイルの存在状態を確認し、適切な対応を決定:
23
+
24
+ | 状態 | 判定基準 | 次のアクション |
25
+ |------|---------|--------------|
26
+ | タスク存在 | tasks/ディレクトリに.mdファイルあり | 自律実行モードへ移行 |
27
+ | タスクなし+計画書あり | 計画書は存在するがタスクファイルなし | ユーザーに確認 → task-decomposer実行 |
28
+ | 両方なし | 計画書もタスクファイルもなし | エラー:実行条件を満たさない |
29
+
30
+ ## 🔄 タスク分解フェーズ(条件付き実行)
31
+
32
+ タスクファイルが存在しない場合の処理:
33
+
34
+ ### 1. ユーザー確認
35
+ ```
36
+ タスクファイルが見つかりません。
37
+ 作業計画書: docs/plans/[計画書名].md
38
+
39
+ 計画書からタスクを分解して生成しますか? (y/n):
40
+ ```
41
+
42
+ ### 2. タスク分解実行(承認時)
43
+ ```
44
+ @task-decomposer 作業計画書を読み込み、1コミット粒度の独立したタスクに分解:
45
+ - 入力: docs/plans/[計画書名].md
46
+ - 出力: docs/plans/tasks/配下に個別タスクファイル生成
47
+ - 粒度: 1タスク = 1コミット = 独立して実行可能
48
+ ```
49
+
50
+ ### 3. 生成確認
51
+ ```bash
52
+ # 生成されたタスクファイルを確認
53
+ ! ls -la docs/plans/tasks/*.md | head -10
54
+ ```
55
+
56
+ ✅ **推奨**: タスク生成完了後、自動的に自律実行モードへ移行
57
+ ❌ **避ける**: タスク未生成のまま実装を開始
58
+
59
+ ## 🧠 タスク実行フロー
60
+ sub-agents.mdの「自律実行中のタスク管理」に従い、TodoWriteで4ステップを管理:
61
+ 1. task-executor実行
62
+ 2. エスカレーション判定・フォローアップ
63
+ 3. quality-fixer実行
64
+ 4. git commit
65
+
66
+ 承認確認後、自律実行モードを開始。要件変更検知時は即座に停止。
67
+
68
+ ## 出力例
69
+ 実装フェーズが完了しました。
70
+ - タスク分解: docs/plans/tasks/ 配下に生成(実行時のみ)
71
+ - 実装されたタスク: [タスク数]件
72
+ - 品質チェック: すべて通過
73
+ - コミット: [コミット数]件作成
74
+
75
+ **責務境界**: 本コマンドはタスク分解から実装完了まで担当。
@@ -0,0 +1,37 @@
1
+ ---
2
+ description: 要件分析から設計書作成まで実行
3
+ ---
4
+
5
+ **コマンドコンテキスト**: このコマンドは設計フェーズ専用です。
6
+
7
+ @docs/guides/sub-agents.md の設計フローに従い、**requirement-analyzer から設計書作成・承認まで**を実行します。
8
+
9
+ 要件: $ARGUMENTS
10
+
11
+ **Think harder** 設計への影響を深く考慮し、まず要件の背景と目的を理解するため対話を行い:
12
+ - どのような問題を解決したいか
13
+ - 期待される成果と成功基準
14
+ - 既存システムとの関係性
15
+
16
+ 適度に要件が明確になったら、requirement-analyzerで分析し、規模に応じた適切な設計書を作成します。
17
+
18
+ 設計の代替案とトレードオフを明確に提示します。
19
+
20
+ **スコープ**: 設計書(ADR/Design Doc)承認+Design Doc間整合性確認まで。作業計画以降は本コマンドの責務外。
21
+
22
+ ## 実行フロー
23
+
24
+ 1. requirement-analyzer → 要件分析
25
+ 2. technical-designer → Design Doc作成
26
+ 3. document-reviewer → 単一ドキュメント品質チェック
27
+ 4. ユーザー承認
28
+ 5. design-sync → Design Doc間整合性検証
29
+ - 矛盾あり → ユーザーに報告 → 修正指示待ち → technical-designer(update)で修正
30
+ - 矛盾なし → 終了
31
+
32
+ ## 出力例
33
+ 設計フェーズが完了しました。
34
+ - 設計書: docs/design/[ドキュメント名].md
35
+ - 整合性: 他Design Docと矛盾なし(または修正完了)
36
+
37
+ **重要**: 本コマンドは設計承認+整合性確認で終了。次フェーズへの移行提案は行わない。
@@ -0,0 +1,103 @@
1
+ ---
2
+ description: フロントエンド実装を自律実行モードで実行
3
+ ---
4
+
5
+ **コマンドコンテキスト**: オーケストレーターとして、フロントエンド実装の自律実行モードの完遂を自己完結します。
6
+
7
+ 作業計画: $ARGUMENTS
8
+
9
+ ## 📋 実行前提条件
10
+
11
+ ### タスクファイル存在チェック
12
+ ```bash
13
+ # 作業計画書を確認
14
+ ! ls -la docs/plans/*.md | grep -v template | tail -5
15
+
16
+ # タスクファイルを確認
17
+ ! ls docs/plans/tasks/*.md 2>/dev/null || echo "⚠️ タスクファイルが見つかりません"
18
+ ```
19
+
20
+ ### タスク生成判定フロー
21
+
22
+ **THINK DEEPLY AND SYSTEMATICALLY**: タスクファイルの存在状態を分析し、必要な正確なアクションを決定:
23
+
24
+ | 状態 | 基準 | 次のアクション |
25
+ |------|------|--------------|
26
+ | タスク存在 | tasks/ディレクトリに.mdファイルあり | 自律実行へ進む |
27
+ | タスクなし+計画あり | 計画書は存在するがタスクファイルなし | ユーザー確認 → task-decomposer実行 |
28
+ | どちらもなし | 計画書もタスクファイルもなし | エラー: 前提条件未達成 |
29
+
30
+ ## 🔄 タスク分解フェーズ(条件付き)
31
+
32
+ タスクファイルが存在しない場合:
33
+
34
+ ### 1. ユーザー確認
35
+ ```
36
+ タスクファイルが見つかりません。
37
+ 作業計画: docs/plans/[plan-name].md
38
+
39
+ 作業計画からタスクを生成しますか? (y/n):
40
+ ```
41
+
42
+ ### 2. タスク分解(承認された場合)
43
+ ```
44
+ @task-decomposer 作業計画を読み込み、アトミックなタスクに分解:
45
+ - 入力: docs/plans/[plan-name].md
46
+ - 出力: docs/plans/tasks/ 配下の個別タスクファイル
47
+ - 粒度: 1タスク = 1コミット = 独立実行可能
48
+ ```
49
+
50
+ ### 3. 生成確認
51
+ ```bash
52
+ # 生成されたタスクファイルを確認
53
+ ! ls -la docs/plans/tasks/*.md | head -10
54
+ ```
55
+
56
+ ✅ **必須**: タスク生成後、自動的に自律実行へ進む
57
+ ❌ **禁止**: タスク生成なしで実装開始
58
+
59
+ ## 🧠 各タスクのメタ認知 - フロントエンド特化
60
+
61
+ **必須実行サイクル**: `task-executor-frontend → quality-fixer-frontend → commit`
62
+
63
+ ### サブエージェント呼び出し方法
64
+ Taskツールを使用してサブエージェントを呼び出す:
65
+ - `subagent_type`: エージェント名
66
+ - `description`: タスクの簡潔な説明(3-5語)
67
+ - `prompt`: 具体的な指示内容
68
+
69
+ ### 構造化レスポンス仕様
70
+ 各サブエージェントはJSON形式で応答:
71
+ - **task-executor-frontend**: status, filesModified, testsAdded, readyForQualityCheck
72
+ - **quality-fixer-frontend**: status, checksPerformed, fixesApplied, approved
73
+
74
+ ### 各タスクの実行フロー
75
+
76
+ 各タスクで実行:
77
+
78
+ 1. **task-executor-frontend使用**: フロントエンド実装を実行
79
+ - 呼び出し例: `subagent_type: "task-executor-frontend"`, `description: "タスク実行"`, `prompt: "タスクファイル: docs/plans/tasks/[ファイル名].md 実装を実行"`
80
+ 2. **構造化レスポンス処理**: `readyForQualityCheck: true` 検出時 → 即座にquality-fixer-frontend実行
81
+ 3. **quality-fixer-frontend使用**: 全品質チェック実行(Biome、TypeScriptビルド、テスト)
82
+ - 呼び出し例: `subagent_type: "quality-fixer-frontend"`, `description: "品質チェック"`, `prompt: "全てのフロントエンド品質チェックと修正を実行"`
83
+ 4. **コミット実行**: `approved: true`確認後、即座にgit commitを実行
84
+
85
+ ### 自律実行中の品質保証(詳細)
86
+ - task-executor-frontend実行 → quality-fixer-frontend実行 → **私(メインAI)がコミット実行**(Bashツール使用)
87
+ - quality-fixer-frontendの`approved: true`確認後、即座にgit commitを実行
88
+ - changeSummaryをコミットメッセージに使用
89
+
90
+ **THINK DEEPLY**: 例外なく全ての構造化レスポンスを監視し、全ての品質ゲートが通過することを確保。
91
+
92
+ ! ls -la docs/plans/*.md | head -10
93
+
94
+ 承認ステータスを確認してから進む。確認後、自律実行モードを開始。要件変更を検出したら即座に停止。
95
+
96
+ ## 出力例
97
+ フロントエンド実装フェーズ完了。
98
+ - タスク分解: docs/plans/tasks/ 配下に生成
99
+ - 実装タスク: [件数] タスク
100
+ - 品質チェック: 全てパス(Biome、TypeScriptビルド、テスト)
101
+ - コミット: [件数] コミット作成
102
+
103
+ **重要**: このコマンドは、タスク分解から完了までのフロントエンド実装全体の自律実行フローを管理します。フロントエンド特化エージェント(task-executor-frontend、quality-fixer-frontend)を自動使用します。
@@ -0,0 +1,42 @@
1
+ ---
2
+ description: 要件分析からフロントエンド設計ドキュメント作成まで実行
3
+ ---
4
+
5
+ **コマンドコンテキスト**: このコマンドはフロントエンド設計フェーズ専用です。
6
+
7
+ **要件分析からフロントエンド設計ドキュメント作成・承認まで**を実行します。
8
+
9
+ 要件: $ARGUMENTS
10
+
11
+ ## 実行フロー
12
+
13
+ ### 1. 要件分析フェーズ
14
+ **Think harder**: 設計への影響が深いことを考慮し、まず対話により要件の背景と目的を理解:
15
+ - 何の問題を解決したいか
16
+ - 期待する成果と成功基準
17
+ - 既存システムとの関係
18
+
19
+ 要件がある程度明確になったら:
20
+ - Taskツールで **requirement-analyzer** を呼び出し
21
+ - `subagent_type: "requirement-analyzer"`
22
+ - `description: "要件分析"`
23
+ - `prompt: "要件: [ユーザー要件] 要件分析と規模判定を実施してください"`
24
+ - **[停止]**: 要件分析結果を確認し、質問事項に対応
25
+
26
+ ### 2. 設計ドキュメント作成フェーズ
27
+ 規模判定に応じて適切な設計ドキュメントを作成:
28
+ - Taskツールで **technical-designer-frontend** を呼び出し
29
+ - ADRの場合: `subagent_type: "technical-designer-frontend"`, `description: "ADR作成"`, `prompt: "[技術決定]のADRを作成"`
30
+ - Design Docの場合: `subagent_type: "technical-designer-frontend"`, `description: "Design Doc作成"`, `prompt: "要件に基づいてDesign Docを作成"`
31
+ - Taskツールで **document-reviewer** を呼び出して整合性検証
32
+ - `subagent_type: "document-reviewer"`, `description: "ドキュメントレビュー"`, `prompt: "[ドキュメントパス]の整合性と完成度をレビュー"`
33
+ - **[停止]**: 設計の選択肢とトレードオフを提示し、ユーザー承認を取得
34
+
35
+ **スコープ**: フロントエンド設計ドキュメント(ADR/Design Doc)の承認まで。作業計画以降はこのコマンドの範囲外。
36
+
37
+ ## 出力例
38
+ フロントエンド設計フェーズ完了。
39
+ - 設計ドキュメント: docs/design/[ドキュメント名].md または docs/adr/[ドキュメント名].md
40
+ - 承認ステータス: ユーザー承認済み
41
+
42
+ **重要**: このコマンドは設計承認で終了。次フェーズへの移行は提案しません。