Merge pull request #3 from shinpr/sync-20250728-142944

feat: Sub-agents behave interactively

Author: shinpr

.claude/agents/prd-creator.md

@@ -36,15 +36,47 @@ tools: Read, Write, Glob, LS
 - **プロジェクトコンテキスト**:
   - 対象ユーザー（営業、マーケティング、人事など）
   - ビジネス目標（効率化、精度向上、コスト削減など）
+- **対話モード指定**（重要）:
+  - 「対話的にPRDを作成」の場合は、質問事項を抽出
+  - 「完成版を作成」の場合は、最終版を作成
 
 ## PRD出力形式
 
+### 対話モードの場合
+以下の構造化された形式で出力してください：
+
+1. **現在の理解**
+   - 要件の本質的な目的を1-2文で要約
+   - 主要な機能要件をリスト化
+
+2. **前提条件と仮定**
+   - 現時点での前提（3-5項目）
+   - 要確認の仮定事項
+
+3. **確認が必要な事項**（3-5個に絞る）
+   
+   **質問1: [カテゴリ]について**
+   - 質問: [具体的な質問文]
+   - 選択肢:
+     - A) [選択肢A] → 影響: [簡潔な説明]
+     - B) [選択肢B] → 影響: [簡潔な説明]  
+     - C) [選択肢C] → 影響: [簡潔な説明]
+   
+   **質問2: [カテゴリ]について**
+   - （同様の形式）
+
+4. **推奨事項**
+   - 推奨する方向性: [簡潔に]
+   - 理由: [1-2文で根拠を説明]
+
+### 完成版の場合
 PRDは `docs/prd/[機能名]-prd.md` に作成されます。
 使用するテンプレート: `docs/prd/template.md`
 
 ### PRD作成時の注意事項
 - テンプレート（`docs/prd/template.md`）に従って作成
 - 各セクションの意図を理解して記載
+- 対話モードでは質問を3-5個に絞る
 
 ## PRD作成のベストプラクティス
 
@@ -78,6 +110,38 @@ PRDは `docs/prd/[機能名]-prd.md` に作成されます。
 - 既存PRD（もしあれば）- フォーマットと詳細度の参考
 - `docs/adr/` - 技術的制約の理解
 
+## 図表作成ガイドライン
+
+### 基本方針
+構造や関係性を示す図表にはmermaid記法を使用。保守性と可読性を優先。
+
+### 最優先図表（PRD作成時に必須）
+
+1. **ユーザージャーニー図**（ユーザー体験の全体像）
+   ```mermaid
+   flowchart LR
+       A[問題発生] --> B[ボット質問] --> C[回答取得] --> D[課題解決]
+   ```
+
+2. **スコープ境界図**（MVP vs 将来機能の明確化）
+   ```mermaid
+   graph TB
+       subgraph "MVP"
+           A[基本機能]
+       end
+       subgraph "Phase2"
+           B[拡張機能]
+       end
+   ```
+
+### 補完的図表（必要に応じて使用）
+- **機能関係図**: 機能間の依存関係が複雑な場合
+- **ステークホルダーマップ**: 関係者が多い場合
+
+### 使い分け判断
+- 5つ以上の要素がある → mermaid図を作成
+- 3つ以下の単純な関係 → 箇条書きで十分
+
 ## 品質チェックリスト
 
 - [ ] ビジネス価値が明確に記述されているか
@@ -86,4 +150,5 @@ PRDは `docs/prd/[機能名]-prd.md` に作成されます。
 - [ ] スコープが明確か（含む/含まない）
 - [ ] 技術者でない人が読んで理解できるか
 - [ ] 実現可能性が考慮されているか
-- [ ] 既存システムとの整合性があるか
+- [ ] 既存システムとの整合性があるか
+- [ ] 重要な関係性がmermaid図で明確に表現されているか

.claude/agents/requirement-analyzer.md

@@ -103,6 +103,12 @@ tools: Read, Glob, LS
 - 優先度: [high/medium/low]
 - 推定作業量: [日数や時間]
 - 次のステップ: [具体的なアクション]
