↓の記事で紹介したドキュメントのサンプル記述を紹介します。
README.md
# Claude Code マルチエージェント開発テンプレート集
## 概要
このディレクトリには、Claude Codeのマルチエージェント機能を活用した並列開発を効率的に行うためのテンプレート集が含まれています。
## ディレクトリ構造
```
template/
├── 設定ファイル
│ ├── CLAUDE.md # プロジェクト設定
│ └── AGENT_ID_REFERENCE.md # エージェントID参照
├── テンプレート
│ ├── PROJECT_SPECIFICATION.md # プロジェクト仕様書
│ ├── API_SPECIFICATION.md # API仕様書
│ ├── TASK_TEMPLATES.md # タスク依頼フォーマット
│ └── WORKFLOW_EXAMPLES.md # ワークフロー例
├── .claude/agents/ # エージェント定義（6ファイル）
└── .claude_code/ # セーフティ設定（2ファイル）
```
## エージェント構成
### 5つの専門エージェント体制
本テンプレートでは、5つの専門エージェントによる並列開発体制を採用しています。
各エージェントの詳細定義については、以下を参照してください：
詳細については `AGENT_ID_REFERENCE.md` を参照してください。
## 使い方
### 1. プロジェクトへの適用
```bash
# 新規プロジェクトディレクトリで
mkdir [project-name]
cd [project-name]
# テンプレートをコピー（例: ./knowledge/jun/template/からコピー）
cp -r ./knowledge/jun/template/.claude ./
cp ./knowledge/jun/template/CLAUDE.md ./
mkdir -p docs
cp ./knowledge/jun/template/PROJECT_SPECIFICATION.md ./docs/
# プロジェクトに合わせてカスタマイズ
vim CLAUDE.md # プロジェクト情報を記入
```
### 2. エージェントの呼び出し方
```javascript
// CEOエージェントでプロジェクト設計
await Task.subagent("ceo-strategic-delegator",
"[プロジェクト名]のアーキテクチャを設計してください"
);
// 複数エージェントの並列実行
const tasks = await Promise.all([
Task.subagent("adaptive-specialist-dev1", "[UI機能]を実装"),
Task.subagent("adaptive-specialist-dev2", "[API機能]を実装"),
Task.subagent("adaptive-specialist-dev3", "テストケースを作成")
]);
// QA/Dev3エージェントでテスト実施
await Task.subagent("adaptive-specialist-dev3",
"統合テストを実施してください"
);
// PMエージェントで進捗管理
await Task.subagent("project-manager-coordinator",
"各タスクの進捗を確認してレポートを作成してください"
);
```
### 3. タスクテンプレートの活用
`TASK_TEMPLATES.md`には、各エージェント向けの標準的なタスク依頼フォーマットが含まれています：
- プロジェクト初期設計タスク
- スプリント計画タスク
- 開発タスク（フロント/バック）
- テストタスク
- 並列実行タスクセット
### 4. ワークフローの実践例
`WORKFLOW_EXAMPLES.md`には、実際のプロジェクトシナリオに基づいた詳細なワークフロー例が含まれています：
1. 新規Webアプリケーション構築
2. 既存システムのリファクタリング
3. バグ修正と機能追加の並行開発
4. パフォーマンス最適化
5. マルチプラットフォーム対応
6. セキュリティ強化
7. CI/CDパイプライン構築
## 並列開発のベストプラクティス
詳細なワークフローとベストプラクティスは `WORKFLOW_EXAMPLES.md` を参照してください。
## カスタマイズガイド
### エージェント定義のカスタマイズ
各エージェント定義ファイルの主要セクション：
- **専門分野**: 技術スタックと責任範囲を定義
- **タスク振り分け基準**: どのタスクを担当するか明確化
- **コミュニケーションプロトコル**: 入出力フォーマット
- **品質基準**: 成果物の品質チェック項目
### プロジェクト固有の設定
`CLAUDE.md`をカスタマイズして、プロジェクト特有の：
- 技術スタック
- コーディング規約
- Git運用ルール
- デプロイメント手順
を定義します。
## トラブルシューティング
### よくある問題
1. **エージェントが見つからない**
- `.claude/agents/`ディレクトリが正しくコピーされているか確認
- エージェントIDが正しいか確認
2. **タスクの競合**
- 同じファイルを複数のエージェントが編集する場合は順次実行に変更
3. **依存関係のエラー**
- タスクの実行順序を見直し
- 前提条件が満たされているか確認
## 関連ドキュメント
- `AGENT_ID_REFERENCE.md` - エージェントIDの正式定義と使用方法
- `CLAUDE.md` - プロジェクト設定の詳細
- `PROJECT_SPECIFICATION.md` - プロジェクト仕様の記述方法
- `API_SPECIFICATION.md` - API仕様の記述方法
- `TASK_TEMPLATES.md` - タスク依頼の標準フォーマット
- `WORKFLOW_EXAMPLES.md` - 実践的な使用例
## サポート
質問や改善提案がある場合は、プロジェクトのイシュートラッカーまたは以下にお問い合わせください：
- [プロジェクトリポジトリ]
- [ドキュメントサイト]
## ライセンス
[プロジェクトのライセンス情報]
---
最終更新: [YYYY-MM-DD]