Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 66 additions & 1 deletion .claude/agents/prd-creator.md
Original file line number Diff line number Diff line change
Expand Up @@ -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作成のベストプラクティス

Expand Down Expand Up @@ -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つ以下の単純な関係 → 箇条書きで十分

## 品質チェックリスト

- [ ] ビジネス価値が明確に記述されているか
Expand All @@ -86,4 +150,5 @@ PRDは `docs/prd/[機能名]-prd.md` に作成されます。
- [ ] スコープが明確か(含む/含まない)
- [ ] 技術者でない人が読んで理解できるか
- [ ] 実現可能性が考慮されているか
- [ ] 既存システムとの整合性があるか
- [ ] 既存システムとの整合性があるか
- [ ] 重要な関係性がmermaid図で明確に表現されているか
6 changes: 6 additions & 0 deletions .claude/agents/requirement-analyzer.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,12 @@ tools: Read, Glob, LS
- 優先度: [high/medium/low]
- 推定作業量: [日数や時間]
- 次のステップ: [具体的なアクション]

### 確認が必要な事項
- **スコープ**: [範囲に関する具体的な質問]
- **優先順位**: [何を最優先すべきかの質問]
- **制約条件**: [技術的・ビジネス的制約の確認]
(その他、要件固有の質問を1-2個追加)
```

## 参照すべきルール
Expand Down
80 changes: 79 additions & 1 deletion .claude/agents/technical-designer.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`)に従って作成
Expand All @@ -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ステップ以上) → シーケンス図
34 changes: 33 additions & 1 deletion .claude/agents/work-planner.md
Original file line number Diff line number Diff line change
Expand Up @@ -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タスク以上) → 依存関係図
- **時間制約あり** → ガントチャート

## 品質チェックリスト

- [ ] すべての要件がタスクに反映されているか
Expand All @@ -69,4 +100,5 @@ tools: Read, Write, Glob, LS
- [ ] 完了条件が具体的か
- [ ] リスクが網羅されているか
- [ ] 見積もりが現実的か
- [ ] 品質チェックが組み込まれているか
- [ ] 品質チェックが組み込まれているか
- [ ] フェーズとタスク依存関係が図で明確に表現されているか
Loading