create-ai-project 1.13.1 → 1.14.0

package/.claude/commands-en/reverse-engineer.md

@@ -0,0 +1,301 @@
+---
+name: reverse-engineer
+description: Generate PRD and Design Docs from existing codebase through discovery, generation, verification, and review workflow
+---
+
+**Command Context**: Reverse engineering workflow to create documentation from existing code
+
+Target: $ARGUMENTS
+
+**TodoWrite**: Register phases first, then steps within each phase as you enter it.
+
+## Step 0: Initial Configuration
+
+### 0.1 Scope Confirmation
+
+Use AskUserQuestion to confirm:
+1. **Target path**: Which directory/module to document
+2. **Depth**: PRD only, or PRD + Design Docs
+3. **Reference Architecture**: layered / mvc / clean / hexagonal / none
+4. **Human review**: Yes (recommended) / No (fully autonomous)
+
+### 0.2 Output Configuration
+
+- PRD output: `docs/prd/` or existing PRD directory
+- Design Doc output: `docs/design/` or existing design directory
+- Verify directories exist, create if needed
+
+## Workflow Overview
+
+```
+Phase 1: PRD Generation
+  Step 1: Scope Discovery (all units)
+  Step 2-5: Per-unit loop (Generation → Verification → Review → Revision)
+
+Phase 2: Design Doc Generation (if requested)
+  Step 6: Scope Discovery (all components per PRD)
+  Step 7-10: Per-component loop (Generation → Verification → Review → Revision)
+```
+
+**Context Passing**: Pass structured JSON output between steps. Use `$STEP_N_OUTPUT` placeholder notation.
+
+## Phase 1: PRD Generation
+
+**Register in TodoWrite**:
+- Step 1: PRD Scope Discovery
+- Per-unit processing (Steps 2-5 for each unit)
+
+### Step 1: PRD Scope Discovery
+
+**Task invocation**:
+```
+subagent_type: scope-discoverer
+prompt: |
+  Discover PRD targets in the codebase.
+
+  scope_type: prd
+  target_path: $USER_TARGET_PATH
+  reference_architecture: $USER_RA_CHOICE
+  focus_area: $USER_FOCUS_AREA (if specified)
+```
+
+**Store output as**: `$STEP_1_OUTPUT`
+
+**Quality Gate**:
+- At least one PRD unit discovered → proceed
+- No units discovered → ask user for hints
+
+**Human Review Point** (if enabled): Present discovered units for confirmation.
+
+### Step 2-5: Per-Unit Processing
+
+**Complete Steps 2→3→4→5 for each unit before proceeding to the next unit.**
+
+#### Step 2: PRD Generation
+
+**Task invocation**:
+```
+subagent_type: prd-creator
+prompt: |
+  Create reverse-engineered PRD for the following feature.
+
+  Operation Mode: reverse-engineer
+  External Scope Provided: true
+
+  Feature: $UNIT_NAME (from $STEP_1_OUTPUT)
+  Description: $UNIT_DESCRIPTION
+  Related Files: $UNIT_RELATED_FILES
+  Entry Points: $UNIT_ENTRY_POINTS
+
+  Skip independent scope discovery. Use provided scope data.
+  Create final version PRD based on code investigation within specified scope.
+```
+
+**Store output as**: `$STEP_2_OUTPUT` (PRD path)
+
+#### Step 3: Code Verification
+
+**Task invocation**:
+```
+subagent_type: code-verifier
+prompt: |
+  Verify consistency between PRD and code implementation.
+
+  doc_type: prd
+  document_path: $STEP_2_OUTPUT
+  code_paths: $UNIT_RELATED_FILES (from $STEP_1_OUTPUT)
+  verbose: false
+```
+
+**Store output as**: `$STEP_3_OUTPUT`
+
+**Quality Gate**:
+- consistencyScore >= 70 → proceed to review
+- consistencyScore < 70 → flag for detailed review
+
+#### Step 4: Review
+
+**Required Input**: $STEP_3_OUTPUT (verification JSON from Step 3)
+
+**Task invocation**:
+```
+subagent_type: document-reviewer
+prompt: |
+  Review the following PRD considering code verification findings.
+
+  doc_type: PRD
+  target: $STEP_2_OUTPUT
+  mode: composite
+
+  ## Code Verification Results
+  $STEP_3_OUTPUT
+
+  ## Additional Review Focus
+  - Alignment between PRD claims and verification evidence
+  - Resolution recommendations for each discrepancy
+  - Completeness of undocumented feature coverage
+```
+
+**Store output as**: `$STEP_4_OUTPUT`
+
+#### Step 5: Revision (conditional)
+
+**Trigger Conditions** (any one of the following):
+- Review status is "Needs Revision" or "Rejected"
+- Critical discrepancies exist in `$STEP_3_OUTPUT`
+- consistencyScore < 70
+
+**Task invocation**:
+```
+subagent_type: prd-creator
+prompt: |
+  Update PRD based on review feedback.
+
+  Operation Mode: update
+  Existing PRD: $STEP_2_OUTPUT
+
+  ## Review Feedback
+  $STEP_4_OUTPUT
+
+  ## Discrepancies to Address
+  (Extract critical and major discrepancies from $STEP_3_OUTPUT)
+
+  Apply corrections and improvements.
+```
+
+**Loop Control**: Maximum 2 revision cycles. After 2 cycles, flag for human review regardless of status.
+
+#### Unit Completion
+
+- [ ] Review status is "Approved" or "Approved with Conditions"
+- [ ] Human review passed (if enabled in Step 0)
+
+**Next**: Proceed to next unit. After all units → Phase 2.
+
+## Phase 2: Design Doc Generation
+
+*Execute only if Design Docs were requested in Step 0*
+
+**Register in TodoWrite**:
+- Step 6: Design Doc Scope Discovery
+- Per-component processing (Steps 7-10 for each component)
+
+### Step 6: Design Doc Scope Discovery
+
+For each approved PRD:
+
+**Task invocation**:
+```
+subagent_type: scope-discoverer
+prompt: |
+  Discover Design Doc targets within PRD scope.
+
+  scope_type: design-doc
+  existing_prd: $APPROVED_PRD_PATH
+  target_path: $PRD_RELATED_PATHS
+  reference_architecture: $USER_RA_CHOICE
+```
+
+**Store output as**: `$STEP_6_OUTPUT`
+
+**Quality Gate**:
+- At least one component discovered → proceed
+- No components → ask user for hints
+
+### Step 7-10: Per-Component Processing
+
+**Complete Steps 7→8→9→10 for each component before proceeding to the next component.**
+
+#### Step 7: Design Doc Generation
+
+**Task invocation**:
+```
+subagent_type: technical-designer
+prompt: |
+  Create Design Doc for the following component based on existing code.
+
+  Operation Mode: create
+
+  Component: $COMPONENT_NAME (from $STEP_6_OUTPUT)
+  Responsibility: $COMPONENT_RESPONSIBILITY
+  Primary Files: $COMPONENT_PRIMARY_FILES
+  Public Interfaces: $COMPONENT_PUBLIC_INTERFACES
+  Dependencies: $COMPONENT_DEPENDENCIES
+
+  Parent PRD: $APPROVED_PRD_PATH
+
+  Document current architecture. Do not propose changes.
+```
+
+**Store output as**: `$STEP_7_OUTPUT`
+
+#### Step 8: Code Verification
+
+**Task invocation**:
+```
+subagent_type: code-verifier
+prompt: |
+  Verify consistency between Design Doc and code implementation.
+
+  doc_type: design-doc
+  document_path: $STEP_7_OUTPUT
+  code_paths: $COMPONENT_PRIMARY_FILES
+  verbose: false
+```
+
+**Store output as**: `$STEP_8_OUTPUT`
+
+#### Step 9: Review
+
+**Required Input**: $STEP_8_OUTPUT (verification JSON from Step 8)
+
+**Task invocation**:
+```
+subagent_type: document-reviewer
+prompt: |
+  Review the following Design Doc considering code verification findings.
+
+  doc_type: DesignDoc
+  target: $STEP_7_OUTPUT
+  mode: composite
+
+  ## Code Verification Results
+  $STEP_8_OUTPUT
+
+  ## Parent PRD
+  $APPROVED_PRD_PATH
+
+  ## Additional Review Focus
+  - Technical accuracy of documented interfaces
+  - Consistency with parent PRD scope
+  - Completeness of component boundary definitions
+```
+
+**Store output as**: `$STEP_9_OUTPUT`
+
+#### Step 10: Revision (conditional)
+
+Same logic as Step 5, using technical-designer with update mode.
+
+#### Component Completion
+
+- [ ] Review status is "Approved" or "Approved with Conditions"
+- [ ] Human review passed (if enabled in Step 0)
+
+**Next**: Proceed to next component. After all components → Final Report.
+
+## Final Report
+
+Output summary including:
+- Generated documents table (Type, Name, Consistency Score, Review Status)
+- Action items (critical discrepancies, undocumented features, flagged items)
+- Next steps checklist
+
+## Error Handling
+
+| Error | Action |
+|-------|--------|
+| Discovery finds nothing | Ask user for project structure hints |
+| Generation fails | Log failure, continue with other units, report in summary |
+| consistencyScore < 50 | Flag for mandatory human review, do not auto-approve |
+| Review rejects after 2 revisions | Stop loop, flag for human intervention |

