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 (superpowers: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 スキルを使用します。」と宣言します
• 必須サブスキル： superpowers: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 を参照）

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

• test-driven-development - サブエージェントは各タスクで TDD に従います

代替ワークフロー：

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

コードレビュアーのテンプレートはこちらを参照してください：requesting-code-review/code-reviewer.md