create-ai-project 1.13.1 → 1.14.1

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 (69) hide show
  1. package/.claude/agents-en/acceptance-test-generator.md +1 -1
  2. package/.claude/agents-en/code-reviewer.md +1 -1
  3. package/.claude/agents-en/code-verifier.md +192 -0
  4. package/.claude/agents-en/design-sync.md +1 -1
  5. package/.claude/agents-en/document-reviewer.md +147 -36
  6. package/.claude/agents-en/integration-test-reviewer.md +1 -1
  7. package/.claude/agents-en/investigator.md +1 -1
  8. package/.claude/agents-en/prd-creator.md +38 -15
  9. package/.claude/agents-en/requirement-analyzer.md +1 -1
  10. package/.claude/agents-en/rule-advisor.md +1 -1
  11. package/.claude/agents-en/scope-discoverer.md +229 -0
  12. package/.claude/agents-en/solver.md +1 -1
  13. package/.claude/agents-en/task-decomposer.md +1 -1
  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 +1 -1
  17. package/.claude/agents-en/technical-designer.md +1 -1
  18. package/.claude/agents-en/verifier.md +1 -1
  19. package/.claude/agents-en/work-planner.md +1 -1
  20. package/.claude/agents-ja/acceptance-test-generator.md +1 -1
  21. package/.claude/agents-ja/code-reviewer.md +1 -1
  22. package/.claude/agents-ja/code-verifier.md +192 -0
  23. package/.claude/agents-ja/design-sync.md +1 -1
  24. package/.claude/agents-ja/document-reviewer.md +159 -44
  25. package/.claude/agents-ja/integration-test-reviewer.md +1 -1
  26. package/.claude/agents-ja/investigator.md +1 -1
  27. package/.claude/agents-ja/prd-creator.md +46 -16
  28. package/.claude/agents-ja/requirement-analyzer.md +1 -1
  29. package/.claude/agents-ja/rule-advisor.md +1 -1
  30. package/.claude/agents-ja/scope-discoverer.md +229 -0
  31. package/.claude/agents-ja/solver.md +1 -1
  32. package/.claude/agents-ja/task-decomposer.md +1 -1
  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 +1 -1
  36. package/.claude/agents-ja/technical-designer.md +1 -1
  37. package/.claude/agents-ja/verifier.md +1 -1
  38. package/.claude/agents-ja/work-planner.md +1 -1
  39. package/.claude/commands-en/reverse-engineer.md +301 -0
  40. package/.claude/commands-ja/reverse-engineer.md +301 -0
  41. package/.claude/skills-en/coding-standards/SKILL.md +3 -1
  42. package/.claude/skills-en/documentation-criteria/SKILL.md +3 -1
  43. package/.claude/skills-en/frontend/technical-spec/SKILL.md +3 -1
  44. package/.claude/skills-en/frontend/typescript-rules/SKILL.md +3 -1
  45. package/.claude/skills-en/frontend/typescript-testing/SKILL.md +3 -1
  46. package/.claude/skills-en/implementation-approach/SKILL.md +3 -1
  47. package/.claude/skills-en/integration-e2e-testing/SKILL.md +3 -1
  48. package/.claude/skills-en/project-context/SKILL.md +3 -1
  49. package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +3 -1
  50. package/.claude/skills-en/task-analyzer/SKILL.md +3 -1
  51. package/.claude/skills-en/technical-spec/SKILL.md +3 -1
  52. package/.claude/skills-en/typescript-rules/SKILL.md +3 -1
  53. package/.claude/skills-en/typescript-testing/SKILL.md +3 -1
  54. package/.claude/skills-ja/coding-standards/SKILL.md +3 -1
  55. package/.claude/skills-ja/documentation-criteria/SKILL.md +3 -1
  56. package/.claude/skills-ja/frontend/technical-spec/SKILL.md +3 -1
  57. package/.claude/skills-ja/frontend/typescript-rules/SKILL.md +3 -1
  58. package/.claude/skills-ja/frontend/typescript-testing/SKILL.md +3 -1
  59. package/.claude/skills-ja/implementation-approach/SKILL.md +3 -1
  60. package/.claude/skills-ja/integration-e2e-testing/SKILL.md +3 -1
  61. package/.claude/skills-ja/project-context/SKILL.md +3 -1
  62. package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +3 -1
  63. package/.claude/skills-ja/task-analyzer/SKILL.md +3 -1
  64. package/.claude/skills-ja/technical-spec/SKILL.md +3 -1
  65. package/.claude/skills-ja/typescript-rules/SKILL.md +3 -1
  66. package/.claude/skills-ja/typescript-testing/SKILL.md +3 -1
  67. package/README.ja.md +28 -1
  68. package/README.md +27 -1
  69. package/package.json +1 -1
