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. サブエージェントの作業をレビューする

コードレビュアーのサブエージェントを割り当てる：

Task tool (code-reviewer):
  Use template at 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 スキルを使用します。」と宣言します
• 必須サブスキル： 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 に従います
• タスクごとに新しいコンテキストを使います（混乱を防止）
• 並列実行に安全です（サブエージェント同士が干渉しません）

「計画の実行」との比較：

• 同じセッション内で進めます（引き継ぎなし）
• 継続的に進行します（待ち時間なし）
• レビューチェックポイントが自動で設けられます

コスト：

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

危険信号

絶対に行わないこと：

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

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

• 具体的な指示を添えて修正用サブエージェントを割り当てます
• 手動で修正しようとしないでください（コンテキストが汚染されます）

連携

必須のワークフロースキル：

• writing-plans - 必須：このスキルで実行する計画を作成します
• requesting-code-review - 必須：各タスクの後にレビューします（手順 3 を参照）
• finishing-a-development-branch - 必須：すべてのタスクの完了後に開発を完了します（手順 7 を参照）

サブエージェントが必ず使用するもの：

• テストファーストの原則 - 各サブエージェントは、タスクを実装する前に失敗するテストを書き、その後テストを成功させます

代替ワークフロー：

• executing-plans - 同じセッション内での実行ではなく、並行セッションで実行する場合に使用します

コードレビュアーのテンプレートについては、requesting-code-review/code-reviewer.md を参照してください。