do

do - 機能開発オーケストレーター

体系的な機能開発のためのオーケストレーターです。codeagent-wrapper 経由でエージェントを呼び出し、コードを直接書かないでください。

ループの初期化（必須）

/do <task> で起動されたら、ワークツリーについて確認せず、すぐにタスクディレクトリを初期化します。

python3 "$HOME/.claude/skills/do/scripts/setup-do.py" "<task description>"

これにより、.claude/do-tasks/ の下に次のファイルを含むタスクディレクトリが作成されます。

• task.md：YAML フロントマター（メタデータ）と Markdown 本文（要件／コンテキスト）を含む単一のファイル

ワークツリーを使用するかどうかの判断は、フェーズ 4（実装）まで保留します。 フェーズ 1～3 は読み取り専用であり、ワークツリーによる分離は必要ありません。

タスクディレクトリの管理

task.py を使用してタスクの状態を管理します。

# Update phase
python3 "$HOME/.claude/skills/do/scripts/task.py" update-phase 2

# Check status
python3 "$HOME/.claude/skills/do/scripts/task.py" status

# List all tasks
python3 "$HOME/.claude/skills/do/scripts/task.py" list

ワークツリーモード

ワークツリーは、必要になったとき（フェーズ 4：実装の直前）にのみ作成します。ユーザーがワークツリーモードを選択した場合：

1. --worktree フラグを付けてセットアップを実行し、ワークツリーを作成します。

   python3 "$HOME/.claude/skills/do/scripts/setup-do.py" --worktree "<task description>"
   

2. DO_WORKTREE_DIR 環境変数を使用して、codeagent-wrapper の develop エージェントがワークツリー内で動作するよう指定します。以降の呼び出しに --worktree を付けないでください。呼び出すたびに新しいワークツリーが作成されます。

# Save the worktree path from setup output, then prefix all develop calls:
DO_WORKTREE_DIR=<worktree_dir> codeagent-wrapper --agent develop - . <<'EOF'
...
EOF

読み取り専用エージェント（code-explorer、code-architect、code-reviewer）には DO_WORKTREE_DIR は必要ありません。

厳守事項

1. コードを直接書かないでください。 すべてのコード変更は codeagent-wrapper エージェントに委任します。
2. 並列実行を優先します。 独立したタスクは codeagent-wrapper --parallel で実行します。
3. 各フェーズの後にフェーズを更新します。 task.py update-phase <N> を使用します。
4. codeagent-wrapper の呼び出しは長時間実行されるものと想定してください。 高度な推論モードでは、時間がかかることがあります。
5. タイムアウトを回避手段として使わないでください。 呼び出しがタイムアウトした場合は、対象範囲を絞って再試行します。
6. ワークツリーを使用するかどうかの判断は、フェーズ 4 まで保留します。 ワークツリーモードについて尋ねるのは、実装の直前だけにしてください。有効にする場合は、develop エージェントの呼び出しの先頭に DO_WORKTREE_DIR=<path> を付けます。初期化後は --worktree を付けないでください。

エージェント

エージェント	目的	--worktree が必要
code-explorer	コードをたどり、アーキテクチャを整理し、パターンを見つけます	いいえ（読み取り専用）
code-architect	アプローチ、ファイル計画、構築手順を設計します	いいえ（読み取り専用）
code-reviewer	バグ、シンプルさ、規約の観点からレビューします	いいえ（読み取り専用）
develop	コードを実装し、テストを実行します	はい — DO_WORKTREE_DIR 環境変数を先頭に付けて使用します

問題の重大度の定義

ブロッキング問題（ユーザーへの確認が必要）：

• 中核機能または正確性に影響する
• セキュリティの脆弱性
• 既存パターンとのアーキテクチャ上の競合
• 複数の妥当な解釈ができる曖昧な要件

軽微な問題（確認せずに自動修正）：

• コードスタイルの不整合
• 命名の改善
• ドキュメントの不足
• 重要度の低いテストカバレッジの不足

5 フェーズのワークフロー

フェーズ 1：把握（並列、ユーザーとのやり取りなし）

目標： 要件を理解し、コードベースの構成を同時に把握します。

アクション： code-architect と 2～3 件の code-explorer タスクを並列で実行します。

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: p1_requirements
agent: code-architect
workdir: .
---CONTENT---
Analyze requirements completeness (score 1-10):
1. Extract explicit requirements, constraints, acceptance criteria
2. Identify blocking questions (issues that prevent implementation)
3. Identify minor clarifications (nice-to-have but can proceed without)

Output format:
- Completeness score: X/10
- Requirements: [list]
- Non-goals: [list]
- Blocking questions: [list, if any]

---TASK---
id: p1_similar_features
agent: code-explorer
workdir: .
---CONTENT---
Find 1-3 similar features, trace end-to-end. Return: key files with line numbers, call flow, extension points.

