Agent dispatch should default to opus (not inherit the session model) — quota blowout degrades verify

[kiki830621]

Problem

Original text:
「我覺得idd裡面要派agent的時候應賅預設用opus才對，不然會炸掉...這可能也要連帶改parallel-ai-agent這個plugin」
— Source: 使用者訊息 2026-07-02

IDD 派發 subagent 時（idd-verify 的 6-AI ensemble——dynamic-workflow backend 的 agent() 與 manual fan-out 的 Agent()——皆未指定 model）,agents 繼承主迴圈模型。當 session 跑在高階模型（如 Fable/Opus 級）時,每輪 verify 的 token 消耗巨大且會耗盡 session quota（「炸掉」）。

實測證據（2026-07-02, bestASR session）

• 每輪 6-AI verify 實測 subagent tokens：563k / 602k / 649k / 759k / 1,092k
• bestASR#14 的 verify 輪 devil's advocate agent 陣亡,workflow failures 欄逐字：

  [devils-advocate] failed: You've hit your session limit · resets 12:50pm (Asia/Taipei)
  該輪退化為 4-AI（Codex 亦未完成）,對抗深度低於既定契約——quota 耗盡直接侵蝕 verify 品質。

• 根因定位：skills/idd-verify/ensemble-workflow.js 的所有 agent(...) 呼叫皆未帶 opts.model；Workflow/Agent tool 的語意是「省略 → 繼承主迴圈模型」。manual fan-out 路徑（SKILL.md Step 2 的 5 個 Agent(subagent_type=general-purpose)）同樣未指定。

Type

enhancement

Expected

IDD 的 agent 派發預設指定 model: 'opus'（reviewer/DA 這類重讀輕寫的 lens 用 Opus 已足夠,且不與主 session 共享同一個 quota 池的壓力面）,並保留覆蓋機制（env var 或 config 欄位,如 IDD_AGENT_MODEL）讓使用者升降級。Codex lens 不受影響（本就跨模型）。

Actual

ensemble-workflow.js 與 manual fan-out 均省略 model → 繼承 session 模型；高階模型 session 下 verify 成本 ×N、quota 撞牆時 lens 靜默降級（fail-closed finding 有記,但深度已損）。

Impact

• skills/idd-verify/ensemble-workflow.js（agent() 呼叫加 model）
• skills/idd-verify/SKILL.md（manual fan-out 的 Agent 呼叫模板 + 文件）
• 其他派 agent 的 skill 面盤點（idd-diagnose / idd-implement 若有 fan-out）
• 連帶：PsychQuant/parallel-ai-agents plugin 同型問題（tracking issue 見 cross-link）

設計考量（供 diagnose）

• 預設 opus vs 跟隨 session 的取捨：verify lens 的工作是讀 diff + 寫 findings,Opus 的性價比合適;但「鎖死」會犧牲想用最強模型驗證的場景 → 預設 + 覆蓋
• Agent tool 的 model 參數接受 sonnet | opus | haiku | fable；workflow agent() 為 opts.model

Clarity Surface(idd-clarify run 2026-07-02T06:02:25Z)

Type	Source	Suggested canonical	Status
ambiguity	"預設用opus"	硬編 opus vs 「預設 opus + 覆蓋機制（env var / config）」——issue 設計考量段傾向後者,diagnose 需定案	resolved @ 2026-07-02T06:04:18Z (reason: 預設 opus + 覆蓋機制——不硬編)
ambiguity	"idd裡面要派agent的時候"	範圍:僅 idd-verify ensemble（重災區,實證在此）vs 全部派 agent 的 skill 面（diagnose/implement 若有 fan-out 一併）	resolved @ 2026-07-02T06:04:18Z (reason: 全部 fan-out 盤點,同一預設一體套用)

---

Current Status

• Phase: closed
• Updated: 2026-07-02
• Complexity: Spectra · Conflict Class: A_parallel_safe
• Verify: PASS post-fix（0 blocking；HIGH refuted with live transcripts—6/6 agents on claude-opus-4-8）
• Implementation: e12b3d9 on idd/205-agent-dispatch-default-opus (Spectra agent-dispatch-model-default, tasks 12/12)
• Diagnosis: Agent dispatch should default to opus (not inherit the session model) — quota blowout degrades verify #205 (comment)

[kiki830621]

Tracked in:

• Agent dispatch should default to opus (not inherit the session model) — tracking issue-driven-development#205 parallel-ai-agents#20

[kiki830621]

Clarity Resolution（使用者裁決 2026-07-02）

