create-ai-project 1.14.12 → 1.14.13

package/.claude/commands-en/add-integration-tests.md

@@ -1,5 +1,4 @@
 ---
-name: add-integration-tests
 description: Add integration/E2E tests to existing backend codebase using Design Doc
 ---
 

package/.claude/commands-en/front-reverse-design.md

@@ -1,5 +1,4 @@
 ---
-name: front-reverse-design
 description: Generate frontend Design Docs from existing codebase using existing PRD
 ---
 

package/.claude/commands-en/front-review.md

@@ -1,5 +1,4 @@
 ---
-name: front-review
 description: Design Doc compliance validation with optional auto-fixes
 ---
 

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

@@ -1,5 +1,4 @@
 ---
-name: reverse-engineer
 description: Generate PRD and Design Docs from existing codebase through discovery, generation, verification, and review workflow
 ---
 

package/.claude/commands-en/update-doc.md

@@ -0,0 +1,178 @@
+---
+description: Update existing design documents (Design Doc / PRD / ADR) with review
+---
+
+**Command Context**: This command is dedicated to updating existing design documents.
+
+## Orchestrator Definition
+
+**Core Identity**: "I am not a worker. I am an orchestrator." (see subagents-orchestration-guide skill)
+
+**First Action**: Register Steps 1-6 to TodoWrite before any execution.
+
+**Execution Protocol**:
+1. **Delegate all work** to sub-agents (NEVER edit documents yourself)
+2. **Execute update flow**:
+   - Identify target → Clarify changes → Update document → Review → Consistency check
+   - **Stop at every `[Stop: ...]` marker** → Wait for user approval before proceeding
+3. **Scope**: Complete when updated document receives approval
+
+**CRITICAL**: NEVER skip document-reviewer or stopping points.
+
+## Workflow Overview
+
+```
+Target document → [Stop: Confirm changes]
+                        ↓
+              technical-designer / prd-creator (update mode)
+                        ↓
+              document-reviewer → [Stop: Review approval]
+                        ↓ (Design Doc only)
+              design-sync → [Stop: Final approval]
+```
+
+## Scope Boundaries
+
+**Included in this command**:
+- Existing document identification and selection
+- Change content clarification with user
+- Document update with appropriate agent (update mode)
+- Document review with document-reviewer
+- Consistency verification with design-sync (Design Doc only)
+
+**NOT included**:
+- New requirement analysis (use /design for new documents)
+- Work planning or implementation (use /plan or /task after this command)
+
+**Responsibility Boundary**: This command completes with updated document approval.
+
+Target document: $ARGUMENTS
+
+## Execution Flow
+
+### Step 1: Target Document Identification
+
+```bash
+# Check existing documents
+ls docs/design/*.md docs/prd/*.md docs/adr/*.md 2>/dev/null | grep -v template
+```
+
+**Decision flow**:
+
+| Situation | Action |
+|-----------|--------|
+| $ARGUMENTS specifies a path | Use specified document |
+| $ARGUMENTS describes a topic | Search documents matching the topic |
+| Multiple candidates found | Present options with AskUserQuestion |
+| No documents found | Report and end (suggest /design instead) |
+
+### Step 2: Document Type Determination
+
+Determine type from document path:
+
+| Path Pattern | Type | Update Agent | Notes |
+|-------------|------|--------------|-------|
+| `docs/design/*.md` | Design Doc | technical-designer | - |
+| `docs/prd/*.md` | PRD | prd-creator | - |
+| `docs/adr/*.md` | ADR | technical-designer | Minor changes: update existing file; Major changes: create new ADR file |
+
+**ADR Update Guidance**:
+- **Minor changes** (clarification, typo fix, small scope adjustment): Update the existing ADR file
+- **Major changes** (decision reversal, significant scope change): Create a new ADR that supersedes the original
+
+### Step 3: Change Content Clarification [Stop]
+
+Use AskUserQuestion to clarify what changes are needed:
+- What sections need updating
+- Reason for the change (bug fix findings, spec change, review feedback, etc.)
+- Expected outcome after the update
+
+Confirm understanding of changes with user before proceeding.
+
+### Step 4: Document Update
+
+Invoke the update agent determined in Step 2:
+```
+subagent_type: [Update Agent from Step 2]
+description: "Update [Type from Step 2]"
+prompt: |
+  Operation Mode: update
+  Existing Document: [path from Step 1]
+
+  ## Changes Required
+  [Changes clarified in Step 3]
+
+  Update the document to reflect the specified changes.
+  Add change history entry.
+```
+
+### Step 5: Document Review [Stop]
+
+Invoke document-reviewer:
+```
+subagent_type: document-reviewer
+description: "Review updated document"
+prompt: |
+  Review the following updated document.
+
+  doc_type: [Design Doc / PRD / ADR]
+  target: [path from Step 1]
+  mode: standard
+
+  Focus on:
+  - Consistency of updated sections with rest of document
+  - No contradictions introduced by changes
+  - Completeness of change history
+```
+
+**On review result**:
+- Approved → Proceed to Step 6
+- Needs revision → Return to Step 4 with reviewer feedback (max 2 iterations)
+- **After 2 rejections** → Flag for human review, present accumulated feedback to user and end
+
+Present review result to user for approval.
+
+### Step 6: Consistency Verification (Design Doc only) [Stop]
+
+**Skip condition**: Document type is PRD or ADR → Proceed to completion.
+
+For Design Doc, invoke design-sync:
+```
+subagent_type: design-sync
+description: "Verify consistency"
+prompt: |
+  Verify consistency of the updated Design Doc with other design documents.
+
+  Updated document: [path from Step 1]
+```
+
+**On consistency result**:
+- No conflicts → Present result to user for final approval
+- Conflicts detected → Present conflicts to user with AskUserQuestion:
+  - A: Return to Step 4 to resolve conflicts in this document
+  - B: End command and address conflicts separately
+
+## Error Handling
+
+| Error | Action |
+|-------|--------|
+| Target document not found | Report and end (suggest /design instead) |
+| Sub-agent update fails | Log failure, present error to user, retry once |
+| Review rejects after 2 revisions | Stop loop, flag for human intervention |
+| design-sync detects conflicts | Present to user for resolution decision |
+
+## Completion Criteria
+
+- [ ] Identified target document
+- [ ] Clarified change content with user
+- [ ] Updated document with appropriate agent (update mode)
+- [ ] Executed document-reviewer and addressed feedback
+- [ ] Executed design-sync for consistency verification (Design Doc only)
+- [ ] Obtained user approval for updated document
+
+## Output Example
+Document update completed.
+- Updated document: docs/design/[document-name].md
+- Approval status: User approved
+
+**Important**: This command ends with document approval. Does not propose transition to next phase.