@@ -0,0 +1,301 @@
1
+ ---
2
+ name: reverse-engineer
3
+ description: 既存コードベースからPRDとDesign Docを生成するリバースエンジニアリングワークフロー
4
+ ---
5
+
6
+ **コマンドコンテキスト**: 既存コードからドキュメントを作成するリバースエンジニアリングワークフロー
7
+
8
+ 対象: $ARGUMENTS
9
+
10
+ **TodoWrite登録**: まずフェーズをTodoWriteに登録し、各フェーズ開始時に詳細ステップを追加登録する。
11
+
12
+ ## ステップ0: 初期設定
13
+
14
+ ### 0.1 スコープ確認
15
+
16
+ AskUserQuestionで以下を確認:
17
+ 1. **対象パス**: どのディレクトリ/モジュールをドキュメント化するか
18
+ 2. **深度**: PRDのみ、またはPRD + Design Doc
19
+ 3. **参照アーキテクチャ**: layered / mvc / clean / hexagonal / none
20
+ 4. **人間レビュー**: あり(推奨) / なし(自律実行)
21
+
22
+ ### 0.2 出力設定
23
+
24
+ - PRD出力先: `docs/prd/` または既存PRDディレクトリ
25
+ - Design Doc出力先: `docs/design/` または既存Design Docディレクトリ
26
+ - ディレクトリの存在確認、必要に応じて作成
27
+
28
+ ## ワークフロー概要
29
+
30
+ ```
31
+ フェーズ1: PRD生成
32
+ ステップ1: スコープ発見(全ユニット)
33
+ ステップ2-5: ユニット毎ループ(生成 → 検証 → レビュー → 修正)
34
+
35
+ フェーズ2: Design Doc生成(要求された場合)
36
+ ステップ6: スコープ発見(PRD毎の全component)
37
+ ステップ7-10: component毎ループ(生成 → 検証 → レビュー → 修正)
38
+ ```
39
+
40
+ **コンテキスト受け渡し**: ステップ間で構造化JSON出力を受け渡す。`$STEP_N_OUTPUT`プレースホルダー記法を使用。
41
+
42
+ ## フェーズ1: PRD生成
43
+
44
+ **TodoWrite登録**:
45
+ - ステップ1: PRDスコープ発見
46
+ - ユニット毎の処理(各ユニットに対してステップ2-5)
47
+
48
+ ### ステップ1: PRDスコープ発見
49
+
50
+ **Task呼び出し**:
51
+ ```
52
+ subagent_type: scope-discoverer
53
+ prompt: |
54
+ コードベースからPRD対象を発見する。
55
+
56
+ scope_type: prd
57
+ target_path: $USER_TARGET_PATH
58
+ reference_architecture: $USER_RA_CHOICE
59
+ focus_area: $USER_FOCUS_AREA (指定時)
60
+ ```
61
+
62
+ **出力を保存**: `$STEP_1_OUTPUT`
63
+
64
+ **品質ゲート**:
65
+ - 1つ以上のPRDユニットが発見された → 続行
66
+ - ユニットが発見されない → ユーザーにヒントを求める
67
+
68
+ **人間レビューポイント**(有効時): 発見されたユニットを確認用に提示。
69
+
70
+ ### ステップ2-5: ユニット毎の処理
71
+
72
+ **各ユニットについてステップ2→3→4→5を完了してから次のユニットへ進む。**
73
+
74
+ #### ステップ2: PRD生成
75
+
76
+ **Task呼び出し**:
77
+ ```
78
+ subagent_type: prd-creator
79
+ prompt: |
80
+ 以下の機能のリバースエンジニアリングPRDを作成する。
81
+
82
+ 動作モード: reverse-engineer
83
+ External Scope Provided: true
84
+
85
+ 機能: $UNIT_NAME ($STEP_1_OUTPUTより)
86
+ 説明: $UNIT_DESCRIPTION
87
+ 関連ファイル: $UNIT_RELATED_FILES
88
+ エントリーポイント: $UNIT_ENTRY_POINTS
89
+
90
+ 独自のスコープ発見をスキップ。提供されたスコープデータを使用。
91
+ 指定スコープ内でのコード調査に基づき最終版PRDを作成。
92
+ ```
93
+
94
+ **出力を保存**: `$STEP_2_OUTPUT`(PRDパス)
95
+
96
+ #### ステップ3: コード検証
97
+
98
+ **Task呼び出し**:
99
+ ```
100
+ subagent_type: code-verifier
101
+ prompt: |
102
+ PRDとコード実装の整合性を検証する。
103
+
104
+ doc_type: prd
105
+ document_path: $STEP_2_OUTPUT
106
+ code_paths: $UNIT_RELATED_FILES ($STEP_1_OUTPUTより)
107
+ verbose: false
108
+ ```
109
+
110
+ **出力を保存**: `$STEP_3_OUTPUT`
111
+
112
+ **品質ゲート**:
113
+ - consistencyScore >= 70 → レビューへ進む
114
+ - consistencyScore < 70 → 詳細レビュー用にフラグ
115
+
116
+ #### ステップ4: レビュー
117
+
118
+ **必須入力**: $STEP_3_OUTPUT(ステップ3からの検証JSON)
119
+
120
+ **Task呼び出し**:
121
+ ```
122
+ subagent_type: document-reviewer
123
+ prompt: |
124
+ コード検証結果を考慮してPRDをレビューする。
125
+
126
+ doc_type: PRD
127
+ target: $STEP_2_OUTPUT
128
+ mode: composite
129
+
130
+ ## コード検証結果
131
+ $STEP_3_OUTPUT
132
+
133
+ ## 追加レビュー観点
134
+ - PRD主張と検証evidenceの整合性
135
+ - 各不整合に対する解決推奨
136
+ - 未ドキュメント機能カバレッジの完全性
137
+ ```
138
+
139
+ **出力を保存**: `$STEP_4_OUTPUT`
140
+
141
+ #### ステップ5: 修正(条件付き)
142
+
143
+ **トリガー条件**(以下のいずれか):
144
+ - レビューステータスが「Needs Revision」または「Rejected」
145
+ - `$STEP_3_OUTPUT`にクリティカルな不整合が存在
146
+ - consistencyScore < 70
147
+
148
+ **Task呼び出し**:
149
+ ```
150
+ subagent_type: prd-creator
151
+ prompt: |
152
+ レビューフィードバックに基づきPRDを更新する。
153
+
154
+ 動作モード: update
155
+ 既存PRD: $STEP_2_OUTPUT
156
+
157
+ ## レビューフィードバック
158
+ $STEP_4_OUTPUT
159
+
160
+ ## 対処すべき不整合
161
+ ($STEP_3_OUTPUTからcriticalとmajorの不整合を抽出)
162
+
163
+ 修正と改善を適用する。
164
+ ```
165
+
166
+ **ループ制御**: 最大2回の修正サイクル。2サイクル後はステータスに関わらず人間レビュー用にフラグ。
167
+
168
+ #### ユニット完了
169
+
170
+ - [ ] レビューステータスが「Approved」または「Approved with Conditions」
171
+ - [ ] 人間レビュー通過(ステップ0で有効化時)
172
+
173
+ **次へ**: 次のユニットへ進む。全ユニット完了後 → フェーズ2。
174
+
175
+ ## フェーズ2: Design Doc生成
176
+
177
+ *ステップ0でDesign Docが要求された場合のみ実行*
178
+
179
+ **TodoWrite登録**:
180
+ - ステップ6: Design Docスコープ発見
181
+ - component毎の処理(各componentに対してステップ7-10)
182
+
183
+ ### ステップ6: Design Docスコープ発見
184
+
185
+ 承認済みPRD毎に:
186
+
187
+ **Task呼び出し**:
188
+ ```
189
+ subagent_type: scope-discoverer
190
+ prompt: |
191
+ PRDスコープ内でDesign Doc対象を発見する。
192
+
193
+ scope_type: design-doc
194
+ existing_prd: $APPROVED_PRD_PATH
195
+ target_path: $PRD_RELATED_PATHS
196
+ reference_architecture: $USER_RA_CHOICE
197
+ ```
198
+
199
+ **出力を保存**: `$STEP_6_OUTPUT`
200
+
201
+ **品質ゲート**:
202
+ - 1つ以上のcomponentが発見された → 続行
203
+ - componentなし → ユーザーにヒントを求める
204
+
205
+ ### ステップ7-10: component毎の処理
206
+
207
+ **各componentについてステップ7→8→9→10を完了してから次のcomponentへ進む。**
208
+
209
+ #### ステップ7: Design Doc生成
210
+
211
+ **Task呼び出し**:
212
+ ```
213
+ subagent_type: technical-designer
214
+ prompt: |
215
+ 既存コードに基づき以下のcomponentのDesign Docを作成する。
216
+
217
+ 動作モード: create
218
+
219
+ component: $COMPONENT_NAME ($STEP_6_OUTPUTより)
220
+ 責務: $COMPONENT_RESPONSIBILITY
221
+ 主要ファイル: $COMPONENT_PRIMARY_FILES
222
+ public interface: $COMPONENT_PUBLIC_INTERFACES
223
+ 依存関係: $COMPONENT_DEPENDENCIES
224
+
225
+ 親PRD: $APPROVED_PRD_PATH
226
+
227
+ 現在のアーキテクチャをドキュメント化する。変更提案は行わない。
228
+ ```
229
+
230
+ **出力を保存**: `$STEP_7_OUTPUT`
231
+
232
+ #### ステップ8: コード検証
233
+
234
+ **Task呼び出し**:
235
+ ```
236
+ subagent_type: code-verifier
237
+ prompt: |
238
+ Design Docとコード実装の整合性を検証する。
239
+
240
+ doc_type: design-doc
241
+ document_path: $STEP_7_OUTPUT
242
+ code_paths: $COMPONENT_PRIMARY_FILES
243
+ verbose: false
244
+ ```
245
+
246
+ **出力を保存**: `$STEP_8_OUTPUT`
247
+
248
+ #### ステップ9: レビュー
249
+
250
+ **必須入力**: $STEP_8_OUTPUT(ステップ8からの検証JSON)
251
+
252
+ **Task呼び出し**:
253
+ ```
254
+ subagent_type: document-reviewer
255
+ prompt: |
256
+ コード検証結果を考慮してDesign Docをレビューする。
257
+
258
+ doc_type: DesignDoc
259
+ target: $STEP_7_OUTPUT
260
+ mode: composite
261
+
262
+ ## コード検証結果
263
+ $STEP_8_OUTPUT
264
+
265
+ ## 親PRD
266
+ $APPROVED_PRD_PATH
267
+
268
+ ## 追加レビュー観点
269
+ - ドキュメント化されたinterfaceの技術的正確性
270
+ - 親PRDスコープとの整合性
271
+ - component境界定義の完全性
272
+ ```
273
+
274
+ **出力を保存**: `$STEP_9_OUTPUT`
275
+
276
+ #### ステップ10: 修正(条件付き)
277
+
278
+ ステップ5と同様のロジック。updateモードでtechnical-designerを使用。
279
+
280
+ #### component完了
281
+
282
+ - [ ] レビューステータスが「Approved」または「Approved with Conditions」
283
+ - [ ] 人間レビュー通過(ステップ0で有効化時)
284
+
285
+ **次へ**: 次のcomponentへ進む。全component完了後 → 最終レポート。
286
+
287
+ ## 最終レポート
288
+
289
+ 以下を含むサマリを出力:
290
+ - 生成ドキュメント表(タイプ、名前、整合性スコア、レビューステータス)
291
+ - アクション項目(クリティカルな不整合、未ドキュメント機能、フラグ項目)
292
+ - 次のステップチェックリスト
293
+
294
+ ## エラーハンドリング
295
+
296
+ | エラー | アクション |
297
+ |--------|-----------|
298
+ | 発見で何も見つからない | ユーザーにプロジェクト構造のヒントを求める |
299
+ | 生成が失敗 | 失敗をログ、他のユニットで続行、サマリで報告 |
300
+ | consistencyScore < 50 | 必須人間レビュー用にフラグ、自動承認しない |
301
+ | 2回の修正後もレビューが却下 | ループ停止、人間介入用にフラグ |
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: coding-standards
3
- description: Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features, refactoring code, or reviewing code quality.
3
+ description: >
4
+ Detects code smells, anti-patterns, and readability issues. Applies clean code and refactoring principles.
5
+ Use when: implementing features, reviewing code, refactoring, or improving quality.
4
6
  ---
