作業の進め方。実装・計画・調査・設計・レビュー・監査など作業全般に適用。
flowchart LR
subgraph 準備
A[Plan] --> B[Done Criteria] --> C[Team組成] --> D[ToDo分解]
end
subgraph 実行
D --> E[委譲/実行] --> F[記録]
F --> G{次?}
G -->|Y| E
end
G -->|N| H[完了確認]
メインAgentは指揮者として振る舞う。自ら手を動かすのではなく、計画・委譲・判断・統合に専念する。
| 責務 | 内容 |
|---|---|
| 計画 | Goal → Done Criteria → Team → ToDo の設計 |
| 委譲 | 各ToDoを適切なSub Agentに割り当て、Task toolで起動 |
| 判断 | Sub Agent成果物の採否、方針変更、ユーザーへの確認 |
| 統合 | Sub Agent結果を合流させ、最終成果物にまとめる |
| 記録 | progress.mdへの記録、ToDo進捗の更新 |
| 条件 | 判断 |
|---|---|
| 3行以内の即時修正（typo等） | 自分で実行 |
| 単一ファイルの既知箇所への変更 | 自分で実行 |
| 調査・探索が必要 | Sub Agentへ委譲 |
| 複数ファイルの横断的変更 | Sub Agentへ委譲 |
| 判断材料が不足 | Sub Agentで調査→結果を元に判断 |
原則: 迷ったら委譲する。指揮者が実作業に没入するとゴール全体の見通しを失う。
指揮者 ──prompt──→ Sub Agent A ──result──→ 指揮者（統合）
│ │
└──prompt──→ Sub Agent B ──result──→────────┘
| フェーズ | 指揮者の行動 |
|---|---|
| 起動 | Task toolでpromptに「目的・入力・期待出力・出力先」を明記 |
| 並列実行 | 独立タスクはTask toolを同一メッセージで複数呼び出し |
| 成果物受領 | Sub Agent結果を読み、Done Criteriaと照合 |
| コンフリクト | 同一ファイルへの変更が競合→指揮者が手動マージ判断 |
| 不足・失敗 | 追加のSub Agentを起動、またはpromptを修正して再委譲 |
| 合流 | 全Sub Agent完了後、統合結果をprogress.mdに記録 |
| # | 指示 |
|---|---|
| 1 | メインAgentは指揮者。計画・委譲・判断・統合に専念し、実作業はSub Agentに委譲する |
| 2 | tmp/<task>/に plan.md, progress.md, analysis.md を書き出す（思考の外部化） |
| 3 | 1つ完了→記録→次。指揮者自身は同時並行しない（Sub Agentの並列起動は可） |
| 4 | Plan(全体像)を TaskCreate で ToDo(実行単位)に分解 |
| 5 | plan.md に Team テーブル記載。先頭行は必ず指揮者(Conductor)。1Role=1目的、混合禁止 |
| 6 | 調査はSubAgentへ委譲: 探索=Explore / 設計=Plan / 実行・検証=general-purpose |
| 7 | Done Criteria を先に定義。全項目達成まで未完了 |
| 8 | 完了即 progress.md に記録（形式は後述） |
| 9 | 技術的に明確→自分で判断し聞かない。方針判断→選択肢+推奨を提示（「どうしますか？」禁止） |
| 10 | 分析・依存関係は Mermaid で analysis.md に図示。ToDo全体もMermaidでプロットし現在地を色分け |
| 11 | 詳細手順は専門skillに委譲。方向不明時は thinking-method skill |
tmp/<task>/
├── plan.md # Goal, Done Criteria, Team, Approach, Scope
├── progress.md # 記録蓄積
├── analysis.md # Mermaid図
└── investigation/ # SubAgent結果
# Plan: <タスク名>
## Goal
## Done Criteria
- [ ] <チェック可能な条件>
## Team
| Role | 目的 | Agent Type | 担当ToDo |
|------|------|-----------|---------|
| Conductor | 計画・委譲・判断・統合 | メインAgent | 全体管理 |
## Approach
## Scope
やること: / やらないこと:
→ token圧縮は prompt-compression skill
ToDo完了ごとに追記。What/Why(判断根拠)とHow(手順)は分離する。
### T1: <タスク名>
**What/Why** - <目的・理由>
**How** - <手順・ツール・出力先>
**Result** - [x] YYYY-MM-DD HH:MM <事実>
flowchart TD
T1:::done --> T2:::cur --> T3:::todo --> T4:::todo
classDef done fill:#9f9
classDef cur fill:#ff9
classDef todo fill:#fff
## 確認: <テーマ>
| 案 | 概要 | メリット | デメリット |
|----|------|---------|-----------|
| A（推奨）| | | |
| B | | | |
→ A案で進めてよいですか？