Original text:
「預設 opus + 覆蓋機制，範圍全部 fan-out 都盤點，這是在 https://github.com/PsychQuant/issue-driven-development 開的idd」

結構化詮釋（供 diagnose）：

1. Row 1（機制）：預設 opus + 覆蓋機制——不硬編；覆蓋面（env var 如 IDD_AGENT_MODEL / config 欄位）由 diagnose/design 定細節。
2. Row 2（範圍）：全部 fan-out 盤點——不只 idd-verify ensemble；所有派 agent 的 skill 面（manual fan-out、其他 skill 若有 Agent/Workflow 派發）一併清查並套用同一預設。
3. Repo 確認：本 issue 屬 PsychQuant/issue-driven-development（IDD plugin 自身），非使用 IDD 的下游 repo。

[kiki830621]

Diagnosis

Type

enhancement（成本/quota 防護——實證驅動）

Root Cause

idd-verify 的兩條派發路徑都未指定 agent model：(1) ensemble-workflow.js 的全部 agent(...) 呼叫（reviewers/Codex-runner/DA）無 opts.model；(2) SKILL.md manual fan-out 的 5 個 Agent(subagent_type=general-purpose) 模板無 model 參數。Workflow/Agent tool 語意「省略 → 繼承主迴圈模型」→ 高階模型 session 下每輪 verify 燒 563k–1,092k subagent tokens；實證（2026-07-02 bestASR session）：bestASR#14 verify 輪 DA agent 逐字死因 You've hit your session limit——quota 耗盡把 6-AI 降級 4-AI，直接侵蝕對抗深度。

全 repo fan-out 盤點（使用者裁決範圍：全部）

派發面	位置	現況
ensemble agent() ×3 站點（4 reviewers、codex-runner、DA）	skills/idd-verify/ensemble-workflow.js	無 model
manual fan-out Agent() ×5 模板 + retry/fallback	skills/idd-verify/SKILL.md Step 2/2.5	無 model
spectra-archive 的 sync 委派（Task general-purpose ×1）	references/spectra-skills/spectra-archive/SKILL.md	無 model（輕量單發，同規則一體適用）
其他 skills	grep 盤點僅上述三面	—

Impact

• ensemble-workflow.js：args 增 agentModel（string，預設 'opus'）；三個 agent() 站點帶 model: A.agentModel；Codex lens 本身不受影響（跨模型 via codex-call），但其 runner agent 同樣吃預設
• skills/idd-verify/SKILL.md：workflow 呼叫段組 args 時解析 IDD_AGENT_MODEL（env var，缺省 opus）傳入；manual fan-out 的 Agent 呼叫模板加 model 參數 + 同一解析；文件化覆蓋機制
• references/spectra-skills/spectra-archive/SKILL.md：Task 委派加 model 註記
• Spec：openspec/specs/idd-verify MODIFIED——ensemble/fan-out agents SHALL run on configured dispatch model（default opus、env 覆蓋、Codex 例外聲明）
• README/CHANGELOG

Strategy

• Spectra 三部曲（spec MODIFIED 需對齊）；tasks：ensemble args + 站點、SKILL.md 解析與模板、archive 委派註記、spec delta、文件 — done（change agent-dispatch-model-default，tasks 15/15，spec delta ×2：idd-verify + parallel-orchestration）
• 驗收：ensemble-workflow.js 三站點皆帶 model；IDD_AGENT_MODEL=sonnet 覆蓋路徑文件化；雙軌（字面+prose）盤點零殘留未指定站點（Codex 例外聲明除外）— verify PASS post-fix，live run wf_6c1d8ee6-5f3 證實 6/6 agent 實跑 claude-opus-4-8

Conflict Class

A_parallel_safe — 集中於 idd-verify 面；無共享資源競合。

Complexity

Spectra — 觸及 living spec（idd-verify MODIFIED）+ 跨 skill/workflow/reference 三面；本 repo 為 Spectra-governed。

Vagueness Pre-check

• V1: 1 — Clarity rows 已由使用者裁決（預設 opus + 覆蓋；全 fan-out）
• V4: 1 — 驗收可測（grep 盤點 + args 契約）
• Triggered: no
  [Layer V evaluated under UNATTENDED MODE — /idd-all orchestrator]

Risks

• Workflow agent() 的 opts.model 接受 'sonnet'|'opus'|'haiku'|'fable'——env 覆蓋值需驗證（非法值 fail-loud 不靜默吞）
• 舊 caller 未傳 agentModel → workflow args 預設 'opus' 兜底（雙層預設，skill 端與 workflow 端一致）

Residue

(none)

Sister Concerns Filed

