cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義

[kiki830621]

Problem

Original text:
「「Cluster → 1 PR」跟「direct-commit」直接衝突 — cluster-PR mode 強制開 PR（idd-implement 明文「不接受 --no-pr」），direct-commit 則不開 PR。我需要你定一個：這樣真的好嗎？要強制 PR 嗎」
— Source: 使用者於 /idd-issue 提出

IDD 有兩條互斥的 PR 路徑決策，在 cluster 情境下直接衝突，且衝突的解法目前未文件化、行為未定義。

衝突點

來源	規則
references/pr-flow.md:22	--no-pr flag → direct-commit path（無條件，path-resolution 演算法權威表）
references/pr-flow.md:25	pr_policy: "never" → direct-commit path
skills/idd-implement/SKILL.md:49	「Cluster-PR mode 強制 PR path（不接受 --no-pr）」
references/batch-and-cluster.md:133	「Cluster-PR mode always uses PR path; never direct-commit」

pr-flow.md 是 path resolution 的 canonical 演算法（line 22–26 的優先序表），但它完全沒提 cluster 例外。例外散落在另外兩個檔案。一個照 pr-flow.md 讀的人會認定 --no-pr 永遠生效。

兩個獨立缺陷（無論「要不要強制」的答案是什麼都成立）

1. Silent + 未文件化的 override
   Fork detection 強制 PR 時會印一行 notice（pr-flow.md:44「repo is a fork → PR path enforced」）。cluster 強制 PR 沒有對等 notice，pr-flow.md 的演算法表也沒列這個 carve-out。使用者帶 --no-pr 跑 cluster 時，flag 被無聲吃掉。

2. --no-pr 撞上 cluster 的行為「未定義」
   idd-implement/SKILL.md:49 只說「不接受」。不接受 = abort？= 印警告後忽略？= 靜默忽略？skill 沒寫，三種都可能，實作會漂移。

設計問題本身：強制是否正確？

batch-and-cluster.md:133 給的理由是「cluster on direct-commit = stacked half-isolated changes on default branch」。但 direct-commit path 實際語意是「commit 到 current branch」（idd-implement Phase 0.5：stay on current branch），不必然是 default branch。若使用者本來就在一條 feature branch 上，cluster direct-commit 就是 N 個 issue 的 commit 落在那條 branch — 未必是「污染 default branch」。理由部分成立、但被誇大。

候選解法（待 diagnose 決定，此處僅列出不預判）：

• A. 維持強制，但改為「明示 + 一致」 — cluster 一律 PR；遇到 --no-pr / pr_policy:never 時印 explicit override notice（比照 fork detection），並把這個 carve-out 補進 pr-flow.md 的演算法表。改動最小。
• B. cluster 容許 --no-pr — 降級為「1 條共用 branch + N 個 Refs #N commit、不開 PR」。verify 端有 /idd-verify --branch / --commits 可覆蓋。尊重 direct-commit 使用者。
• C. 問 — cluster + direct-commit policy → AskUserQuestion 確認，不靜默。

Type

refactor（既有行為的一致性 / 文件契約缺陷；非新功能）

Expected

cluster 與 single-issue 的 PR 路徑決策有單一、文件化、行為明確的契約：

• pr-flow.md 的 path-resolution 演算法是唯一 source of truth，cluster 例外（若保留）必須列在表內。
• 任何 override（fork / cluster）都印出 explicit notice，比照 fork detection 既有作法。
• --no-pr 撞 cluster 的結果是明確指定的單一行為（abort 或 degrade 或 ask），不是「未定義」。

Actual

• pr-flow.md 演算法表說 --no-pr 無條件生效；idd-implement.md:49 + batch-and-cluster.md:133 說 cluster 推翻它 — 三檔互相矛盾。
• cluster 強制 PR 無 notice、無文件。
• --no-pr + cluster 的行為（abort / 忽略 / 詢問）未在任何 skill 指定。

Impact

• 影響的檔案：references/pr-flow.md、references/batch-and-cluster.md、skills/idd-implement/SKILL.md（可能含 idd-all / idd-plan 的 cluster 路徑）。
• 影響的使用者流程：pr_policy: "never" 或習慣 --no-pr 的使用者，一旦把多個 issue number 丟進 idd-implement 就會拿到出乎意料的 forced-PR，且看不到原因。
• 影響 IDD 自身的文件可信度：canonical 演算法檔（pr-flow.md）與實際行為不符。