5
7
 
6
8
  # Universal Coding Standards
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: documentation-criteria
3
- description: Documentation creation criteria including PRD, ADR, Design Doc, and Work Plan requirements with templates. Use when creating or reviewing technical documents.
3
+ description: >
4
+ Guides PRD, ADR, Design Doc, and Work Plan creation with templates and decision matrix.
5
+ Use when: planning features, writing specs, creating docs, or deciding which documents are needed.
4
6
  ---
5
7
 
6
8
  # Documentation Creation Criteria
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: frontend/technical-spec
3
- description: Frontend technical design rules including environment variables, architecture design, data flow, and build/testing commands.
3
+ description: >
4
+ Defines frontend environment variables, component design, and data flow patterns.
5
+ Use when: configuring React environment, designing components, or setting up state management.
4
6
  ---
5
7
 
6
8
  # Technical Design Rules (Frontend)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: frontend/typescript-rules
3
- description: React/TypeScript frontend development rules including type safety, component design, state management, and error handling.
3
+ description: >
4
+ Applies React/TypeScript type safety, component design, and state management rules.
5
+ Use when: implementing React components, defining types, designing state, or handling errors.
4
6
  ---
5
7
 
6
8
  # TypeScript Development Rules (Frontend)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: frontend/typescript-testing
