Path Map

IDD Path Map

36 條 sanctioned path 的選擇導航圖 — maintainer 日常查詢用（#276）。 Single source：docs/workflows.md（§ Path Flowchart + § Path Catalog）； 本頁由 scripts/generate-path-map.py 生成，請勿直接編輯 — 改 workflows.md 後重跑 generator。

flowchart TD
    START(["你正要做什麼？"]) --> Q1{"single issue<br/>還是 multi？"}

    Q1 -->|single| QM{"type=meeting？"}
    QM -->|yes| A5["P-meeting<br/>（複雜度評估前分流）"]
    QM -->|no| Q2{"Complexity？<br/>（硬閘：≥5 檔互依概念或<br/>shared abstraction → MUST Plan）"}
    Q2 -->|Simple| Q3{"attended？<br/>（你在 keyboard）"}
    Q3 -->|yes| A1["P-atomic（5 touchpoints）"]
    Q3 -->|no| QD{"已有 diagnosis？"}
    QD -->|yes| B1["P-auto-from-diagnosed"]
    QD -->|no| B2["P-auto-full-swallow"]
    Q2 -->|Plan| A2["P-plan-gated<br/>（EnterPlanMode 審批）"]
    Q2 -->|Spectra| Q4{"方向已明確？<br/>（零 open questions）"}
    Q4 -->|yes（罕用）| A4["P-spectra-opt-out"]
    Q4 -->|no（預設）| A3["P-spectra-discuss-first"]

    Q1 -->|multi| Q5{"issues 之間的關係？"}
    Q5 -->|同根 cluster| B4["P-batch-diagnose → P-cluster-pr"]
    Q5 -->|ripple：1 root + auto-emerge| B5["P-chain-from-root"]
    Q5 -->|forest：N roots 獨立| B6["P-chain-multi-root<br/>（或 N × P-atomic）"]
    Q5 -->|unrelated backlog drain| B3["P-batch-drain<br/>（conflict-class ordered）"]
    Q5 -->|source-driven（一份來源 ≥2 findings）| D1["P-multi-finding<br/>（強制單線 → P-no-multi-finding）"]

    subgraph C["C. Batch（N issues 各自 atomic，無共用 PR）"]
        C2["P-batch-comment"]
        C3["P-batch-update"]
        C4["P-batch-edit"]
        C5["P-batch-close"]
    end

    subgraph E["E. Verify-only / PR review"]
        E1["P-pr-verify"]
        E2["P-verify-file-profile（非 code deliverable）"]
        E3["P-pr-verify-then-merge"]
    end

    subgraph F["F. Resume / 中斷恢復"]
        F1["P-spectra-resume"]
        F2["P-implement-retry"]
    end

    subgraph G["G. Non-lifecycle / ancillary"]
        G1["P-list-triage"]
        G2["P-route-recommend"]
        G3["P-comment-only"]
        G4["P-edit-only"]
        G5["P-discussions-intake"]
        G6["P-clarify-audit"]
        G7["P-find-lookup"]
        G8["P-ask-history"]
        G9["P-report-rollup"]
        G10["P-config-maintain"]
    end

    subgraph H["H. Autopilot（no human-in-loop）"]
        H1["P-loop-autopilot"]
        H2["P-cron-autopilot"]
        H3["P-cron-list-triage"]
    end

Loading

Path 一覽（依類別）

A. Single-issue lifecycle paths(typical bug / feature flow)

Path	說明
P-atomic	Simple complexity baseline
P-plan-gated	Plan tier with EnterPlanMode approval
P-spectra-discuss-first	Spectra tier with alignment
P-spectra-opt-out	Spectra with direction pre-confirmed(罕用
P-meeting	meeting-type deliberation（#57，v2.93+

B. Convenience-orchestrator paths(快速 lifecycle 完成)

Path	說明
P-auto-from-diagnosed	diagnose 已過,跑自動化
P-auto-full-swallow	legacy idd-all 一次跑完
P-batch-drain	multi-issue conflict-class-ordered sequential（v2.83+，#182
P-cluster-pr	N issues 共 1 PR
P-chain-from-root	1 root + auto-emergent spawn
P-chain-multi-root	多 root forest chain

C. Batch paths(N issues 各自 atomic)

Path	說明
P-batch-diagnose	- Use case:同 doc 來源 N issues,各自 diagnose 各 user-reviewable
P-batch-comment	- Use case:批次加同一段 note(e.g.「blocked by upstream」)到多 issue
P-batch-update	- Use case:批次同步 Current Status phase
P-batch-edit	- Use case:批次套同一段 edit 到多 issue 既存 comment
P-batch-close	- Use case:cluster PR merge 後批次 close,每個 issue 仍各自獨立 closing summary

D. Multi-finding dispatch paths(source-driven mixed routing)

Path	說明
P-multi-finding	auto-triggered
P-no-multi-finding	force single-issue

E. Verify-only / PR-review paths(external agent integration)

Path	說明
P-pr-verify	- Use case:外部 agent(Codex / Copilot)開的 PR,IDD 6-AI ensemble verify
P-verify-file-profile	非 code deliverable 驗證（#258，v2.97+
P-pr-verify-then-merge	- Use case:verify-gated PASS 後 user 主動 merge,per IDD MANIFESTO「auto-merge 須走 #3…

F. Resume / continuation paths(mid-work recovery)

Path	說明
P-spectra-resume	- Use case:Spectra change 中途 requirements 變更,重新對齊 spec 後繼續
P-implement-retry	- Use case:Chain mode 某 issue verify FAIL,retry on cluster branch(避免另開新 branch)

G. Non-lifecycle / ancillary paths(maintenance + observation)

Path	說明
P-list-triage	- Use case:開工前 triage,看哪些 open issue,各自 phase 為何
P-route-recommend	- Use case:選 agent(Codex / Claude / etc.)
P-comment-only	非 lifecycle 推進
P-edit-only	- Use case:編輯既存 comment(append / replace / prepend-note)
P-discussions-intake	Discussions 盲點橋接（#221，v2.95+
P-clarify-audit	terminology / semantic surfacing（#135，v2.72+
P-find-lookup	語意查找（#139，v2.97+
P-ask-history	issue 知識庫問答（#72，v2.99+
P-report-rollup	跨 issue 人類 triage 視圖（#134，v2.97+
P-config-maintain	config 生命週期（v2.31+

H. Unsupervised / autopilot paths(no human-in-loop)

Path	說明
P-loop-autopilot	- Use case:autonomous 持續執行;適合 well-bounded simple issues
P-cron-autopilot	- Use case:cron-scheduled ETL / housekeeping
P-cron-list-triage	- Use case:每週一 9am 印出 open issue triage report

---

細節（touchpoints、mode、assumptions、risk）與 § Anti-patterns 見 docs/workflows.md。