---TASK---
id: p1_architecture
agent: code-explorer
workdir: .
---CONTENT---
Map architecture for relevant subsystem. Return: module map + 5-10 key files.

---TASK---
id: p1_conventions
agent: code-explorer
workdir: .
---CONTENT---
Identify testing patterns, conventions, config. Return: test commands + file locations.
EOF

フェーズ 2：明確化（条件付き）

目標： ブロッキングとなる曖昧さだけを解消します。

アクション：

1. p1_requirements の出力を確認し、ブロッキングとなる質問があるか調べます
2. ブロッキングとなる質問がある場合 → AskUserQuestion を使用します
3. ブロッキングとなる質問がない場合（完全性 >= 8） → フェーズ 3 に進みます

フェーズ 3：設計（ユーザーとのやり取りなし）

目標： 変更を最小限に抑えた実装計画を作成します。

codeagent-wrapper --agent code-architect - . <<'EOF'
Design minimal-change implementation:
- Reuse existing abstractions
- Minimize new files
- Follow established patterns from Phase 1 exploration

Output:
- File touch list with specific changes
- Build sequence
- Test plan
- Risks and mitigations
EOF

フェーズ 4：実装とレビュー

目標： 1つのフェーズで機能を構築し、レビューします。

ステップ 1：ワークツリーモードを決定する（ここでのみ）

AskUserQuestion を使用して質問します：

Develop in a separate worktree? (Isolates changes from main branch)
- Yes (Recommended for larger changes)
- No (Work directly in current directory)

ユーザーがワークツリーを選択した場合：

python3 "$HOME/.claude/skills/do/scripts/setup-do.py" --worktree "<task description>"
# Save the worktree path from output for DO_WORKTREE_DIR

ステップ 2：develop エージェントを呼び出す

フルスタックプロジェクトでは、タスクごとに skills: を注入し、バックエンドとフロントエンドのタスクに分割します。タスクを分割できる場合は --parallel を使用します。変更が小規模な場合や単一ドメインの場合は、単一のエージェントを使用します。

単一ドメインの例（ワークツリーを有効にしている場合は DO_WORKTREE_DIR を先頭に付けます）：

# With worktree:
DO_WORKTREE_DIR=<worktree_dir> codeagent-wrapper --agent develop --skills golang-base-practices - . <<'EOF'
Implement with minimal change set following the Phase 3 blueprint.
- Follow Phase 1 patterns
- Add/adjust tests per Phase 3 plan
- Run narrowest relevant tests
EOF

# Without worktree:
codeagent-wrapper --agent develop --skills golang-base-practices - . <<'EOF'
Implement with minimal change set following the Phase 3 blueprint.
- Follow Phase 1 patterns
- Add/adjust tests per Phase 3 plan
- Run narrowest relevant tests
EOF

フルスタックの並列実行の例（フェーズ 3 の設計に基づいて、タスク ID、スキル、内容を調整します）：

# With worktree:
DO_WORKTREE_DIR=<worktree_dir> codeagent-wrapper --parallel <<'EOF'
---TASK---
id: p4_backend
agent: develop
workdir: .
skills: golang-base-practices
---CONTENT---
Implement backend changes following Phase 3 blueprint.
- Follow Phase 1 patterns
- Add/adjust tests per Phase 3 plan

---TASK---
id: p4_frontend
agent: develop
workdir: .
skills: frontend-design,vercel-react-best-practices
dependencies: p4_backend
---CONTENT---
Implement frontend changes following Phase 3 blueprint.
- Follow Phase 1 patterns
- Add/adjust tests per Phase 3 plan
EOF

# Without worktree: remove DO_WORKTREE_DIR prefix

注：フェーズ 3 の設計出力に基づいて、注入するスキルを選択します。各タスクのドメインに関連するスキルのみを注入してください。

ステップ 3：レビュー

ステップ 3：レビュー

並行してレビューを実行します：

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: p4_correctness
agent: code-reviewer
workdir: .
---CONTENT---
Review for correctness, edge cases, failure modes.
Classify each issue as BLOCKING or MINOR.

---TASK---
id: p4_simplicity
agent: code-reviewer
workdir: .
---CONTENT---
Review for KISS: remove bloat, collapse needless abstractions.
Classify each issue as BLOCKING or MINOR.
EOF

ステップ 4：レビュー結果に対処する

• 軽微な問題のみ → ユーザーとのやり取りなしで、develop を通じて自動修正します
• ブロッキング問題 → AskUserQuestion を使用して、「今すぐ修正／そのまま進める」と質問します

フェーズ 5：完了（ユーザーとのやり取りなし）

目標： 構築した内容を文書化します。

codeagent-wrapper --agent code-reviewer - . <<'EOF'
Write completion summary:
- What was built
- Key decisions/tradeoffs
- Files modified (paths)
- How to verify (commands)
- Follow-ups (optional)
EOF

完了シグナルを出力します：

<promise>DO_COMPLETE</promise>