3
- description: Frontend testing rules with Vitest, React Testing Library, and MSW. Includes coverage requirements, test design principles, and quality criteria.
3
+ description: >
4
+ Designs tests with React Testing Library and MSW. Applies component testing patterns.
5
+ Use when: writing component tests, mocking APIs, or reviewing frontend test quality.
4
6
  ---
5
7
 
6
8
  # TypeScript Testing Rules (Frontend)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: implementation-approach
3
- description: Implementation strategy selection framework with meta-cognitive approach, verification levels, and integration point definitions.
3
+ description: >
4
+ Selects implementation strategy (vertical slice, horizontal, or hybrid) with risk assessment.
5
+ Use when: planning how to build a feature, deciding development approach, or defining verification levels.
4
6
  ---
5
7
 
6
8
  # Implementation Strategy Selection Framework (Meta-cognitive Approach)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: integration-e2e-testing
3
- description: Integration and E2E test design principles, ROI calculation, test skeleton specification, and review criteria.
3
+ description: >
4
+ Designs integration and E2E tests with mock boundaries and behavior verification rules.
5
+ Use when: writing E2E tests, integration tests, test skeletons, or reviewing test quality.
4
6
  ---
5
7
 
6
8
  # Integration Test & E2E Test Design/Implementation Rules
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: project-context
3
- description: Project-specific context including project nature, technology stack, and implementation principles. Customize for each project.
3
+ description: >
4
+ Provides project-specific tech stack, architecture, and implementation rules.
5
+ Use when: checking project structure, understanding tech stack, or referencing implementation guidelines.
4
6
  ---
