エージェントパターン
概要
Agent Patternsは、Sprintプラグイン内でのマルチエージェントスプリント実行のための調整プロトコルを定義します。プロジェクトアーキテクトが実装エージェントやテストエージェントを起動する方法、エージェントが構造化レポートを介して結果を伝達する方法、並列エージェント間の競合を回避する方法を規定します。
前提条件
- Sprintプラグインがインストールされ、設定されていること (
/plugin install sprint) - Sprintディレクトリが
.claude/sprint/[N]/に初期化されていること specs.mdが明確なスコープとテスト設定で作成されていること- スプリントフェーズのライフサイクルに精通していること（
sprint-workflowスキルを参照）
手順
- すべてのエージェント起動をSPAWN REQUEST形式で構造化します。エージェント名、読み取る仕様ファイル、スコープ制約を含めてください：
SPAWN REQUEST Agent: python-dev Specs: .claude/sprint/1/backend-specs.md Contract: .claude/sprint/1/api-contract.md Scope: Authentication endpoints only - 各起動エージェントがそのスコープに関連するファイルのみを受け取るようにします。
api-contract.mdを共有インターフェースとして渡し、バックエンドエージェントとフロントエンドエージェントが同期を保つようにします。 - 完了時にすべてのエージェントから構造化レポートを収集します。各レポートには次の内容を含める必要があります：完了した作業、変更したファイル、追加したテスト、仕様に対する適合状況。
- エージェントを並列実行する場合は、ドメイン境界（例：バックエンド vs フロントエンド vs CI/CD）で作業を分割します。並列エージェントに重複するファイルパスを割り当てないでください。
- エージェントレポートをプロジェクトアーキテクトにフィードバックしてレビューします。アーキテクトは、反復（スコープを絞った再起動）するか、次のフェーズに進むかを決定します。
- テストエージェントに対しては、
${CLAUDE_SKILL_DIR}/references/ui-test-report.mdに示されているUIテストレポート形式を渡し、結果がテスト数、カバレッジ、失敗、コンソールエラーを含む一貫したスキーマに従うようにします。
出力
- スプリントオーケストレーターがエージェントを起動するために消費するSPAWN REQUESTブロック
- 構造化されたエージェントレポート（要約、変更ファイル、テスト結果、適合状況を含む）
- 合格/不合格数、カバレッジ詳細、失敗の説明、コンソールエラーログを含むUIテストレポート
- 各反復後の完了作業と残作業を反映した更新済み
status.md
エラー処理
| エラー | 原因 | 解決策 |
|---|---|---|
| エージェントが誤った仕様ファイルを受け取る | SPAWN REQUESTのパスが正しくない | 起動前にスプリントディレクトリ番号とファイル名を確認する |
| 並列エージェントによる重複ファイル変更 | スコープ境界が明確に定義されていない | ドメインごとに作業を分割し、各エージェントに異なるディレクトリを割り当てる |
| エージェントレポートに必須フィールドがない | エージェント指示にレポート形式が含まれていない | エージェントプロンプトに構造化レポートテンプレートを含める |
| 無限反復ループ | 仕様が決して完全に満たされない | status.md でブロック問題を確認する；オーケストレーターは5回の反復後に停止する |
| エージェントが見つからない | SPAWN REQUESTのエージェント名が間違っている | agents/ ディレクトリにエージェントマークダウンファイルが存在するか確認する |
例
並列実装エージェントの起動:
SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md
SPAWN REQUEST
Agent: nextjs-dev
Specs: .claude/sprint/1/frontend-specs.md
Contract: .claude/sprint/1/api-contract.md
両方のエージェントが同じ api-contract.md を共有し、APIの互換性を確保します。
構造化エージェントレポート形式:
AGENT REPORT
Agent: python-dev
Status: COMPLETE
Files Modified: src/auth/routes.py, src/auth/models.py, tests/test_auth.py
Tests: 12 passed, 0 failed
Conformity: All backend-specs requirements implemented
Notes: JWT token expiry set to 24h per spec
テストエージェントの調整:
SPAWN REQUEST
Agent: qa-test-agent
Specs: .claude/sprint/1/specs.md
Run After: python-dev, nextjs-dev
SPAWN REQUEST
Agent: ui-test-agent
Specs: .claude/sprint/1/specs.md
Run After: qa-test-agent
リソース
${CLAUDE_SKILL_DIR}/references/ui-test-report.md-- カバレッジと失敗追跡を含む構造化UIテストレポート形式- フェーズライフサイクルコンテキストのためのスプリントワークフロースキル
- 共有インターフェース設計のためのAPIコントラクトスキル
- エージェントアーキテクチャ概要のためのSprintプラグインREADME