package/.claude/commands-ja/reverse-engineer.md

@@ -0,0 +1,301 @@
+---
+name: reverse-engineer
+description: 既存コードベースからPRDとDesign Docを生成するリバースエンジニアリングワークフロー
+---
+
+**コマンドコンテキスト**: 既存コードからドキュメントを作成するリバースエンジニアリングワークフロー
+
+対象: $ARGUMENTS
+
+**TodoWrite登録**: まずフェーズをTodoWriteに登録し、各フェーズ開始時に詳細ステップを追加登録する。
+
+## ステップ0: 初期設定
+
+### 0.1 スコープ確認
+
+AskUserQuestionで以下を確認:
+1. **対象パス**: どのディレクトリ/モジュールをドキュメント化するか
+2. **深度**: PRDのみ、またはPRD + Design Doc
+3. **参照アーキテクチャ**: layered / mvc / clean / hexagonal / none
+4. **人間レビュー**: あり（推奨） / なし（自律実行）
+
+### 0.2 出力設定
+
+- PRD出力先: `docs/prd/` または既存PRDディレクトリ
+- Design Doc出力先: `docs/design/` または既存Design Docディレクトリ
+- ディレクトリの存在確認、必要に応じて作成
+
+## ワークフロー概要
+
+```
+フェーズ1: PRD生成
+  ステップ1: スコープ発見（全ユニット）
+  ステップ2-5: ユニット毎ループ（生成 → 検証 → レビュー → 修正）
+
+フェーズ2: Design Doc生成（要求された場合）
+  ステップ6: スコープ発見（PRD毎の全component）
+  ステップ7-10: component毎ループ（生成 → 検証 → レビュー → 修正）
+```
+
+**コンテキスト受け渡し**: ステップ間で構造化JSON出力を受け渡す。`$STEP_N_OUTPUT`プレースホルダー記法を使用。
+
+## フェーズ1: PRD生成
+
+**TodoWrite登録**:
+- ステップ1: PRDスコープ発見
+- ユニット毎の処理（各ユニットに対してステップ2-5）
+
+### ステップ1: PRDスコープ発見
+
+**Task呼び出し**:
+```
+subagent_type: scope-discoverer
+prompt: |
+  コードベースからPRD対象を発見する。
+
+  scope_type: prd
+  target_path: $USER_TARGET_PATH
+  reference_architecture: $USER_RA_CHOICE
+  focus_area: $USER_FOCUS_AREA (指定時)
+```
+
+**出力を保存**: `$STEP_1_OUTPUT`
+
+**品質ゲート**:
+- 1つ以上のPRDユニットが発見された → 続行
+- ユニットが発見されない → ユーザーにヒントを求める
+
+**人間レビューポイント**（有効時）: 発見されたユニットを確認用に提示。
+
+### ステップ2-5: ユニット毎の処理
+
+**各ユニットについてステップ2→3→4→5を完了してから次のユニットへ進む。**
+
+#### ステップ2: PRD生成
+
+**Task呼び出し**:
+```
+subagent_type: prd-creator
+prompt: |
+  以下の機能のリバースエンジニアリングPRDを作成する。
+
+  動作モード: reverse-engineer
+  External Scope Provided: true
+
+  機能: $UNIT_NAME ($STEP_1_OUTPUTより)
+  説明: $UNIT_DESCRIPTION
+  関連ファイル: $UNIT_RELATED_FILES
+  エントリーポイント: $UNIT_ENTRY_POINTS
+
+  独自のスコープ発見をスキップ。提供されたスコープデータを使用。
+  指定スコープ内でのコード調査に基づき最終版PRDを作成。
+```
+
+**出力を保存**: `$STEP_2_OUTPUT`（PRDパス）
+
+#### ステップ3: コード検証
+
+**Task呼び出し**:
+```
+subagent_type: code-verifier
+prompt: |
+  PRDとコード実装の整合性を検証する。
+
+  doc_type: prd
+  document_path: $STEP_2_OUTPUT
+  code_paths: $UNIT_RELATED_FILES ($STEP_1_OUTPUTより)
+  verbose: false
+```
+
+**出力を保存**: `$STEP_3_OUTPUT`
+
+**品質ゲート**:
+- consistencyScore >= 70 → レビューへ進む
+- consistencyScore < 70 → 詳細レビュー用にフラグ
+
+#### ステップ4: レビュー
+
+**必須入力**: $STEP_3_OUTPUT（ステップ3からの検証JSON）
+
+**Task呼び出し**:
+```
+subagent_type: document-reviewer
+prompt: |
+  コード検証結果を考慮してPRDをレビューする。
+
+  doc_type: PRD
+  target: $STEP_2_OUTPUT
+  mode: composite
+
+  ## コード検証結果
+  $STEP_3_OUTPUT
+
+  ## 追加レビュー観点
+  - PRD主張と検証evidenceの整合性
+  - 各不整合に対する解決推奨
+  - 未ドキュメント機能カバレッジの完全性
+```
+
+**出力を保存**: `$STEP_4_OUTPUT`
+
+#### ステップ5: 修正（条件付き）
+
+**トリガー条件**（以下のいずれか）:
+- レビューステータスが「Needs Revision」または「Rejected」
+- `$STEP_3_OUTPUT`にクリティカルな不整合が存在
+- consistencyScore < 70
+
+**Task呼び出し**:
+```
+subagent_type: prd-creator
+prompt: |
+  レビューフィードバックに基づきPRDを更新する。
+
+  動作モード: update
+  既存PRD: $STEP_2_OUTPUT
+
+  ## レビューフィードバック
+  $STEP_4_OUTPUT
+
+  ## 対処すべき不整合
+  （$STEP_3_OUTPUTからcriticalとmajorの不整合を抽出）
+
+  修正と改善を適用する。
+```
+
+**ループ制御**: 最大2回の修正サイクル。2サイクル後はステータスに関わらず人間レビュー用にフラグ。
+
+#### ユニット完了
+
+- [ ] レビューステータスが「Approved」または「Approved with Conditions」
+- [ ] 人間レビュー通過（ステップ0で有効化時）
+
+**次へ**: 次のユニットへ進む。全ユニット完了後 → フェーズ2。
+
+## フェーズ2: Design Doc生成
+
+*ステップ0でDesign Docが要求された場合のみ実行*
+
+**TodoWrite登録**:
+- ステップ6: Design Docスコープ発見
+- component毎の処理（各componentに対してステップ7-10）
+
+### ステップ6: Design Docスコープ発見
+
+承認済みPRD毎に:
+
+**Task呼び出し**:
+```
+subagent_type: scope-discoverer
+prompt: |
+  PRDスコープ内でDesign Doc対象を発見する。
+
+  scope_type: design-doc
+  existing_prd: $APPROVED_PRD_PATH
+  target_path: $PRD_RELATED_PATHS
+  reference_architecture: $USER_RA_CHOICE
+```
+
+**出力を保存**: `$STEP_6_OUTPUT`
+
+**品質ゲート**:
+- 1つ以上のcomponentが発見された → 続行
+- componentなし → ユーザーにヒントを求める
+
+### ステップ7-10: component毎の処理
+
+**各componentについてステップ7→8→9→10を完了してから次のcomponentへ進む。**
+
+#### ステップ7: Design Doc生成
+
+**Task呼び出し**:
+```
+subagent_type: technical-designer
+prompt: |
+  既存コードに基づき以下のcomponentのDesign Docを作成する。
+
+  動作モード: create
+
+  component: $COMPONENT_NAME ($STEP_6_OUTPUTより)
+  責務: $COMPONENT_RESPONSIBILITY
+  主要ファイル: $COMPONENT_PRIMARY_FILES
+  public interface: $COMPONENT_PUBLIC_INTERFACES
+  依存関係: $COMPONENT_DEPENDENCIES
+
+  親PRD: $APPROVED_PRD_PATH
+
+  現在のアーキテクチャをドキュメント化する。変更提案は行わない。
+```
+
+**出力を保存**: `$STEP_7_OUTPUT`
+
+#### ステップ8: コード検証
+
+**Task呼び出し**:
+```
+subagent_type: code-verifier
+prompt: |
+  Design Docとコード実装の整合性を検証する。
+
+  doc_type: design-doc
+  document_path: $STEP_7_OUTPUT
+  code_paths: $COMPONENT_PRIMARY_FILES
+  verbose: false
+```
+
+**出力を保存**: `$STEP_8_OUTPUT`
+
+#### ステップ9: レビュー
+
+**必須入力**: $STEP_8_OUTPUT（ステップ8からの検証JSON）
+
+**Task呼び出し**:
+```
+subagent_type: document-reviewer
+prompt: |
+  コード検証結果を考慮してDesign Docをレビューする。
+
+  doc_type: DesignDoc
+  target: $STEP_7_OUTPUT
+  mode: composite
+
+  ## コード検証結果
+  $STEP_8_OUTPUT
+
+  ## 親PRD
+  $APPROVED_PRD_PATH
+
+  ## 追加レビュー観点
+  - ドキュメント化されたinterfaceの技術的正確性
+  - 親PRDスコープとの整合性
+  - component境界定義の完全性
+```
+
+**出力を保存**: `$STEP_9_OUTPUT`
+
+#### ステップ10: 修正（条件付き）
+
+ステップ5と同様のロジック。updateモードでtechnical-designerを使用。
+
+#### component完了
+
+- [ ] レビューステータスが「Approved」または「Approved with Conditions」
+- [ ] 人間レビュー通過（ステップ0で有効化時）
+
+**次へ**: 次のcomponentへ進む。全component完了後 → 最終レポート。
+
+## 最終レポート
+
+以下を含むサマリを出力:
+- 生成ドキュメント表（タイプ、名前、整合性スコア、レビューステータス）
+- アクション項目（クリティカルな不整合、未ドキュメント機能、フラグ項目）
+- 次のステップチェックリスト
+
+## エラーハンドリング
+
+| エラー | アクション |
+|--------|-----------|
+| 発見で何も見つからない | ユーザーにプロジェクト構造のヒントを求める |
+| 生成が失敗 | 失敗をログ、他のユニットで続行、サマリで報告 |
+| consistencyScore < 50 | 必須人間レビュー用にフラグ、自動承認しない |
+| 2回の修正後もレビューが却下 | ループ停止、人間介入用にフラグ |