Notes

由 PR #94（auto-close-trap cluster）的工作過程中浮現 — 該 cluster 走 --pr，使用者注意到若改 direct-commit 偏好會與 cluster 強制 PR 衝突。

---

Current Status

Phase: closed

Complexity

Plan — user picked Option A in /idd-all session.

Next

Done. PR #99 merged (squash b7f72ff). Follow-up #100 tracks 2 non-blocking deferred items.

History

• 2026-05-18 — issue filed via /idd-issue (manual fill)
• 2026-05-19 — diagnosed (Plan tier): comment-4483898985
• 2026-05-19 — Implementation Plan (Option A): comment-4483913507
• 2026-05-19 — Implementation Complete + PR cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #99: comment-4483920623
• 2026-05-19 — verified: 6-AI × 2 rounds (R1 CONDITIONAL → R2 6/6 PASS) + R3 doc fix. PR cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #99 commits cbe6f5d / 5351116 / 04c51cb
• 2026-05-19 — follow-up cluster mode: feature-branch direct-commit tension + cluster-detection glob looseness (follow-up from #96) #100 filed (feature-branch tension + glob looseness, both non-blocking)
• 2026-05-19 — merged (PR cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #99 → squash b7f72ff) + closed: comment-4484225150

[kiki830621]

Diagnosis

Type

refactor — 既有行為的一致性與文件契約修補；非新功能,非單純 bug。

Root Cause Analysis

衝突是 3 層的:

Layer 1 — 文件矛盾(canonical table 未列例外)

references/pr-flow.md 的 path-resolution 演算法表(line 22–26)宣告:

1. --pr flag                     → PR path
2. --no-pr flag                  → direct-commit path   ← 「無條件」
3. fork detected                 → PR path enforced
4. config.pr_policy = "always"   → PR path
5. config.pr_policy = "never"    → direct-commit path
6. config.pr_policy = "ask"      → AskUserQuestion

這張表是 IDD path resolution 的 single source of truth。但 cluster 例外不在表內,而是散落於兩個下游檔案:

• skills/idd-implement/SKILL.md:49 — 「Cluster-PR mode 強制 PR path(不接受 --no-pr)」
• references/batch-and-cluster.md:133 — 「Cluster-PR mode always uses PR path; never direct-commit」

讀者照 pr-flow.md 預期 --no-pr 永遠生效,實際在 cluster 場景被推翻。三檔互相矛盾,沒有單一可信來源。

Layer 2 — Silent override(無 notice)

pr-flow.md:44 對 fork detection 寫了 explicit notice:「repo is a fork → PR path enforced」。同類的 override(cluster carve-out)沒有對等 notice。使用者帶 --no-pr 跑 cluster 時 flag 被無聲吃掉、看不到原因 — 與 fork detection 的既有規範不一致。

Layer 3 — 行為未定義

idd-implement/SKILL.md:49 只說「不接受」。未指定「不接受」具體意指:

• abort with structured error?
• 印警告後當作 --pr 處理?
• 靜默忽略 flag,繼續走 PR mode?

三種實作對使用者體驗截然不同(abort = 必須重打指令;warn-and-continue = 看得到 override;silent = 看不到)。Skill 沒寫,實作會 drift。

設計問題本身(超出 3 個獨立 bug)

batch-and-cluster.md:133 給的強制理由是「cluster on direct-commit = stacked half-isolated changes on default branch」。但這個理由只在使用者起手是 default branch 時成立。idd-implement Phase 0.5 對 direct-commit path 的契約是「stay on current branch」 — 若使用者本來就在 feature branch idd/foo-baz 上,cluster direct-commit 就是 N 個 Refs #N commits 落在 idd/foo-baz,並非污染 default branch。

「強制 PR」的理由部分成立(default branch 場景)、但被誇大(feature branch 場景理由不適用)。

Impact

受影響的物件	衝擊
references/pr-flow.md	Canonical 演算法表與實際行為不符(可信度損失)
references/batch-and-cluster.md	規則正確但落在錯誤位置(讀者不會去 batch 文件找 path resolution)
skills/idd-implement/SKILL.md	第 49 行的 "不接受" 是行為 stub 而非規格
可能受影響: skills/idd-all/SKILL.md、skills/idd-diagnose/SKILL.md(batch mode)、skills/idd-close/SKILL.md(cluster mode)	三者各自有 path/mode resolution 段落,需驗證對 cluster 例外的處理一致
使用者流程	pr_policy:"never" 或慣用 --no-pr 的使用者把多個 issue 丟進 idd-implement → 拿到出乎意料的 forced PR,且看不到原因。違反「surprise-free」契約。
IDD 文件可信度	三檔互相矛盾、canonical 來源失效 — 是 IDD「全部規格內可驗證」這個賣點的反例

Strategy

Issue body 已列出 3 個候選方案,diagnose 不預判,留給 Plan tier 的 EnterPlanMode approval gate 讓 user 表態。三案各自的 trade-off:

案	內容	一致性	改動量	風險
A. 維持強制,但明示 + 一致	cluster 一律 PR;--no-pr 撞 cluster 時印 explicit override notice(比照 fork);把 cluster carve-out 補進 pr-flow.md 演算法表第 6.5 行	高(與 fork 處理同 pattern)	最小(3 檔 doc tweak + 1 skill notice line)	低
B. cluster 容許 --no-pr	降級為「1 shared branch + N Refs #N commits,不開 PR」;/idd-verify --branch / --commits 覆蓋 verify	高(尊重既有 direct-commit 契約)	中(idd-implement Phase 5.5 條件 skip + cluster verify path 補)	中(cluster + direct-commit 是新 mode,需要 dogfood)
C. Ask 路徑	cluster + (--no-pr 或 pr_policy:never)→ AskUserQuestion 三選(force PR / proceed direct-commit / abort);非 silent	中(新增 ask gate,但呼應 pr_policy:"ask" 既有 idiom)	中(idd-implement + idd-all + cluster docs 都要加 gate)	中(unattended mode 不能 fire AskUserQuestion → 仍需 default;default 又回到 A/B 之爭)

Strategy items(在 Plan approval 後填入具體方案):

• 選定方案 A / B / C(EnterPlanMode 階段決議)
• 更新 references/pr-flow.md 演算法表(列 cluster carve-out 或刪除 carve-out)
• 更新 references/batch-and-cluster.md line 133 周邊(與 pr-flow.md 對齊)
• 更新 skills/idd-implement/SKILL.md line 49(從 stub 升格為 spec'd 行為)
• 掃 idd-all / idd-diagnose / idd-close 的 cluster/batch mode 段落驗證一致性
• (案 A/B 視情況)補 explicit override notice
• (案 B 視情況)cluster + direct-commit 的 dogfood verification(retroactively against a small cluster)
• Bump version + plugin-update

Complexity

Plan

觸發 Layer P 信號:

• Decision-heavy with 2+ valid approaches — issue body 明列 3 案 A/B/C,選哪個會改寫不同檔案、影響不同 user surface
• Cross-file refactor 影響 ≥ 3 個檔案的一致性 — pr-flow.md / batch-and-cluster.md / idd-implement/SKILL.md 必須同進退,可能擴及 idd-all / idd-close
• Touches risk-sensitive 邊界 — path resolution 是所有 IDD invocation 的入口決策;一致性 bug 會 silent-degrade 使用者體驗

未觸發 Layer 2(這些是內部 skill behavior 文件,非 published API for future external callers),所以不是 Spectra。

Vagueness Pre-check (Step 3.4)

軸	Score	Reasoning
V1 (vague WHAT)	2 (Clear)	Expected 段明列三件具體要交付的事:(1) pr-flow.md 演算法表是 single source;(2) override 印 notice;(3) --no-pr+cluster 行為單一指定。每件都有可驗證形態。
V4 (vague ACCEPTANCE)	2 (Clear)	Actual vs Expected 對照清楚,完成條件 = 三檔對齊 + pr-flow.md 表內含 cluster carve-out + 行為單一文件化 + override 印 notice。可逐項勾選驗收。

• Triggered: no — both axes ≤ 3

V2 (vague HOW) 由 Layer P 覆蓋(本案命中 decision-heavy,routing 到 Plan 已處理)。V3 (vague SCOPE) 由 IC_R011 sister sweep 處理。

Risks

• 選 A 後再發現 default-branch-only 強制理由其實不夠 — 需 follow-up issue 改 B/C
• 選 B 後 cluster + direct-commit 的 verify path 沒實測 — /idd-verify --branch 是否真能取代 PR-level verify 需要 dogfood
• 文件改動可能與正在進行中的其他 skill change 衝突(目前沒看到 in-flight 但需留意)
• 不論選哪案,backward-compat: 既有使用者跑 idd-implement #34 #36 #38 不應被破壞;改動需在 path-resolution 表新增 row,而非改寫 existing rows

Next Step

由於 Complexity = Plan,routing 進 /idd-plan #96(EnterPlanMode approval gate)讓使用者在 A/B/C 之間表態。

注意: /idd-all 在 (PR, unattended) mode 下,Plan tier 的 EnterPlanMode 會被 skip(per skill contract)。本案是 design issue,3 案 trade-off 需 user 判斷 — 將在 Phase 3 surface 此 tension。

[kiki830621]

Implementation Plan

選定方案: A — 維持強制,但明示 + 一致(user 於 idd-all 對話內表態)。

Strategy items

• references/pr-flow.md — 在 "Why fork detection forces PR path" 之後新增 ### Cluster mode override 小節:寫明 cluster mode(idd-implement / idd-verify / idd-close 收到 ≥2 #N)與 fork detection 同 class — pre-empt pr_policy,並印 explicit override notice。Algorithm 表上方加註「適用 single-issue invocation;cluster 與 fork override 見下節」。
• references/batch-and-cluster.md — line 133 cross-references 段:把現有「Cluster-PR mode always uses PR path;never direct-commit (defensive: cluster on direct-commit = stacked half-isolated changes on default branch)」replace 為 pointer:「Cluster mode forces PR path — see pr-flow.md § Cluster mode override for resolution semantics + override notice format.」(理由文不刪、搬到 pr-flow.md 新節作為 rationale)
• skills/idd-implement/SKILL.md — line 49:從 Cluster-PR mode 強制 PR path（不接受 --no-pr） 升格為 spec'd 行為描述:「Cluster-PR mode 強制 PR path。若 invocation 帶 --no-pr 或 pr_policy=never,Phase 0.5 印 explicit override notice(比照 fork detection 既有 pattern)後 proceed as PR mode — 不 abort、不 silent ignore。完整契約見 pr-flow.md § Cluster mode override。」
• Sanity scan: skills/idd-all/SKILL.md / skills/idd-close/SKILL.md / references/usecase-routing.md 確認沒有 inline 重述「cluster forces PR」的散落規則 — 已掃,僅 idd-all 的 chain --in-chain 不衝突(那是 (direct-commit, unattended) chain context,與 cluster --no-pr 是不同 axis)
• (本 PR commit 自然涵蓋 backward compat 驗證) Single-issue invocation 行為不變 — 演算法表上方加註只是說明 cluster 例外位置,resolution rows 沒改

改動範圍

檔案	變動量	性質
plugins/issue-driven-dev/references/pr-flow.md	+20~30 行(新 subsection + algorithm 表上方註)	新增規格
plugins/issue-driven-dev/references/batch-and-cluster.md	line 133 ~1 行改寫	指向新規格
plugins/issue-driven-dev/skills/idd-implement/SKILL.md	line 49 ~2 行	stub → spec

Out of scope(留作 follow-up 若 surface)

• 真正落實 explicit override notice 的 bash 實作 — 文件先 spec,Phase 0.5 的 echo line 看下游 implementation 是否需要 separate ticket(目前 cluster mode 在 PR path 已建 feature branch,加 notice 是補一行 echo,改動 trivial)
• idd-close / idd-verify 是否要對應 cluster + non-PR-existing 情境 — 預設 cluster 已強制 PR,所以 cluster close/verify 都有 PR 存在,no behavior change
• 案 B/C 的 deferred 設計 — 若未來實證 A 不夠用,issue 可重開 / 開 follow-up

Refs

• Diagnosis: #issuecomment-4483898985
• User 於 idd-all 對話表態選 A:「A: 維持強制,但明示 + 一致 (建議)」
• 相關 PR cluster: fix PR-body auto-close trap (#87 #74) #94 cluster work 暴露此衝突 — 本 PR 補上文件契約

[kiki830621]

Implementation Complete

Checklist (synced from TaskList)

• references/pr-flow.md — 加 cluster mode override subsection + algorithm 表上方註 (commit cbe6f5d)
• references/batch-and-cluster.md — line 133 改為指向 pr-flow.md 新節的 pointer (commit cbe6f5d)
• skills/idd-implement/SKILL.md — line 49 stub 升格為 spec'd behavior (commit cbe6f5d)
• Sanity scan idd-all / idd-close / usecase-routing — 已掃,僅 idd-all 的 chain --in-chain 不衝突 (那是 (direct-commit, unattended) chain context,與 cluster --no-pr 不同 axis)
• Backward compat:single-issue 行為不變;cluster carve-out 只在 ≥2 #N 觸發

Legend: - [x] done · - [~] skipped (may revisit) · - [-] won't fix (scope)
idd-close will refuse to close if any - [ ] remains in this checklist.

Changes

• cbe6f5d — refactor: document cluster mode override in pr-flow canonical table (Refs cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #96)

Files Changed

 plugins/issue-driven-dev/references/batch-and-cluster.md |  2 +-
 plugins/issue-driven-dev/references/pr-flow.md           | 22 +++++++++++++++++++++-
 plugins/issue-driven-dev/skills/idd-implement/SKILL.md   |  2 +-
 3 files changed, 23 insertions(+), 3 deletions(-)

Verification preview

• bash -n on edited region — N/A (markdown only)
• pr-flow.md 新 subsection 內部 anchor #cluster-mode-override 可被 batch-and-cluster.md + idd-implement SKILL.md 兩個 cross-reference 解析
• Single-issue invocation 走的 resolution algorithm 表 rows 1-7 沒改 — backward compat 自然成立
• Cluster override notice format (→ cluster mode (N issues) → PR path enforced (overriding --no-pr / pr_policy=never)) 是文件 spec;Phase 0.5 實作落實留作下游 follow-up(若必要)

Scope Compliance

無超出 scope 的改動。3 個檔案的修改全部對應 #96 issue body 的 3 個衝突點(canonical table 缺 carve-out / silent override / 行為未定義)。

Sister Bugs / Sweep

掃 session log + reproduction trace 結果:

• (none — 所有相關文件對齊,沒 surface 新 sister bug)
• Out-of-scope candidates 留在 Implementation Plan 已列:override notice 的 bash 實作驗證(若 cluster Phase 0.5 真有需要加 echo line)、案 B/C 的 deferred 設計

Next: verification pending

[kiki830621]

Closing Summary

Problem

IDD 的 PR-vs-direct-commit path resolution 有兩條互斥決策在 cluster 情境下衝突,且衝突解法未文件化、行為未定義:

• pr-flow.md 的 path-resolution 演算法表(canonical source of truth)宣告 --no-pr / pr_policy:"never" 無條件生效。
• idd-implement/SKILL.md:49 + batch-and-cluster.md:133 各自獨立宣告 cluster-PR mode 強制 PR、「不接受 --no-pr」。

三個檔案互相矛盾。照 pr-flow.md 讀的人會認定 --no-pr 永遠生效;而「不接受」具體意指 abort / warn / silent ignore 也從未指定。由 PR #94(auto-close-trap cluster)的工作過程浮現。

Root Cause

pr-flow.md 是 path resolution 的 canonical 演算法檔,但 cluster 例外從未被納入它的演算法表 — 例外散落在兩個下游檔案。三層缺陷:

1. 文件矛盾 — canonical table 缺 cluster carve-out,下游檔案各自補規則。
2. Silent override — fork detection 強制 PR 時印 notice(pr-flow.md:44),cluster 強制 PR 沒有對等 notice,flag 被無聲吃掉。
3. 行為未定義 — 「不接受 --no-pr」是 stub,不是 spec。

此外,診斷發現「cluster 強制 PR」的理由(batch-and-cluster.md:「cluster on direct-commit = stacked half-isolated changes on default branch」)只在使用者起手是 default branch 時完全成立 — 部分被誇大。

Solution

方案 A(diagnose 列出 3 案 A/B/C,使用者於 /idd-all 對話選 A):維持強制 PR,但明示 + 一致。

跨 3 個檔案 + 3 commits(squash b7f72ff):

• references/pr-flow.md — 新增 ### Cluster mode override subsection。Cluster mode 是 idd-implement 的 path-resolution precondition(pre-empts 演算法表);明確標示 idd-verify / idd-close 是 cluster-aware 但 consume the path、不 resolve it。Override notice 格式 mirror fork detection;fork + cluster 共存時兩個 notice 都印。演算法表上方加 cluster preface。
• references/batch-and-cluster.md — line 133 規則陳述降為指向 pr-flow.md 新節的 pointer;rationale 文(「stacked half-isolated changes on default branch」)整段內聯進 pr-flow.md 新節作 source of truth。
• skills/idd-implement/SKILL.md — line 49 stub 升格為 spec'd behavior;Step 0.5 bash 實作 cluster detection:parse #N token count → CLUSTER_MODE → pre-empt block → --no-pr/pr_policy=never 撞 cluster 時印 → cluster mode (N issues) → PR path enforced (overriding ...) 後 proceed PR。Step 0.5 local algorithm summary 加 row 0。

Backward compat:single-issue invocation(idd-implement #19)行為不變 — cluster carve-out 只在 ≥2 #N 觸發。

Verification

/idd-verify --pr 99 — 6-AI ensemble(Requirements / Logic / Security / Regression / Devil's Advocate / Codex)× 2 rounds:

• R1(cbe6f5d, doc-only)— 6/6 CONDITIONAL PASS。5/6 聚同一 HIGH:spec 寫了 Phase 0.5 override notice 但 bash 沒 cluster detection — silent override 症狀仍存。
• R2(5351116)— 使用者選擇延伸 scope 補 ~24 行 bash impl(8-case behavioral dry-run 全過;bash -n clean)。6/6 PASS,R1 HIGH + 4 MED 全閉,Devil's Advocate 撤回最強反對、改推 MERGE。
• R3(04c51cb)— 補 Devil's Advocate 唯一 actionable 新 finding(Objection 4):原文宣稱 cluster mode 對 idd-verify/idd-close 「pre-empts Resolution algorithm」是 self-contradicting over-claim — 那兩個 skill 不做 path resolution。1 句 doc 釐清,DA 自己指定的修法。

Step 0.8 auto-close-trap scan(PR body + 每個 commit headline/body):clean。Squash commit b7f72ff 用 Refs #96,#96 未被 auto-closed — 由 /idd-close 正常結案。

Master verify reports:

• R1: cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #99 (comment)
• R2: cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #99 (comment)

Changes

PR #99(squash-merged as b7f72ff on main):

• cbe6f5d — refactor: document cluster mode override in pr-flow canonical table (Refs cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #96) — R1 doc-only
• 5351116 — fix(idd-implement): wire cluster detection + override notice in Step 0.5 bash (Refs cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #96) — R2 bash impl
• 04c51cb — docs(pr-flow): scope cluster path-resolution pre-emption to idd-implement only (Refs cluster-PR mode 強制 PR 與 direct-commit path 衝突：override 未文件化且 --no-pr 行為未定義 #96) — R3 doc fix

3 files / +49 / -8:

• plugins/issue-driven-dev/references/pr-flow.md — 新 § Cluster mode override
• plugins/issue-driven-dev/references/batch-and-cluster.md — line 133 → pointer
• plugins/issue-driven-dev/skills/idd-implement/SKILL.md — line 49 spec + Step 0.5 bash cluster detection

Closing Follow-ups Filed

#100 — 收 verify 流程中 2 個 non-blocking deferred 項:

• Devil's Advocate Objection 2:Option A 在 non-default feature branch 上仍強制 PR,而該情境 cluster direct-commit 是合法工作流 — Option B revisit 候選。
• Logic + Codex LOW:idd-implement Step 0.5 cluster-detection glob \#[0-9]* 過鬆(#42abc / 重複 #34 #34 誤計),與 batch-and-cluster.md 的 ^#\d+$ 不一致。

Distribution Sync

• Detected: plugin (issue-driven-dev — marketplace member of PsychQuant/issue-driven-development)
• Choice: chain to /plugin-tools:plugin-update issue-driven-dev now
• Outcome: bumped v2.61.0 → v2.62.0 (plugin.json + marketplace.json + CHANGELOG, commit d7a2fd0); README Version History backfilled v2.56.0–v2.62.0 (commit c37692f); claude plugin marketplace update + claude plugin update → installed plugin now v2.62.0 (restart Claude Code to apply)
• At: 2026-05-19T04:14:00Z