5
7
 
6
8
  # Project Context
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: subagents-orchestration-guide
3
- description: Orchestration guide for coordinating subagents through implementation workflows. Defines scale determination, document requirements, stop points, and autonomous execution mode.
3
+ description: >
4
+ Coordinates subagent task distribution and collaboration. Controls scale determination and autonomous execution mode.
5
+ Use when: splitting large tasks, coordinating multiple agents, or designing workflows.
4
6
  ---
5
7
 
6
8
  # Sub-agents Practical Guide - Orchestration Guidelines for Claude (Me)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: task-analyzer
3
- description: Metacognitive task analysis and skill selection. Analyzes task essence, estimates scale, and returns appropriate skills with metadata.
3
+ description: >
4
+ Analyzes task essence and selects appropriate skills. Returns scale estimates and metadata.
5
+ Use when: starting tasks, selecting skills, or judging work scope.
4
6
  ---
5
7
 
6
8
  # Task Analyzer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: technical-spec
3
- description: Technical design rules including environment variable management, architecture design, and build/testing commands.
3
+ description: >
4
+ Defines environment variables, architecture design, and build/test commands.
5
+ Use when: configuring environment, designing architecture, or setting up builds.
4
6
  ---
5
7
 
6
8
  # Technical Design Rules
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: typescript-rules
3
- description: TypeScript development rules for type safety and error handling. Use when implementing TypeScript code or reviewing type definitions.
3
+ description: >
4
+ Applies type safety and error handling rules. Enforces no-any policy and type guards.
5
+ Use when: implementing TypeScript, reviewing types, or designing error handling.
4
6
  ---