package/README.ja.md

@@ -128,6 +128,7 @@ Claude Codeで利用できる主要なコマンド：
 | `/front-plan` | フロントエンド作業計画書を作成 | フロントエンド設計承認後 |
 | `/front-build` | フロントエンド実装の実行 | Reactコンポーネント開発 |
 | `/diagnose` | 根本原因分析ワークフロー | デバッグ、トラブルシューティング |
+| `/reverse-engineer` | コードからPRD/Design Docを生成 | 既存システムのドキュメント化 |
 
 [コマンドの詳細はこちら →](docs/guides/ja/use-cases.md)
 
@@ -139,12 +140,36 @@ graph LR
     B -->|小規模| C[直接実装]
     B -->|中規模| D[設計 → 実装]
     B -->|大規模| E[PRD → 設計 → 実装]
-    
+
     C --> F[品質チェック → コミット]
     D --> F
     E --> F
 ```
 
+### リバースエンジニアリングワークフロー
+
+```mermaid
+graph TB
+    subgraph フェーズ1 [フェーズ1: PRD生成]
+        A1[スコープ発見] --> A2[PRD生成]
+        A2 --> A3[コード検証]
+        A3 --> A4[レビュー]
+        A4 -->|修正要| A2
+        A4 -->|承認| A5[次のユニット]
+    end
+
+    subgraph フェーズ2 [フェーズ2: Design Doc生成]
+        B1[コンポーネント発見] --> B2[Design Doc生成]
+        B2 --> B3[コード検証]
+        B3 --> B4[レビュー]
+        B4 -->|修正要| B2
+        B4 -->|承認| B5[次のコンポーネント]
+    end
+
+    A5 --> B1
+    B5 --> C[最終レポート]
+```
+
 ### 動作の仕組み
 
 1. **要件分析**: `/implement`コマンドがタスクの規模を判断します
@@ -254,6 +279,8 @@ A: これらのツールはコード記述の支援に特化していますが
 | **investigator** | 問題調査 | `/diagnose` ステップ1 |
 | **verifier** | 調査結果の検証 | `/diagnose` ステップ3 |
 | **solver** | 解決策の導出 | `/diagnose` ステップ4 |
+| **scope-discoverer** | PRD/Design Docスコープ発見 | `/reverse-engineer` ステップ1, 6 |
+| **code-verifier** | ドキュメントとコードの整合性検証 | `/reverse-engineer` ステップ3, 8 |
 
 [エージェントの詳細 →](.claude/agents-ja/)
 

package/README.md

@@ -134,6 +134,7 @@ Essential commands for Claude Code:
 | `/front-plan` | Create frontend work plan | After frontend design approval |
 | `/front-build` | Execute frontend implementation | React component development |
 | `/diagnose` | Root cause analysis workflow | Debugging, troubleshooting |
+| `/reverse-engineer` | Generate PRD/Design Docs from code | Legacy system documentation |
 
 [Full command reference →](docs/guides/en/use-cases.md)
 
@@ -145,12 +146,35 @@ graph LR
     B -->|Small| C[Direct Implementation]
     B -->|Medium| D[Design → Implementation]
     B -->|Large| E[PRD → Design → Implementation]
-    
+
     C --> F[Quality Check → Commit]
     D --> F
     E --> F
 ```
 
