[enhancement] Plan tier triggering criteria 太寬鬆 — 大範圍改動應 MUST-trigger Plan

[kiki830621]

Problem

Original feedback(user 2026-05-21,#44/#47 close 後反思):
「我覺得在 idd 裡面評斷要不要 plan 的標準太寬鬆了，如果大範圍的改動應該一定要啟動 plan」

現行 rules/sdd-integration.md Layer P 觸發 Plan tier 之條件為 disjunctive any-match(任一命中即觸發,但 default 仍是 Simple):

• 2+ files have sequential dependency
• 5+ ordered steps in strategy
• Decision-heavy with 2+ valid approaches
• Risk-sensitive boundary
• Cross-file refactor without external contract change

User 提出問題:這些是「may trigger」criteria,沒有 hard MUST-trigger 防護;對於「大範圍改動」缺少強制升級到 Plan 的機制。

Type

enhancement(governance / Layer P 觸發判準調整)

Expected

引入 MUST-trigger layer 於 Layer P 之外或之上,讓「大範圍改動」一定走 Plan tier。可能的判準向度(plugin 維護者自行 calibrate):

1. File-count threshold:預計修改 ≥ N 個檔案(N 可能 3、4、5,需 calibration)
2. Structural / shared abstraction modifications:涉及共享資料結構、測量模型、helper interfaces、constants 等被多 caller 使用之 entity
3. Cross-domain artifact dependency:改動 cascade 至多種 artifact 類型(e.g. R script + LaTeX + 表格 + 文檔)
4. Family-scope changes:同類量表 / 同類組件之 family-wide 改動(本 session 例子:CR + PTSR + PCQ 三量表 LMI 修正皆屬同 family,但 feature: /idd-all chain-solve mode — 自動接續解 spawned issues + 單 review PR #44 只 plan 到 CR)

「Default Simple, escalate to Plan if Layer P fires」可能應改為「Default Plan if scope ≥ threshold, downgrade to Simple only if Layer 1 disqualifiers fire」之 inversion。

Actual — 來自 kiki830621/teaching-yun-2026 #44/#47 之 session evidence

#44 範例(2026-05-21):

• Diagnosed as Plan tier(Layer P 觸發:多檔案順序依賴 + decision-heavy + risk-sensitive),走完整 plan-mode approval gate
• 但 mid-implementation 出現 conceptual error(single-factor LMI 設計實質為 second-order factor disguise)— EnterPlanMode approval 沒抓到
• User mid-thread correction「LMI 因素結構要和 §4.2.1 CFA 完全一樣」觸發 in-thread scope expansion
• Plan scope 原本只談 CR,但實際擴及 CR + PTSR LMI(out-of-feature: /idd-all chain-solve mode — 自動接續解 spawned issues + 單 review PR #44-scope but consistency-driven)

#47 follow-up 必要性:

• feature: /idd-all chain-solve mode — 自動接續解 spawned issues + 單 review PR #44 close 後 user 才發現 PCQ 也有同樣 single-factor LMI bug
• 同一 conceptual issue(LMI 結構與 §4.2.1 CFA 對齊原則)分散於三量表,Plan tier 沒一次 catch 完
• Process gap acknowledgement:feature: /idd-all chain-solve mode — 自動接續解 spawned issues + 單 review PR #44 mid-thread 原則應同時套用到 PCQ,但當時 AI 窄化解讀漏掉

Pattern observation:#44 是「Plan 觸發了但 plan 本身 scope 不夠廣」的案例。User 提的「大範圍改動 MUST plan」可進一步要求 Plan tier scope 必須涵蓋 family-wide impact,不只當前 file 之最小修改。

Impact

• rules/sdd-integration.md Layer P 評估邏輯
• idd-diagnose Step 3.5 Complexity Assessment 之 routing decision
• idd-plan Step 2 Implementation Plan 起草指引(可能需強制納入 family-wide scope check)
• 不影響既有 Simple / Spectra tier 邊界

Priority

P2(process improvement;non-blocking 但 missing-Plan 的代價高 — per session evidence,#44 + #47 共需兩次 close 才完整覆蓋,若 #44 plan 一次到位可節省 ~30 分鐘 re-work)

Reference

• Triggering session: kiki830621/teaching-yun-2026 feature: /idd-all chain-solve mode — 自動接續解 spawned issues + 單 review PR #44(CR LMI rewrite,close 2026-05-21)+ feature: /idd-all-chain Phase 0 pre-flight check for root issue diagnosis-readiness #47(PCQ LMI follow-up,filed/closed 2026-05-21 同日)
• 相關 rule:rules/sdd-integration.md Layer P / Layer 1 disqualifiers / Layer V vagueness pre-check
• 相關 skill:idd-diagnose Step 3.5、idd-plan Step 2

Next

/idd-diagnose #N 探討具體 calibration:

• File-count threshold 落在 N=?
• 「Structural modification」如何 mechanically detectable(grep helper 修改、shared header import 等)?
• Default flip(Simple → Plan)是否有 over-trigger 風險?Layer 1 disqualifiers 是否足夠 cover「真的 simple」的情境?

[kiki830621]

決策：加 MUST-trigger 硬閘（保留現行 disjunctive any-match，之上疊一層硬性升級）。

現行 Layer P 是 any-match「may trigger」、default 仍 Simple。#44 / #47 實證顯示缺 hard MUST-trigger 會漏掉大改動（同一 LMI conceptual issue 分散三量表，Plan 沒一次 catch 完，兩次 close 才覆蓋完整）。

選定方向：不反轉預設（避免 over-trigger 把小改也拖進 plan-mode approval gate），而是在 any-match 之上疊一層硬閘 —— 改動 ≥ N 檔 / 動到 shared abstraction（被多 caller 使用的 data structure、helper interface、constants）一定強制走 Plan tier；其餘情況 default 仍 Simple。

留到 Spectra calibrate 的參數（此裁決不定）：

• 檔數門檻 N（3 / 4 / 5，需 over-trigger 風險評估）
• 「structural modification」如何 mechanically detectable（grep helper 修改 / shared header import 等）
• Plan scope 是否強制涵蓋 family-wide impact（feature: /idd-all chain-solve mode — 自動接續解 spawned issues + 單 review PR #44 的 CR + PTSR + PCQ 同 family 一次覆蓋，不只當前 file 最小修改）

與 #57 的耦合：#129 的 MUST-trigger 硬閘與 #57 的 meeting-type 分支同碰 idd-diagnose Step 3.5 routing，必須在同一 Spectra 內一起設計，避免雙重/衝突判準。

下一步：與 #57、#111 綁成一個 Spectra（Plan / pre-implementation tier 形狀），走 /spectra-propose。

Cluster C 處置（20-issue consolidation triage）。使用者裁決 2026-07-07。

[kiki830621]

Closing Summary

Problem

rules/sdd-integration.md Layer P 觸發 Plan tier 為 disjunctive any-match（任一命中即 may-trigger，default 仍 Simple），對「大範圍改動」缺少強制升級的硬性防護。實證來自 kiki830621/teaching-yun-2026 #44/#47：同一 LMI conceptual issue 分散於 CR + PTSR + PCQ 三量表，Plan tier 沒一次 catch 完，需兩次 close 才覆蓋完整。

Root Cause

routing 只有「may trigger」的軟性判準、沒有「MUST trigger」的地板。「Default Simple, escalate if Layer P fires」讓大範圍改動仍可能被路由到 Simple。

Solution

在 Layer P 之上疊一層 MUST-trigger 硬閘（使用者裁決 2026-07-07）：改動觸及一個互依概念的 ≥5 個檔案 OR 一個 shared abstraction（被多 caller 使用的 data structure / helper interface / constants）→ 強制升級 Plan tier。

• Escalate-only：硬閘只升不降；不反轉預設（避免把小改也拖進 plan-mode approval gate → over-trigger）。Simple default 完整保留。
• 落地於 idd-diagnose Step 3.5 的 canonical 7-step meeting-first routing（硬閘序在 Layer P 之前、meeting/Layer 1/Layer V/Spectra 之後）、rules/sdd-integration.md 的 ordered list + truth table（新增 Hard-gate 欄）。
• 判準措辭刻意用「互依概念的 ≥5 檔」而非裸檔數，避免把 N 個不相關單檔改動誤判為大範圍。

Verification

• 專屬 drift-guard complexity-hard-gate/test.sh：44/44 assertions PASS（鎖機制而非字串）。
• 併入 reshape-plan-preimpl-tier Spectra change，經 5 輪 6-AI adversarial ensemble 驗證；[enhancement] Plan tier triggering criteria 太寬鬆 — 大範圍改動應 MUST-trigger Plan #129 在 round 1 後即乾淨（所有 recurring findings 集中在 [enhancement] /idd-plan native support for meeting-issue type — Plan tier currently assumes chain to /idd-implement TDD loop #57 的 meeting gate）。
• spectra validate + analyze clean。

Changes

• 2f5a700 feat: reshape Plan / pre-implementation tier (Cluster C) — via PR feat: reshape Plan / pre-implementation tier (Cluster C) #249（rebase-merged 至 main 2026-07-07）
  • 本 issue 對應片段：rules/sdd-integration.md（ordered list + truth table 硬閘欄）、skills/idd-diagnose/SKILL.md（Step 3.5 硬閘序）、openspec/changes/reshape-plan-preimpl-tier/specs/complexity-hard-gate/spec.md、scripts/tests/complexity-hard-gate/test.sh