5
7
 
6
8
  # TypeScript Development Rules
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: typescript-testing
3
- description: TypeScript testing rules with Vitest. Includes coverage requirements, test design principles, and quality criteria.
3
+ description: >
4
+ Applies Vitest test design and quality standards. Provides coverage requirements and mock usage guides.
5
+ Use when: writing unit tests, using mocks, or reviewing test quality.
4
6
  ---
5
7
 
6
8
  # TypeScript Testing Rules
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: coding-standards
3
- description: 保守性、可読性、品質のための言語非依存コーディング原則。機能実装、リファクタリング、コードレビュー時に使用。
3
+ description: >
4
+ コードの品質問題、アンチパターン、可読性を検査。クリーンコードとリファクタリング原則を適用。
5
+ Use when: 機能実装、コードレビュー、リファクタリング、品質改善時。
4
6
  ---
5
7
 
6
8
  # 普遍的コーディング規約
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: documentation-criteria
3
- description: PRD、ADR、Design Doc、作業計画書を含むドキュメント作成基準とテンプレート。
3
+ description: >
4
+ PRD、ADR、Design Doc、作業計画書の作成を支援。テンプレートと作成判定マトリクスを提供。
5
+ Use when: 機能計画、仕様作成、ドキュメント作成、必要書類の判断時。
4
6
  ---
5
7
 
6
8
  # ドキュメント作成基準
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: frontend/technical-spec
3
- description: 環境変数管理、アーキテクチャ設計、ビルド・テストコマンドを含むフロントエンド技術設計ルール。
3
+ description: >
4
+ フロントエンドの環境変数、コンポーネント設計、データフローを定義。
5
+ Use when: React環境設定、コンポーネント設計、状態管理設計時。
4
6
  ---