+### Reverse Engineering Workflow
+
+Generate PRD and Design Docs from existing code:
+
+```mermaid
+graph TB
+    subgraph Phase1[Phase 1: PRD Generation]
+        CMD[/reverse-engineer] --> SD1[scope-discoverer]
+        SD1 --> PRD[prd-creator]
+        PRD --> CV1[code-verifier]
+        CV1 --> DR1[document-reviewer]
+    end
+
+    subgraph Phase2[Phase 2: Design Doc Generation]
+        SD2[scope-discoverer] --> DD[technical-designer]
+        DD --> CV2[code-verifier]
+        CV2 --> DR2[document-reviewer]
+        DR2 --> DONE[Complete]
+    end
+
+    DR1 --> |All PRDs Approved| SD2
+```
+
 ### How It Works
 
 1. **Requirement Analysis**: `/implement` command analyzes task scale
@@ -260,6 +284,8 @@ A: Those help write code. This manages entire development lifecycle with special
 | **investigator** | Problem investigation | `/diagnose` Step 1 |
 | **verifier** | Investigation verification | `/diagnose` Step 3 |
 | **solver** | Solution derivation | `/diagnose` Step 4 |
+| **scope-discoverer** | PRD/Design Doc scope discovery | `/reverse-engineer` Step 1 |
+| **code-verifier** | Document-code consistency | `/reverse-engineer` verification |
 
 [Full agent list →](.claude/agents-en/)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ai-project",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "packageManager": "npm@10.8.2",
   "description": "TypeScript boilerplate with skills and sub-agents for Claude Code. Prevents context exhaustion through role-based task splitting.",
   "keywords": [