Subagent-Driven Development

サブエージェント主導の開発

タスクごとに新しいサブエージェントを割り当て、各タスクの後にコードレビューを行って計画を実行します。

基本原則： タスクごとに新しいサブエージェントを割り当て、タスク間でレビューすることで、高品質かつ迅速に反復できます。

概要

計画の実行（並列セッション）との比較：

• 同じセッション内で作業（コンテキストの切り替えなし）
• タスクごとに新しいサブエージェントを使用（コンテキストの混乱なし）
• 各タスクの後にコードレビューを実施（問題を早期に発見）
• 反復がより迅速（タスク間で人間が介在しない）

使用する場合：

• このセッションを継続する
• タスクの大部分が独立している
• 品質ゲートを設けつつ、継続的に進めたい

使用しない場合：

• 先に計画をレビューする必要がある（executing-plans を使用）
• タスク同士が密接に関連している（手動での実行が適しています）
• 計画の修正が必要（先にブレインストーミングを行う）

プロセス

1. 計画を読み込む

計画ファイルを読み、すべてのタスクを含む TodoWrite を作成します。

2. サブエージェントでタスクを実行する

各タスクについて：

新しいサブエージェントを割り当てます：

Task tool (general-purpose):
  description: "Implement Task N: [task name]"
  prompt: |
    You are implementing Task N from [plan-file].

    Read that task carefully. Your job is to:
    1. Implement exactly what the task specifies
    2. Write tests (following TDD if task says to)
    3. Verify implementation works
    4. Commit your work
    5. Report back

    Work from: [directory]

    Report: What you implemented, what you tested, test results, files changed, any issues

サブエージェントが作業の概要を報告します。

3. サブエージェントの作業をレビューする

code-reviewer サブエージェントを割り当てます：

Task tool (code-reviewer):
  Use template at skills/collaboration/requesting-code-review/code-reviewer.md

  WHAT_WAS_IMPLEMENTED: [from subagent's report]
  PLAN_OR_REQUIREMENTS: Task N from [plan-file]
  BASE_SHA: [commit before task]
  HEAD_SHA: [current commit]
  DESCRIPTION: [task summary]

コードレビュアーからの報告： 長所、問題点（重大／重要／軽微）、評価

4. レビューのフィードバックを適用する

問題が見つかった場合：

• 重大な問題を直ちに修正する
• 次のタスクに進む前に重要な問題を修正する
• 軽微な問題は記録する

必要に応じて、後続のサブエージェントを割り当てます：

"Fix issues from code review: [list issues]"

5. 完了としてマークし、次のタスクへ進む

• TodoWrite でタスクを完了としてマークする
• 次のタスクに進む
• 手順 2～5 を繰り返す

6. 最終レビュー

すべてのタスクが完了したら、最終コードレビュアーを割り当てます：

• 実装全体をレビューする
• 計画の要件がすべて満たされていることを確認する
• アーキテクチャ全体を検証する

7. 開発を完了する

最終レビューに合格したら：

• 「Finishing a Development Branch スキルを使用して、この作業を完了します。」と伝える
• skills/collaboration/finishing-a-development-branch に切り替える
• そのスキルに従ってテストを検証し、選択肢を提示して、選ばれたものを実行する

ワークフローの例

You: I'm using Subagent-Driven Development to execute this plan.

[Load plan, create TodoWrite]

Task 1: Hook installation script

[Dispatch implementation subagent]
Subagent: Implemented install-hook with tests, 5/5 passing

[Get git SHAs, dispatch code-reviewer]
Reviewer: Strengths: Good test coverage. Issues: None. Ready.

[Mark Task 1 complete]

Task 2: Recovery modes

[Dispatch implementation subagent]
Subagent: Added verify/repair, 8/8 tests passing

[Dispatch code-reviewer]
Reviewer: Strengths: Solid. Issues (Important): Missing progress reporting

[Dispatch fix subagent]
Fix subagent: Added progress every 100 conversations

[Verify fix, mark Task 2 complete]

...

[After all tasks]
[Dispatch final code-reviewer]
Final reviewer: All requirements met, ready to merge

Done!

メリット

手動での実行との比較：

• サブエージェントは自然に TDD に従う
• タスクごとに新しいコンテキストを使用（混乱なし）
• 並列実行に安全（サブエージェント同士が干渉しない）

計画の実行との比較：

• 同じセッション内で作業（引き継ぎなし）
• 継続的に進行（待ち時間なし）
• レビューチェックポイントを自動化

コスト：

• サブエージェントの呼び出し回数が増える
• ただし問題を早期に発見できる（後でデバッグするより低コスト）

注意すべき兆候

絶対にしないこと：

• タスク間のコードレビューを省略する
• 未修正の重大な問題がある状態で先に進む
• 複数の実装サブエージェントを並列で割り当てる（競合が発生する）
• 計画のタスクを読まずに実装する

サブエージェントがタスクに失敗した場合：

• 具体的な指示を添えて、修正用サブエージェントを割り当てる
• 手動で修正しようとしない（コンテキストが混乱するため）

連携

組み合わせるもの：

• skills/collaboration/writing-plans（計画を作成）
• skills/collaboration/requesting-code-review（レビューテンプレート）
• skills/testing/test-driven-development（サブエージェントがこれに従う）

代替となるもの：

• skills/collaboration/executing-plans（並列セッション）

コードレビュアーのテンプレートはこちら：skills/collaboration/requesting-code-review/code-reviewer.md