package/.claude/commands-ja/add-integration-tests.md

@@ -1,5 +1,4 @@
 ---
-name: add-integration-tests
 description: Design Docを使用して既存バックエンドコードベースに統合/E2Eテストを追加
 ---
 

package/.claude/commands-ja/front-reverse-design.md

@@ -1,5 +1,4 @@
 ---
-name: front-reverse-design
 description: 既存PRDを使用して既存コードベースからフロントエンドDesign Docを生成
 ---
 

package/.claude/commands-ja/front-review.md

@@ -1,5 +1,4 @@
 ---
-name: front-review
 description: Design Doc準拠検証と必要に応じた自動修正
 ---
 

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

@@ -1,5 +1,4 @@
 ---
-name: reverse-engineer
 description: 既存コードベースからPRDとDesign Docを生成するリバースエンジニアリングワークフロー
 ---
 

package/.claude/commands-ja/update-doc.md

@@ -0,0 +1,178 @@
+---
+description: 既存設計ドキュメント（Design Doc / PRD / ADR）をレビュー付きで更新
+---
+
+**コマンドコンテキスト**: このコマンドは既存設計ドキュメントの更新専用です。
+
+## オーケストレーター定義
+
+**コアアイデンティティ**: 「私は作業者ではない。オーケストレーターである。」（subagents-orchestration-guideスキル参照）
+
+**初期アクション**: 実行前にステップ1-6をTodoWriteに登録する。
+
+**実行プロトコル**:
+1. **全作業をサブエージェントに委譲**（自分でドキュメントを編集しない）
+2. **更新フローを実行**:
+   - 対象特定 → 変更内容確認 → ドキュメント更新 → レビュー → 整合性チェック
+   - **`[停止: ...]`マーカーで必ず停止** → 次に進む前にユーザー承認を待つ
+3. **スコープ**: 更新されたドキュメントが承認されたら完了
+
+**重要**: document-reviewerと停止ポイントは必ず実行する。
+
+## ワークフロー概要
+
+```
+対象ドキュメント → [停止: 変更内容確認]
+                        ↓
+              technical-designer / prd-creator（updateモード）
+                        ↓
+              document-reviewer → [停止: レビュー承認]
+                        ↓（Design Docのみ）
+              design-sync → [停止: 最終承認]
+```
+
+## スコープ境界
+
+**実行内容**:
+- 既存ドキュメントの特定と選択
+- ユーザーとの変更内容確認
+- 適切なエージェントによるドキュメント更新（updateモード）
+- document-reviewerによるドキュメントレビュー
+- design-syncによる整合性検証（Design Docのみ）
+
+**実行しない**:
+- 新規要件分析（新規ドキュメントには/designを使用）
+- 作業計画や実装（本コマンド後に/planまたは/taskを使用）
+
+**責務境界**: このコマンドは更新されたドキュメントの承認で責務完了。
+
+対象ドキュメント: $ARGUMENTS
+
+## 実行フロー
+
+### ステップ1: 対象ドキュメントの特定
+
+```bash
+# 既存ドキュメントを確認
+ls docs/design/*.md docs/prd/*.md docs/adr/*.md 2>/dev/null | grep -v template
+```
+
+**判断フロー**:
+
+| 状況 | アクション |
+|------|-----------|
+| $ARGUMENTSがパスを指定 | 指定ドキュメントを使用 |
+| $ARGUMENTSがトピックを記述 | トピックに合致するドキュメントを検索 |
+| 複数の候補が見つかった | AskUserQuestionで選択肢を提示 |
+| ドキュメントが見つからない | 報告して終了（代わりに/designを推奨） |
+
+### ステップ2: ドキュメントタイプの判定
+
+ドキュメントパスからタイプを判定:
+
+| パスパターン | タイプ | 更新エージェント | 備考 |
+|-------------|--------|-----------------|------|
+| `docs/design/*.md` | Design Doc | technical-designer | - |
+| `docs/prd/*.md` | PRD | prd-creator | - |
+| `docs/adr/*.md` | ADR | technical-designer | 軽微な変更: 既存ファイルを更新、大きな変更: 元を置き換える新ADRを作成 |
+
+**ADR更新ガイダンス**:
+- **軽微な変更**（明確化、誤字修正、小規模なスコープ調整）: 既存ADRファイルを更新
+- **大きな変更**（決定の変更、大規模なスコープ変更）: 元のADRを置き換える新しいADRを作成
+
+### ステップ3: 変更内容の確認 [停止]
+
+AskUserQuestionで必要な変更を確認:
+- どのセクションの更新が必要か
+- 変更の理由（バグ修正の発見、仕様変更、レビューフィードバック等）
+- 更新後の期待される結果
+
+変更内容の理解をユーザーと確認してから進む。
+
+### ステップ4: ドキュメント更新
+
+ステップ2で決定した更新エージェントを呼び出す:
+```
+subagent_type: [ステップ2の更新エージェント]
+description: "[ステップ2のタイプ]を更新"
+prompt: |
+  動作モード: update
+  既存ドキュメント: [ステップ1のパス]
+
+  ## 必要な変更
+  [ステップ3で確認した変更内容]
+
+  指定された変更を反映するようドキュメントを更新する。
+  変更履歴エントリを追加する。
+```
+
+### ステップ5: ドキュメントレビュー [停止]
+
+document-reviewerを呼び出す:
+```
+subagent_type: document-reviewer
+description: "更新されたドキュメントをレビュー"
+prompt: |
+  以下の更新されたドキュメントをレビューする。
+
+  doc_type: [Design Doc / PRD / ADR]
+  target: [ステップ1のパス]
+  mode: standard
+
+  注力ポイント:
+  - 更新セクションとドキュメント全体の整合性
+  - 変更による矛盾が発生していないこと
+  - 変更履歴の完全性
+```
+
+**レビュー結果に基づく対応**:
+- 承認 → ステップ6へ進む
+- 要修正 → レビュアーフィードバックを持ってステップ4に戻る（最大2回）
+- **2回のリジェクト後** → 人間レビュー用にフラグ、蓄積されたフィードバックをユーザーに提示して終了
+
+レビュー結果をユーザーに提示して承認を得る。
+
+### ステップ6: 整合性検証（Design Docのみ） [停止]
+
+**スキップ条件**: ドキュメントタイプがPRDまたはADR → 完了へ進む。
+
+Design Docの場合、design-syncを呼び出す:
+```
+subagent_type: design-sync
+description: "整合性を検証"
+prompt: |
+  更新されたDesign Docと他の設計ドキュメントとの整合性を検証する。
+
+  更新されたドキュメント: [ステップ1のパス]
+```
+
+**整合性結果に基づく対応**:
+- 矛盾なし → 結果をユーザーに提示して最終承認を得る
+- 矛盾を検出 → AskUserQuestionで矛盾をユーザーに提示:
+  - A: このドキュメントの矛盾を解決するためステップ4に戻る
+  - B: コマンドを終了し、矛盾は別途対応する
+
+## エラーハンドリング
+
+| エラー | アクション |
+|--------|-----------|
+| 対象ドキュメントが見つからない | 報告して終了（代わりに/designを推奨） |
+| サブエージェントの更新が失敗 | 失敗をログ、エラーをユーザーに提示、1回リトライ |
+| 2回の修正後もレビューがリジェクト | ループを停止、人間介入用にフラグ |
+| design-syncが矛盾を検出 | 解決判断のためユーザーに提示 |
+
+## 完了条件
+
+- [ ] 対象ドキュメントを特定した
+- [ ] ユーザーと変更内容を確認した
+- [ ] 適切なエージェントでドキュメントを更新した（updateモード）
+- [ ] document-reviewerを実行しフィードバックに対応した
+- [ ] design-syncで整合性検証を実行した（Design Docのみ）
+- [ ] 更新されたドキュメントのユーザー承認を取得した
+
+## 出力例
+ドキュメント更新が完了しました。
+- 更新されたドキュメント: docs/design/[ドキュメント名].md
+- 承認ステータス: ユーザー承認済み
+
+**重要**: 本コマンドはドキュメント承認で終了。次フェーズへの移行提案は行わない。

