Adopt superpowers-style pre-implementation staging; reference superpowers in README

[kiki830621]

Problem

Original text (user verbatim):
「看起來idd也需要納入這種方式，才能加速，可以知後請idd參考superpower。燃後idd的README.md需要把參考superpower寫進去」
— Source: pasted-text in Claude Code session (2026-05-20)

Plain-language interpretation：superpowers plugin 提供「brainstorming → writing-plans → executing-plans / subagent-driven-development」三段式 skill 流程。在實際使用中發現這個分段對「定義意圖 → 設計 → 規劃 → 執行」有顯著加速效果（design 在 brainstorming 取得 user approval 才 commit；writing-plans 再產出 task-level breakdown）。

IDD 目前的 skill 流（idd-issue → idd-diagnose → idd-implement → idd-verify → idd-close）偏向「實作後追蹤」型，缺少「實作前釐清意圖與設計」的標準化階段。

Type

feature + docs

Expected

兩個 deliverable：

1. Pre-implementation staging skill / phase：評估在 idd-issue 與 idd-diagnose 之間（或擴展既有 idd-plan），引入對齊 superpowers 三段式的階段：

   • idd-brainstorm（or rename of existing idd-plan）—— 對齊 superpowers:brainstorming，design-first dialog protocol、產出 design spec 並 user-approve 各段
   • idd-write-plan —— 對齊 superpowers:writing-plans，把 spec 拆成 bite-sized tasks，含 TDD discipline、frequent commits
   • idd-implement（已存在）—— 對齊 superpowers:executing-plans / subagent-driven-development

2. README.md 更新：明確 reference superpowers plugin、致敬其設計理念。建議在 README 內加一個對照表：

   IDD phase	superpowers skill	用途
   idd-issue	—	定義 issue
   (new) idd-brainstorm	brainstorming	design-first dialog
   (new) idd-write-plan	writing-plans	task decomposition
   idd-implement	executing-plans / subagent-driven-development	執行 plan
   idd-verify	—	IDD 獨有：6-AI ensemble verify
   idd-close	—	IDD 獨有：closing summary + audit trail

Actual

目前 /idd-issue 後直接導向 /idd-diagnose → /idd-implement，沒有強制「先確認設計／意圖」的階段。實務上 user 必須自己跳到 superpowers 跑 brainstorming + writing-plans，然後再回 IDD 走 implement / verify / close。兩個 plugin 之間沒有 cross-reference 或 hand-off pattern，新使用者不知道可以串接。

idd-plan 雖然有 plan-mode 實作，但 scope 較窄（介於 Simple 與 Spectra 之間的中間層），未對標 superpowers 的「設計 + 規劃」雙段。

Impact

• 缺少 pre-implementation stage → user 容易直接從 issue 跳到 implement，未在 design 階段被「先問清楚需求」這類流程強制 confirm
• README 沒提 superpowers → 新使用者不知道兩個 plugin 可以串接使用，可能各自孤立用
• 跨 plugin 流程缺乏明確 documentation → 串接靠經驗，難以 onboard

References

superpowers plugin（用作 reference）：

• superpowers:brainstorming：design-first dialog protocol，HARD-GATE 要求 design approval 才能進實作
• superpowers:writing-plans：bite-sized task decomposition（2-5 min per step），含 TDD discipline、frequent commits、no placeholders 原則
• superpowers:executing-plans / superpowers:subagent-driven-development：兩種執行方式（inline batch / 每 task 派 fresh subagent）

實際使用情境（2026-05-20，建立此 issue 同 session）：在規劃 che-transport-mcp 專案時走完整 superpowers 流程，brainstorming 階段透過 5 個 design sections 逐段 confirm，writing-plans 產出 18 個 bite-sized tasks 的 implementation plan，整體比直接跳 idd-implement 結構化許多。

Suggested next steps

1. Diagnose 階段討論：

   • (a) 用新 skill（idd-brainstorm / idd-write-plan）還是擴展既有 idd-plan
   • (b) skill 命名與職責切分
   • (c) 與 superpowers 的 hand-off / cross-link pattern（一鍵 fork 過去 vs 內建對等 skill）

2. README 更新：

   • 加上 superpowers reference 段落
   • 列 IDD vs superpowers 的階段對照表
   • 標註 IDD 獨有功能（verify ensemble、close audit trail）