5
7
 
6
8
  # 技術設計ルール(フロントエンド)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: frontend/typescript-rules
3
- description: 型安全性、コンポーネント設計、状態管理、エラーハンドリングを含むReact/TypeScriptフロントエンド開発ルール。
3
+ description: >
4
+ React/TypeScriptの型安全性、コンポーネント設計、状態管理ルールを適用。
5
+ Use when: Reactコンポーネント実装、型定義、状態管理設計、エラー処理時。
4
6
  ---
5
7
 
6
8
  # TypeScript 開発ルール(フロントエンド)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: frontend/typescript-testing
3
- description: Vitest、React Testing Library、MSWを使用したフロントエンドテストルール。カバレッジ要件、テスト設計原則、品質基準を含む。
3
+ description: >
4
+ React Testing LibraryとMSWでテストを設計。コンポーネントテストパターンを適用。
5
+ Use when: コンポーネントテスト、APIモック作成、フロントエンドテスト品質レビュー時。
4
6
  ---
5
7
 
6
8
  # TypeScript テストルール(フロントエンド)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: implementation-approach
3
- description: メタ認知的アプローチによる実装戦略選択フレームワーク。確認レベル、統合ポイント定義を含む。
3
+ description: >
4
+ 実装戦略(垂直スライス、水平、ハイブリッド)をリスク評価で選択。
5
+ Use when: 機能の実装計画、開発アプローチ決定、検証レベル定義時。
4
6
  ---
5
7
 
6
8
  # 実装戦略選択フレームワーク(メタ認知的アプローチ)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: integration-e2e-testing
3
- description: 統合・E2Eテスト設計原則、ROI計算、テストスケルトン仕様、レビュー基準。
3
+ description: >
4
+ 統合テストとE2Eテストを設計。モック境界と振る舞い検証ルールを適用。
5
+ Use when: E2Eテスト、統合テスト、テストスケルトン作成、テスト品質レビュー時。
4
6
  ---
5
7
 
6
8
  # 統合テスト・E2Eテスト設計・実装ルール
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: project-context
3
- description: プロジェクトの性質、技術スタック、実装原則を含むプロジェクト固有コンテキスト。各プロジェクトでカスタマイズ可能。
3
+ description: >
4
+ プロジェクト固有の技術スタック、アーキテクチャ、実装ルールを提供。
5
+ Use when: プロジェクト構成確認、技術スタック理解、実装方針参照時。
4
6
  ---
5
7
 
6
8
  # プロジェクトコンテキスト
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: subagents-orchestration-guide
3
- description: サブエージェント間の調整のためのオーケストレーションガイド。規模判定、ドキュメント要件、停止ポイント、自律実行モードを定義。
3
+ description: >
4
+ サブエージェントのタスク分担と連携を調整。規模判定と自律実行モードを制御。
5
+ Use when: 大規模タスク分割、複数エージェント連携、ワークフロー設計時。
4
6
  ---
5
7
 
6
8
  # サブエージェント実践ガイド - オーケストレーション指針
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: task-analyzer
3
- description: メタ認知的タスク分析とスキル選択。タスクの本質を分析し、規模を見積もり、適切なスキルをメタデータと共に返却。
3
+ description: >
4
+ タスクの本質を分析し適切なスキルを選択。規模見積もりとメタデータを返却。
5
+ Use when: タスク開始時、スキル選択、作業規模判断時。
4
6
  ---
5
7
 
6
8
  # タスクアナライザー
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: technical-spec
3
- description: 環境変数管理、アーキテクチャ設計、ビルド・テストコマンドを含む技術設計ルール。
3
+ description: >
4
+ 環境変数、アーキテクチャ設計、ビルド・テストコマンドを定義。
5
+ Use when: 環境設定、アーキテクチャ設計、ビルド設定時。
4
6
  ---