(none new) — parallel-ai-agents 同型已由 tracking issue PsychQuant/parallel-ai-agents#20 持有。

[kiki830621]

Verify: #205

Engine

dynamic-workflow backend — 6/6 完整（4 lens + DA + Codex/gpt-5.5）、0 process gap；本輪即以 agentModel: 'opus' 派發（self-dogfood）。Engine 揭露：dispatch model = opus（workflow 回傳 dispatchModel: 'opus'，與 transcript 實跑一致）。

要求覆蓋率

4/4（預設 opus、IDD_AGENT_MODEL 覆蓋 + fail-loud、全 fan-out 盤點、揭露）——其中「全 fan-out 盤點」被 verify 抓出首輪為假陰性，當輪補齊（見 5/7）。

Findings（合併後，18 筆，triage）

#	Sev	Finding	Action
1	HIGH (DA)	agent() 可能不吃 model opt → 修復是 no-op + 審計行造假	REFUTED（live 一手證據）：本輪 run wf_6c1d8ee6-5f3 由 claude-fable-5[1m] session 派發、agentModel:'opus'——6/6 agent transcript 記錄 model=claude-opus-4-8（真降級、非掉參數）；Agent tool 的 model 參數 enum 即 `sonnet
2	MED (codex)	skill 端 fail-loud 用了未定義的 abort → 非法值可能照跑	Fixed：改逐字可執行的 echo >&2 … exit 64
3	MED (codex)	Step 2.5b retry 只有 prose 提醒、無帶 model 的具體模板（事故正是 recovery 路徑）	Fixed：補具體 fresh-spawn Agent({... model: "${AGENT_MODEL}" ...}) 模板
4	MED (codex)	workflow 層把顯式非法值靜默正規化為 opus，牴觸 spec「SHALL fail loudly」	Fixed：顯式非法值於任何派發前 throw；僅 absent → opus（兩層一致）
5	MED (regression)	盤點漏 idd-diagnose #182 fan-out；proposal 完整性宣稱不實	Fixed：#182 fan-out 補規則、parallel-orchestration MODIFIED spec delta、proposal 措辭如實化
6	MED (DA)	「預設 opus 降負載」前提未證：若 session 本來就是 opus 則 no-op	Refuted for incident class + documented：事故 session 為 Fable 級（高於 opus），live 證實 pin 是真降級；sub-opus session 的「反向升級」caveat 記入 design + SKILL.md
7	MED (DA)	盤點比 5 更漏：spectra-audit 3-agent、spectra-apply [P]；字面 grep 對 prose 派發結構性盲視	Fixed：vendored refs doc-only 對齊 + 雙軌（字面+prose）掃尾；殘餘 hit（skeptic variant）由同檔檔級契約條款覆蓋
8	LOW (codex)	回傳的 dispatchModel 沒被揭露路徑用到	Fixed：Engine 行以 dispatchModel || $AGENT_MODEL 為準
9	LOW (codex)	spectra-archive 註記非具體值	Fixed：具體 "opus" + vendored-copy 範圍註記
10/18	LOW/INFO	低階 session 被預設升級的成本面	Documented（同 6 的 caveat）
11	LOW (logic)	新增 opt 若同步 throw 會炸整個 workflow	Addressed：model 是 runtime 文件化 opt（無 unknown-opt throw）；新 throw 刻意發生在派發前 = spec 要的 fail-loud，非缺陷
12	LOW (regression)	spectra-* 是第三方 vendored copy、IDD_AGENT_MODEL 跨 skill 耦合	Fixed：措辭改 doc-only alignment、canonical 規則歸 idd-verify；CHANGELOG 同步軟化
13	LOW (DA)	白名單裡的 fable 疑似捏造 alias、打穿 fail-loud	REFUTED：fable = Claude Fable 5（現役 Mythos-class；本 session 主迴圈即 claude-fable-5[1m]；Agent tool enum 含之）；provenance 註解記入 JS
14–17	LOW/INFO	DA 對 logic lens 的反駁、Codex 無法本地驗證 checks、parallel-ai-agents 延後、覆蓋機制的降級面	Noted：checks 由 coordinator 實跑（commits 可查）；sibling 由 parallel-ai-agents#20 追蹤；降級路徑因揭露行而可審計

In-scope fixes

2 commits：e12b3d9（實作）+ 5272138（verify fixes）。node --check 綠、spectra validate 綠、雙軌盤點掃尾乾淨。

Residue

• parallel-ai-agents#20（sibling 同型修改，另 repo，追蹤中）
• vendored spectra-* 與 upstream 的 divergence 為 doc-only 對齊之固有性質（已於 design 記載）

Result

PASS（verify-gated, post-fix） — 0 blocking。本輪雙教訓：(1) load-bearing 假設要用一手 runtime 證據關（transcripts 的 model 欄位一錘定音，六個 reviewer 沒人查）；(2) 派發面盤點必須雙軌——字面 call-token grep + prose 描述掃描，單軌即假陰性。

[kiki830621]

Closing Summary

Problem

IDD 派發 subagent（idd-verify 6-AI ensemble 的 workflow agent() 與 manual fan-out Agent()）皆未指定 model，agents 繼承 session 主迴圈模型。高階（Fable 級）session 下實測每輪 verify 563k–1,092k subagent tokens，bestASR#14 的 verify 輪 devil's advocate 死於 session limit（逐字：You've hit your session limit），該輪退化 4-AI——quota 耗盡直接侵蝕 verify 品質。

Root Cause

Workflow/Agent tool 的語意是「省略 model → 繼承主迴圈模型」，而 plugin 內所有 fan-out 站點都省略了它。且首輪盤點用字面 grep（Agent({|agent(），對 prose 描述的派發（idd-diagnose #182 fan-out、spectra-audit「Launch 3 agents」、spectra-apply「dispatch as parallel agents」）結構性盲視——差點讓「全 fan-out 一體套用」的裁決只落地一半。

Solution

兩層顯式 dispatch model（Spectra change agent-dispatch-model-default）：

• ensemble-workflow.js：AGENT_MODEL 由 args.agentModel 解析（whitelist sonnet|opus|haiku|fable；absent → opus；顯式非法值於任何派發前 throw），三個 agent() 站點帶 model: AGENT_MODEL，回傳 dispatchModel 供揭露。
• idd-verify SKILL.md：engine 選擇前解析 IDD_AGENT_MODEL（未設 → opus；非法 → 逐字可執行的 exit 64 usage error，fail-loud 不靜默換模型）；5 個 manual 模板 + Step 2.5b retry 具體 fresh-spawn 模板帶 model: "${AGENT_MODEL}"；Engine 行以實跑 dispatchModel 揭露。
• 盤點補齊（verify 抓出後雙軌掃尾）：idd-diagnose [feature] agent-teams + Workflow orchestration for IDD: parallel diagnose fan-out + teams-N-lane batch with conflict-class serialization #182 fan-out、parallel-orchestration.md 契約條款 + MODIFIED spec delta、vendored spectra-audit/apply/archive doc-only 對齊。
• Codex 的 gpt-5.5 端本就跨模型、不受影響；驅動它的 Bash-agent 照樣被 pin。方向性 caveat 已文件化：預設 opus 只在 session tier 高於 opus 時降負載，sub-opus session 要顯式降級。

Verification

6-AI verify（self-dogfood：該輪 ensemble 即以 agentModel:'opus' 派發）→ 18 findings。HIGH「model opt 可能不被 runtime 尊重、審計行造假」被一手證據駁倒：run wf_6c1d8ee6-5f3 由 claude-fable-5[1m] session 派發，6/6 agent transcript 記錄 model=claude-opus-4-8（真降級）。4×MEDIUM（abort 未定義、retry 無具體模板、workflow 層靜默正規化、盤點假陰性）當輪修復。node --check / spectra validate 綠。Master report：#205 issuecomment-4863021521。

Changes

• PR feat: explicit dispatch model for all agent fan-outs — default opus, IDD_AGENT_MODEL override (#205) #206（squash → 2a58fd1）：e12b3d9 實作 + 5272138 verify fixes
• plugin issue-driven-dev 2.87.0 → 2.88.0；Spectra change agent-dispatch-model-default（spec deltas：idd-verify、parallel-orchestration）
• 註：merge-completeness gate rc=3 為 squash 下 intra-branch supersession 假陽性（5272138 改寫 e12b3d9 的行）——已以最終內容機械驗證 origin/main（model: AGENT_MODEL ×3、VALID_DISPATCH_MODELS 在檔），mis-detection 記錄在案

Residue

• Agent dispatch should default to opus (not inherit the session model) — tracking issue-driven-development#205 parallel-ai-agents#20 — sibling 同型修改（另 repo tracking issue，本 issue 的 group 對應項）
• vendored spectra-* reference copies 與 upstream 的 divergence 為 doc-only 對齊之固有性質（design.md 已記載）

Distribution Sync

IDD repo 即 git-based marketplace：marketplace.json issue-driven-dev 2.87.0 → 2.88.0 隨本次 close chain 同步（session 先例第 4 次：0.2.1 / 0.3.0 / 0.3.1 → 2.88.0）。