Breezing — Team Execution Mode

後方互換エイリアス: harness-work をチーム実行モードで動かします。

Quick Reference

breezing                        # スコープを聞いてから実行
breezing all                    # Plans.md 全タスクを完走
breezing 3-6                    # タスク3〜6を完走
breezing --codex all            # Codex CLI で全タスク完走
breezing --parallel 2 all       # 2並列で全タスク完走
breezing --no-discuss all       # 計画議論スキップで全タスク完走
breezing --auto-mode all        # 互換な親セッションで Auto Mode rollout を試す

Options

Execution

このスキルは harness-work に委譲します。 以下の設定で harness-work を実行してください:

1. 引数をそのまま harness-work に渡す
2. チーム実行モードを強制 — Lead → Worker spawn → Reviewer spawn の三者分離
3. Lead は delegate 専念 — コードを直接書かない
4. Auto Mode は opt-in 扱い — --auto-mode は互換な親セッションでの rollout 用フラグとして受け付ける

harness-work との違い

Team Composition

*親セッションまたは frontmatter が bypassPermissions の場合はそちらが優先される。配布テンプレートは現在も bypassPermissions を使うため、Auto Mode は follow-up の rollout 対象であり、既定挙動ではない。

Codex Mode (--codex)

Codex CLI にすべての実装を委託するモード:

# プロンプトは stdin パイプで渡す（ARG_MAX 対策）
CODEX_PROMPT=$(mktemp /tmp/codex-prompt-XXXXXX.md)
# タスク内容を書き出し
cat "$CODEX_PROMPT" | ${TIMEOUT:+$TIMEOUT 120} codex exec - --sandbox workspace-write --full-auto 2>>/tmp/harness-codex-$$.log
rm -f "$CODEX_PROMPT"

Flow Summary

breezing [scope] [--codex] [--parallel N] [--no-discuss] [--auto-mode]
    │
    ↓ Load harness-work with team mode
    │
Phase 0: Planning Discussion (--no-discuss でスキップ)
Phase A: Pre-delegate（チーム初期化）
Phase B: Delegate（Worker 実装 + Reviewer レビュー）
Phase C: Post-delegate（統合検証 + Plans.md 更新 + commit）

Progress Feed（Phase B 中の進捗通知）

Lead は Worker のタスク完了ごとに、以下のフォーマットで進捗を出力する:

📊 Progress: Task {completed}/{total} 完了 — "{task_subject}"

出力例:

📊 Progress: Task 1/5 完了 — "harness-work に失敗再チケット化を追加"
📊 Progress: Task 2/5 完了 — "harness-sync に --snapshot を追加"
📊 Progress: Task 3/5 完了 — "breezing にプログレスフィードを追加"

設計意図: breezing は長時間実行になることが多い。 ユーザーがターミナルをチラ見した時に「今どこまで進んでいるか」が一目で分かるようにする。 task-completed.sh フックが systemMessage で同等の情報を出力するため、Lead の出力と補完し合う。

Review Policy（全モード統一）

Breezing モードでもレビューは Codex exec 優先 → 内部 Reviewer フォールバック の統一ポリシーに従う。 詳細は harness-work の「レビューループ」セクションを参照。

• Worker が worktree 内で実装・commit → Lead に結果返却
• Lead が Codex exec でレビュー（120s タイムアウト、フォールバック: Reviewer agent）
• REQUEST_CHANGES → Lead が SendMessage で Worker に修正指示、Worker が amend（最大 3 回）
• APPROVE → Lead が main に cherry-pick → Plans.md を cc:完了 [{hash}] に更新

完了報告（Phase C — Lead が生成）

全タスク完了後、Lead が以下の手順でリッチ完了報告を生成する:

1. git log --oneline {base_ref}..HEAD で全 cherry-pick コミットを収集
2. git diff --stat {base_ref}..HEAD で全体の変更規模を取得
3. Plans.md の cc:TODO / cc:WIP 残タスクを抽出
4. harness-work の「完了報告フォーマット」の Breezing テンプレートに従い出力

生成者は Lead。Worker や hook ではない。Lead が Phase C で git + Plans.md を読んで生成する。

Phase 0: Planning Discussion（構造化 3 問チェック）

全タスク実行前に、以下の 3 問で計画の健全性を確認する。 --no-discuss 指定時は全スキップ。

Q1. スコープ確認:

「{{N}} 件のタスクを実行します。スコープは適切ですか？」

多すぎる場合は優先度（Required > Recommended > Optional）で絞り込みを提案。

Q2. 依存関係確認（Plans.md に Depends カラムがある場合のみ）:

「タスク {{X}} は {{Y}} に依存しています。実行順序は合っていますか？」

Depends カラムを読み取り、依存チェーンを表示。循環依存があればエラー。

Q3. リスクフラグ（[needs-spike] タスクがある場合のみ）:

「タスク {{Z}} は [needs-spike] です。先に spike しますか？」

spike 未完了の [needs-spike] タスクがある場合、spike を先行実行するか確認。

3 問とも問題なければ、Phase A に進む（合計 30 秒で完了する設計）。

依存グラフに基づくタスク割り当て

Plans.md に Depends カラムがある場合（v2 フォーマット）、依存グラフに従ってタスクを実行する:

1. Depends が - のタスクを先に実行。独立タスクが複数あれば並列 spawn 可能
2. 各 Worker 完了後、Lead がレビュー→cherry-pick（harness-work Phase B 参照）
3. 依存元タスクが main に cherry-pick されたら、そのタスクに依存していたタスクを次に実行
4. 全タスクが完了するまで繰り返す

注意: 各タスクの「Worker 完了→レビュー→cherry-pick」は逐次処理。 並列化できるのは独立タスク（Depends が -）の Worker spawn 部分のみ。

Codex Native Orchestration

Codex では native subagent を使う。 代表的な制御面は spawn_agent, wait, send_input, resume_agent, close_agent。

Claude Code vs Codex の通信 API（SSOT: team-composition.md の API マッピング表）:

• Claude Code: SendMessage(to: agentId, message: "...") で Worker に修正指示
• Codex: resume_agent(agent_id) で Worker を再開 → send_input(agent_id, "...") で指示送信

harness-work の擬似コードは Claude Code 構文で記述。Codex 環境では上記に読み替えること。

Related Skills

• harness-work — 単一タスクからチーム実行まで（本体）
• harness-sync — 進捗同期
• harness-review — コードレビュー（breezing 内で自動起動）