5
7
 
6
8
  # 技術設計ルール
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: typescript-rules
3
- description: 型安全性とエラーハンドリングのためのTypeScript開発ルール。TypeScriptコード実装や型定義レビュー時に使用。
3
+ description: >
4
+ 型安全性とエラーハンドリングルールを適用。any禁止、型ガード必須。
5
+ Use when: TypeScript実装、型定義レビュー、エラー処理設計時。
4
6
  ---
5
7
 
6
8
  # TypeScript 開発ルール
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: typescript-testing
3
- description: Vitestを使用したTypeScriptテストルール。カバレッジ要件、テスト設計原則、品質基準を含む。
3
+ description: >
4
+ Vitestテスト設計と品質基準を適用。カバレッジ要件とモック使用ガイドを提供。
5
+ Use when: ユニットテスト作成、モック使用、テスト品質レビュー時。
4
6
  ---
5
7
 
6
8
  # TypeScript テストルール
package/README.ja.md CHANGED
@@ -128,6 +128,7 @@ Claude Codeで利用できる主要なコマンド:
128
128
  | `/front-plan` | フロントエンド作業計画書を作成 | フロントエンド設計承認後 |
129
129
  | `/front-build` | フロントエンド実装の実行 | Reactコンポーネント開発 |
130
130
  | `/diagnose` | 根本原因分析ワークフロー | デバッグ、トラブルシューティング |
131
+ | `/reverse-engineer` | コードからPRD/Design Docを生成 | 既存システムのドキュメント化 |
131
132
 
132
133
  [コマンドの詳細はこちら →](docs/guides/ja/use-cases.md)
133
134
 
@@ -139,12 +140,36 @@ graph LR
139
140
  B -->|小規模| C[直接実装]
140
141
  B -->|中規模| D[設計 → 実装]
141
142
  B -->|大規模| E[PRD → 設計 → 実装]
142
-
143
+
143
144
  C --> F[品質チェック → コミット]
144
145
  D --> F
145
146
  E --> F
146
147
  ```
147
148
 
149
+ ### リバースエンジニアリングワークフロー
150
+
151
+ ```mermaid
152
+ graph TB
153
+ subgraph フェーズ1 [フェーズ1: PRD生成]
154
+ A1[スコープ発見] --> A2[PRD生成]
155
+ A2 --> A3[コード検証]
156
+ A3 --> A4[レビュー]
157
+ A4 -->|修正要| A2
158
+ A4 -->|承認| A5[次のユニット]
159
+ end
160
+
161
+ subgraph フェーズ2 [フェーズ2: Design Doc生成]
162
+ B1[コンポーネント発見] --> B2[Design Doc生成]
163
+ B2 --> B3[コード検証]
164
+ B3 --> B4[レビュー]
165
+ B4 -->|修正要| B2
166
+ B4 -->|承認| B5[次のコンポーネント]
167
+ end
168
+
169
+ A5 --> B1
170
+ B5 --> C[最終レポート]
171
+ ```
172
+
148
173
  ### 動作の仕組み
149
174
 
150
175
  1. **要件分析**: `/implement`コマンドがタスクの規模を判断します
@@ -254,6 +279,8 @@ A: これらのツールはコード記述の支援に特化していますが
254
279
  | **investigator** | 問題調査 | `/diagnose` ステップ1 |
255
280
  | **verifier** | 調査結果の検証 | `/diagnose` ステップ3 |
256
281
  | **solver** | 解決策の導出 | `/diagnose` ステップ4 |
282
+ | **scope-discoverer** | PRD/Design Docスコープ発見 | `/reverse-engineer` ステップ1, 6 |
283
+ | **code-verifier** | ドキュメントとコードの整合性検証 | `/reverse-engineer` ステップ3, 8 |
257
284
 
258
285
  [エージェントの詳細 →](.claude/agents-ja/)
259
286