Breezing — Team Execution Mode
後方互換エイリアス:
harness-workをチーム実行モードで動かします。
Narration Rules (UX Contract)
敵は 冗長さ であって進捗報告ではない。起動時に実行計画を簡潔に明示してから実行を開始する。見やすい進捗報告は歓迎する。冗長な繰り返し・中身のない前置きだけを禁ずる。
起動時に必ず出すもの (banner + plan、合計 5 行以内)
最初の応答で、何を・どの順で進めるかを示してから tool 実行に入る:
🚀 cursor / composer-2.5-fast / feat/hah-11-golden-rule-lint / Reviewer
これから:
1. backend/model を resolve
2. composer に advisory findings を委譲 (read-only)
3. brain 一次レビューで verdict を確定 → 3-5 行要約 → Plans.md 更新
banner 1 行 (🚀 <backend> / <model> / <branch> / <task>) + 計画 2-4 行。1 秒以内に出し、即 Step 1 へ。
Fallback 警告(backend = claude 確定時)
resolver 出力が claude、または resolver 未経由で backend が claude と確定した場合、起動 banner 直後に 1 行だけ次を出す(計画行の前):
⚠️ backend=claude (via resolver / not via resolver) — composer/cursor を使う場合は `--cursor` or `bash "${HARNESS_PLUGIN_ROOT}/scripts/resolve-impl-backend.sh"` を確認
via resolver/not via resolver: resolver を実行したかで literal を選ぶ(経由時via resolver、未経由時not via resolver)- 確認先:
--cursorflag と bundledresolve-impl-backend.sh(bash "${HARNESS_PLUGIN_ROOT}/scripts/resolve-impl-backend.sh")の 2 つを必ず含める - env unset 罠の可視化: default / env / file 解決で
claudeに落ちたことを 1 行で示し、cursor 意図なら override または persistent default を促す
「禁止 (= 冗長さ)」節と衝突しない: この警告は banner 直後 1 行に圧縮し、同一 run 内で繰り返さない(計画行・進捗行に同内容を言い換えない)。
進捗報告は出してよい (見やすい範囲で)
- 各ステップの開始・完了を 1 行ステータスで (
✓ backend=cursor / model=composer-2.5-fast) - 判断に必要な中間結果 (pre-check の要点、resolved model、検出した branch 等)
- なぜこの分岐を取るかの理由を 1 行で (例: 「Reviewer のみ委譲: Worker は別系統で完了済み」)
禁止 (= 冗長さ)
- 同じ事実の 2 回言い換え: 一度言ったことを後段で再説明しない
- 中身のない前置き: 「使い方を確認します」だけの行など、tool call で自明な宣言
- 3 行以上の経緯振り返り: 結論を引き伸ばす長い前置き。経緯が必要なら 1 行に圧縮
- 起動シーケンス中の ★ Insight ブロック: Insight は最終 report で 1 回のみ
違反例 (冗長):
× 「composer 2.5 使うモード」= cursor backend で Composer に委託、ですね(と解釈の言い換え)
× 「前回 Reviewer が止まったので別系統に逃がすのは理にかなっています」(3 行以上の振り返り)
× 「使い方を確認します」 → bash → 「呼べます」(中身のない前置き + 同じ事実の 2 回言い換え)
正常例 (簡潔 + 計画明示):
🚀 cursor / composer-2.5-fast / feat/hah-11-golden-rule-lint / Reviewer
これから: backend resolve → composer に advisory findings 委譲 (read-only) → brain 一次レビューで verdict 確定
Quick Reference
/breezing # スコープを聞く(claude backend)
/breezing all # 全タスク完走(claude backend)
/breezing 3-6 # タスク3〜6を完走
/breezing --codex all # Codex CLI で全タスク委託
/breezing --cursor # cursor backend lean path (--no-discuss all 既定)
/breezing --cursor --reviewer-only # Reviewer のみ cursor に委譲(Worker は別系統で既完了)
/breezing composer 2.5 all # 自然言語 trigger: cursor backend として扱う
/breezing --parallel 2 all # 2並列で全タスク完走
/breezing --no-discuss all # 計画議論スキップで全タスク完走
/breezing --auto-mode all # 互換な親セッションで Auto Mode rollout を試す
Brief Composer v0
/breezing の argument-hint(all|N-M|--codex|--cursor|--reviewer-only|--parallel N|--no-commit|--no-discuss|--auto-mode)のどれにも一致しない自由文入力向けの分解・確認フロー。
- 分類 — Lead は
bash scripts/breezing-brief.sh classify "<args>"を実行する。- 出力
structured→ 既存の structured 引数経路(上記 Quick Reference)へそのまま進む。 - 出力
free-text→ 次ステップへ。
- 出力
- 分解 — Lead の LLM が自由文を 3〜7 個の subtasks に分解し、
brief-card.v1JSON カードを組み立てる(schema:templates/schemas/brief-card.v1.json)。v0 ではbreezing-brief.shは LLM を呼ばない。 - 提示 — カード(goal / subtasks[id,title,dod] / scope_files / risk_notes / confidence)をユーザーに提示する。
confidenceはhigh|medium|lowのいずれか。 - 確定 — ユーザー Yes/No の後、
bash scripts/breezing-brief.sh confirm <yes|no> <card.json>を実行する。yes→DISPATCH: <subtask 数>を出力し、既存 team 経路(worktree-per-task)へ渡す。no→DISPATCH: 0(実行 0 件の dry 契約)。
検証のみ必要な場合: bash scripts/breezing-brief.sh validate <card.json>(exit 0 = valid)。
Options
| Option | Description | Default |
|--------|-------------|---------|
| all | 全未完了タスクを対象 | - |
| N or N-M | タスク番号/範囲指定 | - |
| --codex | Codex CLI で実装委託 | false |
| --cursor | cursor backend lean path(per-run 明示 override。resolver 出力が cursor のときと同等)。Worker 介在 / self_review / sprint-contract 3 段チェーン / Phase 0 を skip し、起動 → 委譲を 3 秒以内に開始する | false |
| --reviewer-only | Reviewer のみ独立系統に委譲(Worker 実装は既完了前提)。--cursor と併用で Composer に逃がす | false |
| --parallel N | Implementer 並列数 | auto |
| --no-commit | 自動コミット抑制 | false |
| --no-discuss | 計画議論スキップ | --cursor で true 既定 |
| --auto-mode | Harness 側の Auto Mode rollout を明示。CC 2.1.111 で不要になった --enable-auto-mode とは別物 | false |
Natural Language Backend Triggers
composer / コンポーザー / Composer で / composer 2.5 / composer モード は、正式に cursor backend の trigger として扱う。
これは --cursor 相当の intent であり、Lead は resolve-impl-backend.sh を経由して backend を確定する。
解決時は明示 override として --backend cursor を渡し、env / project / user file / default より優先させる。
| 入力例 | 解釈 | 実行経路 |
|---|---|---|
| composer 2.5 で | cursor backend | Lead → cursor-companion.sh task --write --workspace <wt> |
| コンポーザーで全部 | cursor backend | Lead → cursor-companion.sh task --write --workspace <wt> |
| composer モード | cursor backend | Lead → cursor-companion.sh task --write --workspace <wt> |
composer は Claude Worker の内側に spawn する追加 agent ではない。
非 claude backend のトポロジーに従い、Lead が Worker agent を挟まずに cursor-companion.sh を直接呼ぶ。
CC 2.1.111 note: Opus 4.7 では literal に
/effort xhighが使える。 built-in/ultrareviewは明示要求時だけ追加で使い、既定レビューは置き換えない。
長時間セッション推奨 (CC 2.1.108+): セッション長が 30 分を超える見込みの場合、plugin bundle root 解決後に
bash "${HARNESS_PLUGIN_ROOT}/scripts/enable-1h-cache.sh"を実行して 1 時間 prompt cache を opt-in すること。 このスクリプトはenv.localにexport ENABLE_PROMPT_CACHING_1H=1を追記する (冪等)。 5 分 TTL の既定キャッシュでは breezing の 1 時間超セッションで cache miss が累積し input token コストが最大 12 倍になりうるため、長時間 team 実行では明示的に opt-in する。 Codex CLI 子プロセス (scripts/codex-companion.sh task --write等) は通常 env 継承でENABLE_PROMPT_CACHING_1Hを読むが、CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1が有効な場合は 明示的に export を維持する shell wrapper が必要。詳細はdocs/long-running-harness.mdを参照。
Execution
このスキルは harness-work に委譲します。 以下の設定で harness-work を実行してください:
- 引数をそのまま
harness-workに渡す - チーム実行モードを強制 — Lead → Worker spawn → Reviewer spawn の三者分離
- Lead は delegate 専念 — コードを直接書かない
- Auto Mode は opt-in 扱い —
--auto-modeは互換な親セッションでの rollout 用フラグとして受け付ける - Advisor は必要時のみ — Worker が
advisor-request.v1を返した時だけ Lead が advisor を呼ぶ
Plan-time 事前確認の扱い
Breezing run 開始時は、Lead が harness-work と同じ preapproval preflight を実行する。
.claude/state/plan-preapprovals.jsonがあればtemplates/schemas/plan-preapproval.v1.jsonで validate する。- 実行対象 task の
decision: approved事項だけを宣言済みとして扱い、Worker briefing に渡す。 secret-readはbash "${HARNESS_PLUGIN_ROOT}/scripts/plan-preapproval.sh" apply-secret-allow "$PROJECT_ROOT"で project config.claude-code-harness.config.jsonのruntimefloor.secretAllowに per-run 反映し、108.2 の project config floor と接続する。- 宣言済み事項では途中停止せず、work 中の宣言済み事項起因
AskUserQuestionはゼロにする。確認は plan 承認時の 1 回のみ。 - 記録に無い未計画の secret-read / 外部送信 / 破壊的操作は従来どおり runtime floor / ask で停止する。安全網を狭めない。
harness-work との違い
| 特徴 | harness-work | breezing (このスキル) |
|------|-----------------|------------------------|
| 並列手段 | 必要数に応じた自動分割 | Lead/Worker/Reviewer の役割分離 |
| Lead の役割 | 調整+実装 | delegate (調整専念) |
| レビュー | Lead 自己レビュー | 独立 Reviewer |
| デフォルトスコープ | 次のタスク | 全部 |
Team Composition
| Role | Agent Type | Mode | 責務 |
|------|-----------|------|------|
| Lead | (self) | - | 調整・指揮・タスク分配 |
| Worker ×N | claude-code-harness:worker | bypassPermissions(現行) / Auto Mode(follow-up)* | 実装 |
| Advisor | claude-code-harness:advisor | 読み取り専用 | 方針助言 (PLAN / CORRECTION / STOP) |
| Reviewer | claude-code-harness:reviewer | bypassPermissions(現行) / Auto Mode(follow-up)* | 独立レビュー |
*親セッションまたは frontmatter が
bypassPermissionsの場合はそちらが優先される。配布テンプレートは現在もbypassPermissionsを使うため、Auto Mode は follow-up の rollout 対象であり、既定挙動ではない。
Mode 1 — Sub-Lead 階層と review→iterate(opt-in)
Go orchestrator 経路(harness work --team)では、Breezing の Lead/Worker/Reviewer 三者分離に加えて Producer → Sub-Lead → Composer の Mode 1 階層を opt-in で重ねられる。Lead(Producer = Claude Code 固定)が lane を Sub-Lead に委譲し、Sub-Lead は orchestrator-spawned headless CLI(Lead と同一 backend)で mini-plan を組み、実装は Composer 2.5(cursor backend)が companion-result.v1 で lane 単位に集約する。HARNESS_TEAM_HIERARCHY=sublead で有効化(default OFF)。
品質面では HARNESS_REVIEW_ITERATE=on で worker 出力を review→iterate ループで wrap できる。fresh-context 並列 advisory + cross-CLI review のあと brain-only verdict を経て、DoD 未達なら同 worktree へ精緻化タスクを再投入し、OK まで反復する(HARNESS_REVIEW_ITERATE_MAX で上限、未収束は human escalation)。配線・契約の詳細は harness-work の「Mode 1 — Producer → Sub-Lead → Composer 階層」「review→iterate ループ」節を正本とする。
Codex Mode (--codex)
公式プラグイン codex-plugin-cc 経由で Codex CLI にすべての実装を委託するモード:
# タスク委託(書き込み可能)
bash "${HARNESS_PLUGIN_ROOT}/scripts/codex-companion.sh" task --write "タスク内容"
# stdin 経由(大きなプロンプト向け)
CODEX_PROMPT=$(mktemp /tmp/codex-prompt-XXXXXX.md)
# タスク内容を書き出し
cat "$CODEX_PROMPT" | bash "${HARNESS_PLUGIN_ROOT}/scripts/codex-companion.sh" task --write
rm -f "$CODEX_PROMPT"
Execution Backend (persistent)
backend 判定は 必ず resolver 経由。HARNESS_IMPL_BACKEND env を直接読んで backend を決めてはならない。
env / --cursor per-run flag / project env.local / user file を
bash "${HARNESS_PLUGIN_ROOT}/scripts/resolve-impl-backend.sh" で precedence 解決し、その出力を backend として使う
(env unset でも project / user file から拾える)。永続 default を cursor にしたい場合は
bash "${HARNESS_PLUGIN_ROOT}/scripts/set-impl-backend.sh" cursor で project / user file に書き込み、
run 開始時に resolver が解決する。review / advisor ロールは Opus に固定したまま。
バックエンド選択の正本(precedence、role-scope、self_review スキップ、cursor banner)は
harness-work の「Execution Backend Selection(実装バックエンド選択)」を参照する。
下の Cursor Backend Fast Path は per-run フラグ (--cursor) を resolver への明示 override として lean path を有効化する別軸であり、本節と併読する。
Cursor Backend Fast Path (--cursor / lean mode)
bash "${HARNESS_PLUGIN_ROOT}/scripts/resolve-impl-backend.sh" の出力が cursor のときに有効
(--cursor は resolver への明示 override として precedence 最上位)。Worker 層を介在させず Lead が直接 cursor-companion.sh を呼ぶ(Phase 85 SSOT、.claude/rules/cursor-cli-only.md Topology 節)。
削除される step(claude backend と比べて節約)
| Step | 削除理由 | 節約秒数 |
|---|---|---|
| claude-code-harness:worker agent spawn | cursor backend は Worker 介在なし | 5-30s |
| self_review 5 件ゲート | worker-report.v1 が cursor では生成されないため不要 | 10-60s × retry |
| sprint-contract 3 段チェーン (generate→enrich→ensure) | Worker 契約不要なら contract 不要 | 2-5s × N |
| Phase 0 Q1-Q3 interactive | --no-discuss all 既定 (Plans/Depends は Lead が直読み) | 15-30s |
| Effort スコアリング | cursor backend では ultrathink 注入不要 | 0.5-1s × N |
| Plans.md re-parse (per task) | session 内 cache (mtime+hash で短絡) | 3-8s |
合計 baseline 15-35s → target 3-7s で 1 タスク目の cursor 委譲開始までを短縮。
既定 flow(cursor backend)
- banner + 実行計画 (
🚀 cursor / <model> / <branch> / <task>+ これから進める 2-4 step、合計 5 行以内、1 秒以内) - 1 bash で並列 pre-check:
git branch --show-current+cat VERSION+Plans.md tail+cursor-agent --version - 1 bash で resolve:
bash "${HARNESS_PLUGIN_ROOT}/scripts/resolve-impl-backend.sh"+bash "${HARNESS_PLUGIN_ROOT}/scripts/model-routing.sh" --host cursor --role worker --field model - 即 委譲:
bash "${HARNESS_PLUGIN_ROOT}/scripts/cursor-companion.sh" task --write --workspace <wt> "<task>" - cursor 出力を Lead が diff レビュー → cherry-pick → Plans.md
cc:done [hash]更新
Reviewer-only mode (--cursor --reviewer-only) — read = lean
Worker 実装は既完了(別系統 = claude / Codex で済んだ)、advisory pre-review を Composer に出してもらう lean path。read-only 委譲なので worktree 不要・cherry-pick 不要・cursor 出力の取り込みレビュー不要(cursor は新たな diff を生まないため)。ただし対象 diff への brain 一次レビュー(primary verdict)は省略しない:
- banner + 計画:
🚀 cursor / composer-2.5-fast / review+ 「これから: composer に advisory findings を委譲 → brain 一次レビューで verdict 確定」 bash "${HARNESS_PLUGIN_ROOT}/scripts/cursor-companion.sh" task "diff レビュー: <base_ref>..HEAD"—--writeも--workspaceも付けない- companion は
--write未指定で default--mode ask(hard read-only stop) になる (cursor-companion.sh の workspace guard は--write時のみ発火) - cursor 側はファイル書込・コマンド実行が disabled、worktree 隔離不要
- companion は
- cursor 出力 (REQUEST_CHANGES / APPROVE 相当) を Lead が解釈し、
dual_review.cursor_verdictに advisory として格納 - primary verdict は brain reviewer から取る。cursor 単独では APPROVE を確定しない (spec.md Execution Backend Contract の self-review scope 契約 = 「diff を生成した同一コンテキストは自分の出力をレビューしない」と整合)。この lean path 自体が fresh-context advisory pre-review であり、委譲先 cursor session は実装 worker と会話状態を共有しないこと
- brain 一次レビュー: Lead が cursor advisory findings を入力として対象 diff を自ら検分し、verdict(
APPROVE | REQUEST_CHANGES)を出す。brain reviewer が利用不能(rate limit 等)の間は verdict を確定せず、タスクをcc:wipのままユーザー判断へ渡す(cursor advisory のみでcc:doneにしない) - brain の APPROVE 後に Plans.md
cc:done [hash]を Lead が更新
read mode で省略できるもの: 専用 .git worktree / cursor 出力の取り込みレビュー / cherry-pick / worker-report.v1 / self_review 5 件。省略不可: 対象 diff への brain 一次レビュー(verdict 確定)。
read mode でも保持必要: .cursorignore / egress allowlist (*.cursor.sh) / permissions.json (best-effort)。詳細は .claude/rules/cursor-cli-only.md 「Read mode delegation (lean path)」節を参照。
用途:
- Anthropic 側 server rate limit で Reviewer が止まった時に advisory findings を先に集めておく前倒し(brain verdict の代替にはならない — verdict は brain 復帰後に確定)
- Worker 完了済みで Reviewer だけ別系統に分散
- Codex review が auth 失敗した時の manual fallback
Cursor adapter support claim
Cursor は依然 internal-compatible tier(Phase 87 / PR #174 で promotion)。supported public claim は CI-gated workflow smoke 充足まで継続 gate。--cursor lean path は support tier を昇格させない。
Bootstrap route: .cursor/AGENTS.md + .cursor-plugin/plugin.json。
Verification:
bash tests/test-cursor-adapter-candidate.sh
bash tests/test-support-claim-wording.sh
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 実装 + 必要時 Advisor + Reviewer レビュー)
Phase C: Post-delegate(統合検証 + Plans.md 更新 + commit)
Advisor Protocol
Worker は generic な subagent を増やさない。 迷った時は構造化 JSON で相談要求だけ返し、Lead が advisor を呼ぶ。
- Worker →
advisor-request.v1 - Lead → Advisor
- Advisor →
advisor-response.v1 - Lead → 同じ Worker に advice を返して続行
- Reviewer は最後の成果物だけを見る
相談条件は loop / solo とそろえる。
- 高リスク task(
needs-spike/security-sensitive/state-migration)の初回実行前 - 同じ原因の失敗が 2 回続いた後
- plateau により
PIVOT_REQUIREDを返す直前 - 同じ
trigger_hashは 1 回だけ。task ごとの相談回数は最大 3 回
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 の出力と補完し合う。
Silence Policy(長時間実行の通知整理)
Codex 0.123.0 の realtime handoff では、background agent が transcript delta を受け取り、必要ない時は明示的に沈黙できる。
Breezing の progress feed はこの前提に合わせ、通知を「作業の節目」に絞る。
報告するもの:
- task 完了、blocked、validation failure、review
REQUEST_CHANGES - Advisor の
PLAN/CORRECTION/STOP - Reviewer の
APPROVE/REQUEST_CHANGES - advisor / reviewer drift、plateau、contract readiness failure
- user が明示的に status を求めた時の要約
沈黙してよいもの:
- transcript delta を受け取っただけで、判定や status が変わっていない時
- tool stdout の細かな増分で、log に残っていれば十分な時
- 並列 Worker の待機中 heartbeat
頻度は「task 完了ごとに 1 回」を基本にする。 heartbeat を増やして安心感を作るのではなく、status / log / drift 検知に責務を分ける。 ただし Advisor request 未応答、Reviewer result 未到着、plateau 直前の警告は silence 対象にしない。
Monitor ツール活用ガイド (CC 2.1.98+)
長時間実行コマンドを監視する時は、ポーリング (Read で定期的にファイル末尾を読む) ではなく Monitor ツール を使用する。Monitor はバックグラウンドプロセスの stdout 各行を逐次通知として Lead に届けるため、polling より低レイテンシかつ低トークン消費で状況を把握できる。
適用例:
go test ./... -vの実行中進捗監視gh run watchによる GitHub Actions 進捗追跡npm run build --watch/vite build --watchのビルドエラー即時検知codex-companion.sh status <job-id>での Codex job 完了検知docker-compose logs -f/kubectl logs -fのデプロイログ追跡
使い分けの判断基準:
| 対象 | Monitor 使う? | 理由 |
|---|---|---|
| Agent (Worker / Reviewer) の完了監視 | 不要 | Agent 層が自前で完了通知する |
| run_in_background: true で投げた shell process | 推奨 | stdout 各行を逐次通知で拾える |
| 短時間の一発コマンド (go test 1 回実行) | 不要 | 通常の Bash tool 実行で十分 |
| 長時間 tail / watch / stream 系コマンド | 推奨 | polling より効率的 |
Breezing Lead での典型パターン:
Lead:
Task(Worker1, ...) ← Agent 完了待ち (Monitor 不要)
Task(Worker2, ...) ← 同上
Bash(run_in_background, "gh run watch --exit-status")
Monitor(tailCommand="...") ← CI 失敗を即時検知 → Worker に修正指示
これにより Lead が「Worker 完了 → CI 失敗検知 → 修正指示」の反応速度を上げられる。
Review Policy(全モード統一)
Breezing モードでもレビューは Codex exec 優先 → 内部 Reviewer フォールバック の統一ポリシーに従う。
詳細は harness-work の「レビューループ」セクションを参照。
- Worker が worktree 内で実装・commit →
worker-report.v1(self_review 5 件) を Lead に返却 - self_review ゲート (Reviewer spawn 前): Lead が
self_review[].verifiedとevidenceを機械検証。1 件でもverified:falseorevidence:""なら Reviewer を spawn せず Worker に自動差し戻し(同一セッション内 最大 2 回、3 回目で escalate) - Lead が Codex exec でレビュー(120s タイムアウト、フォールバック: Reviewer agent)
- REQUEST_CHANGES → Lead が SendMessage で Worker に修正指示、Worker が amend(最大
MAX_REVIEWS回。MAX_REVIEWS = read_contract(contract_path, ".review.max_iterations") or 3) - APPROVE → Lead が main に cherry-pick → Plans.md を
cc:完了 [{hash}]に更新
完了報告(Phase C — Lead が生成)
全タスク完了後、Lead が以下の手順でリッチ完了報告を生成する:
git log --oneline {base_ref}..HEADで全 cherry-pick コミットを収集git diff --stat {base_ref}..HEADで全体の変更規模を取得- Plans.md の
cc:TODO/cc:WIP残タスクを抽出 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 秒で完了する設計)。
Universal Violations Injection(セッション内 Worker 間の学習伝播)
同一 /breezing 起動内で蓄積された Reviewer の universal gotchas を次 Worker の briefing 冒頭に自動注入する。同一セッション内のみ有効(セッション終了で破棄、session-memory には書かない)。
# Phase A 開始時に Lead プロセスの in-memory 配列を初期化
universal_violations = [] # List[str] — このセッション内で蓄積
# Phase B で Worker を spawn する直前、briefing 冒頭に注入:
def build_worker_briefing(task, contract_path):
header = ""
if universal_violations:
header = (
"🚨 同一セッションで既に検出された universal 違反(再発禁止):\n"
+ "\n".join(f"- {v}" for v in universal_violations)
+ "\n\n"
)
return header + f"タスク: {task.内容}\nDoD: {task.DoD}\ncontract_path: {contract_path}\nmode: breezing"
# Reviewer が review-result.v1 を返した後、Lead が scope="universal" のみ抽出して累積:
for update in reviewer_result.memory_updates:
# 後方互換: 文字列は task-specific 扱い → 無視
if isinstance(update, str):
continue
if update.get("scope") == "universal":
universal_violations.append(update["text"])
方針: 過剰設計回避のため、session-memory や decisions.md への永続化は行わない。Lead プロセスの in-memory 配列に保持するだけで、/breezing セッション終了時に破棄する(issue #87 本文の方針)。
依存グラフに基づくタスク割り当て
Plans.md に Depends カラムがある場合(v2 フォーマット)、依存グラフに従ってタスクを実行する:
- Depends が
-のタスクを先に実行。独立タスクが複数あれば並列 spawn 可能 - 各 Worker 完了後、Lead がレビュー→cherry-pick(harness-work Phase B 参照)
- 依存元タスクが main に cherry-pick されたら、そのタスクに依存していたタスクを次に実行
- 全タスクが完了するまで繰り返す
注意: 各タスクの「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 内で自動起動)