package/README.ja.md

@@ -132,6 +132,7 @@ Claude Codeで利用できる主要なコマンド：
 | `/reverse-engineer` | コードからPRD/Design Docを生成 | 既存システムのドキュメント化（Backend） |
 | `/front-reverse-design` | フロントエンドDesign Docを生成 | 既存フロントエンドコードのドキュメント化 |
 | `/add-integration-tests` | 統合/E2Eテストの追加 | Design Doc存在時のテスト追加 |
+| `/update-doc` | 既存設計ドキュメントの更新 | 仕様変更、レビューフィードバック対応 |
 
 [コマンドの詳細はこちら →](docs/guides/ja/use-cases.md)
 

package/README.md

@@ -138,6 +138,7 @@ Essential commands for Claude Code:
 | `/reverse-engineer` | Generate PRD/Design Docs from code | Legacy system documentation (Backend) |
 | `/front-reverse-design` | Generate frontend Design Docs | Existing frontend code documentation |
 | `/add-integration-tests` | Add integration/E2E tests | When Design Doc exists but tests missing |
+| `/update-doc` | Update existing design documents | Spec changes, review feedback |
 
 [Full command reference →](docs/guides/en/use-cases.md)
 
@@ -162,7 +163,7 @@ Generate PRD and Design Docs from existing code:
 ```mermaid
 graph TB
     subgraph Phase1[Phase 1: PRD Generation]
-        CMD[/reverse-engineer] --> SD1[scope-discoverer]
+        CMD["/reverse-engineer"] --> SD1[scope-discoverer]
         SD1 --> PRD[prd-creator]
         PRD --> CV1[code-verifier]
         CV1 --> DR1[document-reviewer]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ai-project",
-  "version": "1.14.12",
+  "version": "1.14.13",
   "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": [
@@ -88,7 +88,7 @@
     "tsc-alias": "^1.8.7",
     "tsx": "^4.19.4",
     "typescript": "^5.0.0",
-    "vite": "^5.0.0",
+    "vite": "^7.3.1",
     "vitest": "^3.2.4"
   },
   "engines": {