3. Optional UX hint：在 idd-issue Step 5 / Step 0 Bootstrap 加 hint：「若 issue 屬於 design-heavy 類型，建議先過 brainstorming 階段」

Acknowledgement

This proposal explicitly references and credits superpowers plugin（or wherever its canonical home is — to be confirmed in diagnose phase）for the staging pattern. IDD adopting similar structure is intended as recognition of the design's effectiveness, not displacement.

---

Current Status

Phase: closed
Last updated: 2026-07-08 by /idd-close (cluster close #129 #57 #111)

Key Decisions

• 執行側 + README 引用已由 確立「深度整合 >> hard-coded」rule（.claude/rules）並以 superpowers plugin 為首個深度整合對象 #209 吸收；殘餘 = design 側 staging（idd-brainstorm / idd-write-plan）的工作流形狀決策
• Complexity = Spectra → 移入 batch discussion list，等使用者對齊後走 /spectra-discuss
• Blocked on: 使用者決策（新 skill vs 擴展 idd-plan vs 維持手動串接）

[kiki830621]

Diagnosis

Type

feature + docs（filed 2026-05-20；本 diagnosis 以 post-#209 landscape 重新評估）

Root Cause / Analysis

#209（superpowers hard dependency, v2.90.0, 2026-07-04）已吸收本 issue 的執行側與大部分 docs 側：

#111 原始 deliverable	post-#209 現況
D1 執行側對齊（idd-implement ↔ executing-plans/TDD）	✅ 已由 #209 delegation 落地（TDD、verification-before-completion、systematic-debugging 皆 canonical delegate + fail-fast）
D1 design 側 staging（idd-brainstorm ↔ brainstorming、idd-write-plan ↔ writing-plans）	❌ 未做 — IDD 仍無「issue 之後、diagnose/implement 之前」的標準化 design-first 階段（idd-plan scope 較窄且位於 diagnose 之後）
D2 README 引用 superpowers	✅ 大致由 #209 補齊（hard-dependency 表、依賴節、delegation 表共 3 處）；殘餘的「IDD phase ↔ superpowers skill 對照表」因 design 側新 skill 未定案而無法完整撰寫

殘餘 scope = design 側 staging 的工作流重設計：要不要新增 idd-brainstorm / idd-write-plan skill（或擴展 idd-plan）、放在 pipeline 哪個位置、與 Layer V/complexity routing 如何互動 — 這是 IDD 核心工作流的形狀決策。

Impact

• 新 skill surface（若做）：plugin 對外 skill 介面 + pipeline 文件 + routing 規則多處
• README 對照表（D2 殘餘）依 D1 決策而定

Strategy

（不在 unattended batch 內實作 — 見 Complexity）

• User 對齊 design 側 staging 的形狀（新 skill vs 擴展 idd-plan vs 維持現狀引用 superpowers 手動串接）
• 決策後走 /spectra-discuss → propose → apply
• README 對照表隨 D1 定案補完

✅ Strategy 完成（2026-07-08）：以上項目均於 change reshape-plan-preimpl-tier（PR #249，rebase-merged 至 main 2f5a700）落地。細節見下方 Closing Summary。

Conflict Class

D_diagnose_first → 經本 diagnosis 重評為「需 user 對齊的 Spectra」；實作階段觸及 pipeline 文件多處（屆時再評 B/C）。

Complexity

Spectra

Layer 2 命中：新增 plugin skill surface（idd-brainstorm / idd-write-plan）給 future callers，行為契約需成文。Layer 3 命中：architectural decision（IDD pipeline 階段構成）+ 影響多份既有 spec/文件一致性。
Unattended batch 處置：Spectra + 工作流形狀決策 = 使用者商討項 — 本 issue 移入 batch 的 discussion list，不做 unattended 一輪收斂（避免 AI 單方重設計核心工作流）。

Risks

• 與 idd-plan/idd-clarify/Layer V 的職責重疊若未先對齊，會產生第四條相互競合的 pre-implementation 路徑

Residue

使用者原話的「加速」意圖（superpowers 分段帶來的 velocity）部分已由 #209 的執行側 delegation 實現 — D1 殘餘部分的 acceleration 效益尚無量化基準（連結 #131 的 cognitive-load metric 議程）。

Vagueness Pre-check

• V1: 2 — 兩個 deliverable 明確，但 D1 的三種實作形狀（新 skill / rename / 擴展）留待對齊
• V4: 3 — 「對齊 superpowers 三段式」的完成邊界依 D1 形狀而定
• Triggered: no

[Layer V: V1=2 V4=3, not triggered; unattended mode]

Sister Concerns Filed (mid-diagnose, v2.47.0+ #528)

(none — D2 殘餘（對照表）依附 D1，不獨立成案)

---

Source: /idd-all batch drain (unattended), 2026-07-06 — 本 issue 依 Spectra 判定移入 discussion list，等待使用者對齊

[kiki830621]

決策：委派 superpowers + 加 hand-off 文件（不自建對等 staging skill）。

規則裁決：#209 已把 superpowers 設為 install-time hard dependency，superpowers:brainstorming / writing-plans 對每個 IDD 使用者保證存在。依 deep-integration-over-hardcode 反複製判準，自建 idd-brainstorm / idd-write-plan 等於 vendored fork（兩處維護、靜默漂移），明文禁止。diagnosis 也已記「執行側 + README 引用由 #209 吸收，殘餘 = design 側 staging 形狀決策」—— 此決策把殘餘收斂為「委派」。

選定方向（純 docs / pointer，三個 requirement 裡最輕的一塊）：

• README 加 IDD ↔ superpowers 階段對照表（idd-issue / brainstorming / writing-plans / idd-implement / idd-verify / idd-close），標明 verify ensemble + close audit trail 為 IDD 獨有
• hand-off 文件：design-heavy issue 在 idd-issue Step 5 / idd-diagnose 加 hint 指向 superpowers:brainstorming
• 不新增 idd-brainstorm / idd-write-plan skill

下一步：與 #129、#57 綁成一個 Spectra（Plan / pre-implementation tier 形狀）。此 issue 是三者裡最輕的 requirement（無 code、無 taxonomy 改動），可在 Spectra 內先落地。

Cluster C 處置（20-issue consolidation triage；deep-integration-over-hardcode 為裁決依據）。使用者裁決 2026-07-07。

[kiki830621]

Closing Summary

Problem

IDD 缺少「issue 之後、implement 之前」的標準化 design-first 階段；與 superpowers plugin（brainstorming → writing-plans → executing-plans 三段式）之間無 cross-reference / hand-off pattern，新使用者不知可串接。README 亦未提及 superpowers。

Root Cause

#209（superpowers install-time hard dependency, v2.90.0）已吸收本 issue 的執行側（TDD / verification / systematic-debugging 皆 canonical delegate）與大部分 docs 側。殘餘 = design 側 staging 的工作流形狀決策：要不要自建 idd-brainstorm / idd-write-plan。

Solution

委派 superpowers + 加 hand-off 文件，不自建對等 staging skill（使用者裁決 2026-07-07，依據 deep-integration-over-hardcode 反複製判準——#209 已保證 superpowers:brainstorming / writing-plans 對每個 IDD 使用者存在，自建等於 vendored fork、兩處維護、靜默漂移）：

• README 加 IDD ↔ superpowers stage-mapping 對照表（idd-issue / brainstorming / writing-plans / idd-implement / idd-verify / idd-close），標明 verify ensemble + close audit trail 為 IDD 獨有。
• idd-issue Step 5 加非綁定 brainstorming pointer（design-heavy issue 印一行 → 若要先 brainstorm 對齊方向: superpowers:brainstorming；不 auto-invoke）。
• 不新增 idd-brainstorm / idd-write-plan skill。

三者裡最輕的 requirement（無 code、無 taxonomy 改動），在 Spectra 內與 #129/#57 一起落地。

Verification

• 專屬 drift-guard superpowers-staging/test.sh：12/12 assertions PASS（含「pointer ≠ delegation」不變式）。
• Adopt superpowers-style pre-implementation staging; reference superpowers in README #111 在 5 輪 ensemble 的 round 1 後即乾淨。
• spectra validate + analyze clean。

Residue Acknowledgement

Diagnose 時的 residue（使用者「加速」意圖的 acceleration 效益尚無量化基準）仍為 open residue，已由 #131（cognitive-load metric 議程）追蹤——本次改動落地 hand-off 形狀，但不涵蓋效益量化，維持在 #131。不另開 follow-up。

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 對應片段：README.md（stage-mapping 表 + pointer≠delegation 註）、skills/idd-issue/SKILL.md（Step 5 非綁定 pointer）、specs/superpowers-integration/spec.md、scripts/tests/superpowers-staging/test.sh