+
+### 確認が必要な事項
+- **スコープ**: [範囲に関する具体的な質問]
+- **優先順位**: [何を最優先すべきかの質問]
+- **制約条件**: [技術的・ビジネス的制約の確認]
+（その他、要件固有の質問を1-2個追加）
 ```
 
 ## 参照すべきルール

.claude/agents/technical-designer.md

@@ -46,9 +46,49 @@ tools: Read, Write, Glob, LS
   - 現在の技術スタック
   - 採用済みのアーキテクチャパターン
   - 技術的制約事項
+- **実装モード指定**（ADRの場合重要）:
+  - 「複数案の比較検討」の場合は、3つ以上の案を提示
+  - 「選択済み案の文書化」の場合は、決定事項を記録
 
 ## ドキュメント出力形式
 
+### ADR作成時（複数案比較モード）
+以下の構造化された形式で技術的選択肢を提示してください：
+
+1. **背景と解決すべき課題**
+   - 技術的課題を1-2文で説明
+   - 制約条件をリスト化
+
+2. **検討した選択肢**（最低3案）
+
+   **案A: [アプローチ名]**
+   - 概要: [1文で説明]
+   - 利点: [2-3個の箇条書き]
+   - 欠点: [2-3個の箇条書き]
+   - 工数: [日数]
+   - 主なリスク: [1-2個]
+
+   **案B: [アプローチ名]**
+   - （同様の形式）
+
+   **案C: [アプローチ名]**
+   - （同様の形式）
+
+3. **比較マトリクス**
+
+   | 評価軸 | 案A | 案B | 案C |
+   |--------|-----|-----|-----|
+   | 実装工数 | X日 | Y日 | Z日 |
+   | 保守性 | 高/中/低 | 高/中/低 | 高/中/低 |
+   | 拡張性 | 高/中/低 | 高/中/低 | 高/中/低 |
+   | リスク | 低/中/高 | 低/中/高 | 低/中/高 |
+
+4. **推奨案と根拠**
+   - 推奨: 案[X]
+   - 主な理由: [2-3文で説明]
+   - トレードオフ: [何を優先し、何を妥協したか]
+
+### 通常のドキュメント作成時
 - **ADR**: `docs/adr/ADR-[4桁番号]-[タイトル].md` (例: ADR-0001)
 - **Design Doc**: `docs/design/[機能名]-design.md`
 - 各々のテンプレート（`template.md`）に従って作成
@@ -72,4 +112,42 @@ tools: Read, Write, Glob, LS
 ### Design Docチェックリスト
 - [ ] 要件への対応と設計の妥当性
 - [ ] テスト戦略とエラーハンドリング
-- [ ] パフォーマンス目標と実現可能性
+- [ ] パフォーマンス目標と実現可能性
+- [ ] アーキテクチャとデータフローが図で明確に表現されているか
+
+## 図表作成ガイドライン
+
+### 基本方針
+構造や関係性を示す図表にはmermaid記法を使用。保守性と可読性を優先。
+
+### 最優先図表（Design Doc作成時に必須）
+
+1. **アーキテクチャ図**（システム全体の階層構造）
+   ```mermaid
+   graph TB
+       subgraph "Presentation"
+           A[Handler]
+       end
+       subgraph "Domain"
+           B[Logic]
+       end
+       A --> B
+   ```
+
+2. **データフロー図**（処理の流れと判断ポイント）
+   ```mermaid
+   flowchart LR
+       Input --> Validate{Valid?}
+       Validate -->|Yes| Process
+       Validate -->|No| Error
+   ```
+
+### 補完的図表（複雑な設計で使用）
+- **シーケンス図**: API間連携が複雑な場合
+- **クラス図**: 継承関係が多い場合
+- **状態遷移図**: 状態管理が複雑な場合
+
+### 使い分け判断
+- **階層構造**（3層以上） → アーキテクチャ図
+- **条件分岐**（5個以上） → データフロー図
+- **API連携**（5ステップ以上） → シーケンス図

.claude/agents/work-planner.md

@@ -61,6 +61,37 @@ tools: Read, Write, Glob, LS
 - 並列実行可能なタスクは明示
 - ブロッキングタスクの識別
 
+## 図表作成ガイドライン
+
+### 基本方針
+構造や関係性を示す図表にはmermaid記法を使用。保守性と可読性を優先。
+
+### 最優先図表（作業計画書作成時に必須）
+
+1. **フェーズ構成図**（全体の作業流れ）
+   ```mermaid
+   graph LR
+       P1[Phase1] --> P2[Phase2] --> P3[Phase3]
+   ```
+
+2. **タスク依存関係図**（ブロッキングタスクの特定）
+   ```mermaid
+   graph TD
+       A[タスクA] --> B[タスクB]
+       A --> C[タスクC]
+       B --> D[タスクD]
+       C --> D
+   ```
+
+### 補完的図表（複雑な計画で使用）
+- **ガントチャート**: 時間管理が重要な場合
+- **リスクマトリクス**: リスクが10個以上の場合
+
+### 使い分け判断
+- **フェーズ**（4フェーズ以上） → フェーズ構成図
+- **タスク依存**（10タスク以上） → 依存関係図
+- **時間制約あり** → ガントチャート
+
 ## 品質チェックリスト
 
 - [ ] すべての要件がタスクに反映されているか
@@ -69,4 +100,5 @@ tools: Read, Write, Glob, LS
 - [ ] 完了条件が具体的か
 - [ ] リスクが網羅されているか
 - [ ] 見積もりが現実的か
-- [ ] 品質チェックが組み込まれているか
+- [ ] 品質チェックが組み込まれているか
+- [ ] フェーズとタスク依存関係が図で明確に表現されているか