product-playbook 1.0.0

package/references/rules-build.md

@@ -0,0 +1,152 @@
+# ⚡ 直接實作模式步驟序列（共 7 步 + 最終產出）
+
+> 此檔案為直接實作模式的權威步驟定義。由 SKILL.md 核心派發載入。
+
+> ⚠️ 必須提醒：「跳過用戶研究階段，代表解法建立在假設上。建議執行後盡快進行 Continuous Discovery 驗證。」
+
+## 步驟序列
+
+```
+S1. 確認問題陳述（一句話）
+S2. PR-FAQ → 讀取 references/04a-prfaq.md
+S3. 平行解法 → 讀取 references/04b-solutions.md → 3.2
+S4. Pre-mortem → 讀取 references/04b-solutions.md → 3.3
+S5. GEM + RICE 優先排序 → 讀取 references/04b-solutions.md → 3.4 + 3.5
+S6. MVP + Not Doing List → 讀取 references/04c-mvp.md
+S7. North Star + Aha Moment → 讀取 references/05a-northstar-aha.md
+────
+最終產出 → 工程師導向執行摘要
+```
+
+## Reference 載入指示
+
+| 步驟 | Reference 檔案 |
+|------|---------------|
+| S1 | 無需外部 reference（直接引導使用者陳述問題） |
+| S2 | `references/04a-prfaq.md` |
+| S3-S5 | `references/04b-solutions.md` |
+| S6 | `references/04c-mvp.md` |
+| S7 | `references/05a-northstar-aha.md` |
+
+## 最終產出格式
+
+**工程師導向的執行摘要**：解法決策 → MVP 邊界 → 成功指標 → 主要風險
+
+完成後，依 `references/rules-end-of-flow.md` 執行流程結束規則。
+
+---
+
+## 🔧 功能擴充快速路徑（4 步）
+
+> 當偵測到使用者是在**既有產品上新增單一功能**時，自動切換到此路徑。
+> 觸發條件：使用者描述中包含「加一個功能」「新增功能」「加入 XX 功能」「在現有系統上」「既有產品要加」等語句。
+
+**與完整直接實作模式（7 步）的差異**：既有產品已有 North Star、Aha Moment、產品定位，不需要重新定義。單一功能不需要 PR-FAQ 新聞稿、GEM+RICE 全面重新排序。聚焦在「加什麼、怎麼加、會不會搞壞現有的東西」。
+
+### 功能擴充步驟序列
+
+```
+S1. 問題 + 既有系統上下文
+S2. 三平行解法 + 優缺點 + AI 推薦 → 讀取 references/04b-solutions.md → 3.2
+S3. 風險評估（回歸 + 相容性）→ 讀取 references/04b-solutions.md → 3.3
+S4. 執行範圍（做什麼 / 不動什麼 / 驗收標準）→ 讀取 references/04c-mvp.md
+────
+最終產出 → 功能開發規格
+```
+
+### S1 前置：產品上下文載入
+
+進入 S1 前，讀取 `references/rules-context.md` 並檢查 `.product-context.md`：
+
+- **有完整上下文（情境 1）**：自動帶入產品名稱、技術棧、主要模組、近 3 筆 Decision History。S1 引導改為**確認式**：「你的產品是 [名稱]，使用 [技術棧]，主要模組包括 [模組清單]。這次要新增的功能是什麼？會影響哪些模組？」（問題 2 和部分問題 3 已預填，只需確認）
+- **無上下文（情境 2）**：觸發 Context Bootstrap（`rules-context.md` Section 4），完成後再進入下方標準 S1
+- **部分上下文（情境 3）**：帶入已知的技術棧和模組（從 Decision History 合併），缺失部分仍需收集。例如：「除了 [已知模組]，還有其他會被影響的模組嗎？」
+
+### S1 引導內容（問題 + 既有系統上下文）
+
+Claude 需收集以下資訊（逐步引導，不要一次丟出所有問題。若 context 已預填部分答案，改為確認而非重新收集）：
+
+```
+1. 要新增什麼功能？解決什麼問題？
+2. 目前的產品架構概況（技術棧、主要模組）← context 可預填
+3. 這個功能會影響哪些現有模組？← context 可部分預填
+4. 有沒有相關的用戶反饋或數據支持這個需求？
+```
+
+### S2 引導內容（三平行解法 + AI 推薦）
+
+```
+| HMW | 解法 A（保守/最小改動） | 解法 B（平衡） | 解法 C（大膽/重構） |
+|-----|----------------------|--------------|-------------------|
+| [問題] | | | |
+
+| 解法 | 優點 | 缺點 | 影響範圍 | 實作複雜度 |
+|------|------|------|---------|-----------|
+| A | | | | |
+| B | | | | |
+| C | | | | |
+
+🤖 AI 推薦：解法 [X]
+推薦理由：[基於影響範圍、複雜度、風險的綜合判斷]
+```
+
+### S3 引導內容（風險評估 — 聚焦回歸與相容性）
+
+```
+| 風險類型 | 具體風險 | 發生可能性 | 預防措施 |
+|---------|---------|-----------|---------|
+| 回歸風險 | [現有功能可能被影響的地方] | | |
+| 相容性風險 | [與現有架構/資料/API 的衝突] | | |
+| 效能風險 | [新功能對系統效能的影響] | | |
+| 安全性風險 | [新功能引入的安全性考量] | | |
+```
+
+### S4 引導內容（執行範圍）
+
+```
+**做什麼（Scope）**：
+- [具體要新增的功能項目]
+- [需要修改的現有模組]
+
+**不動什麼（Do Not Touch）**：
+- [明確不修改的模組和功能]
+- [不動的原因]
+
+**驗收標準**：
+- [ ] [可測試的具體條件]
+- [ ] [回歸測試：確認現有功能不受影響]
+```
+
+### 功能擴充最終產出格式
+
+**功能開發規格**：問題陳述 → 選定解法 + 理由 → 影響範圍 → 執行範圍 + 驗收標準 → 風險清單
+
+### 增量文件產出（當有原始文件時）
+
+如果使用者在流程中上傳了原始文件（PRD、規格書等）：
+
+1. **增量版本**（有原始文件時為預設）：
+   - 在原始文件結構中插入/修改章節
+   - 維持原始檔案的格式、風格與命名慣例
+   - 新增內容標記為 `[NEW]`
+   - 修改內容標記為 `[UPDATED]`，並保留原始內容作為參考
+   - 與新功能無關的章節完全不動
+
+2. **獨立版本**（無原始文件時）：
+   - 使用標準的功能開發規格格式（如上方定義）
+
+3. **產出前先詢問使用者**：
+   「我偵測到你上傳了一份 [文件類型]。你希望產出的方式是？
+    A) 在原始文件上增量更新（推薦）
+    B) 獨立的功能開發規格」
+
+### Reference 載入指示
+
+| 步驟 | Reference 檔案 |
+|------|---------------|
+| S1 | 無需外部 reference |
+| S2 | `references/04b-solutions.md` → 3.2 |
+| S3 | `references/04b-solutions.md` → 3.3 |
+| S4 | `references/04c-mvp.md` |
+
+完成後，依 `references/rules-end-of-flow.md` 執行流程結束規則。

package/references/rules-change-propagation.md

@@ -0,0 +1,74 @@
+# 🔄 變更傳播規則（Change Propagation）
+
+> 當使用者修改已完成步驟時載入。
+
+## 📍 進度指示器（每個步驟都必須顯示）
+
+在執行任何步驟時，Claude 必須在回應的最開頭顯示進度列，格式：
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📍 [執行模式] ｜ 進度 S[目前步驟編號] / S[總步驟數]
+✅ S1：[步驟名稱]（已完成）
+✅ S2：[步驟名稱]（已完成）
+▶️ S3：[步驟名稱]（進行中）
+⬜ S4：[步驟名稱]（待執行）
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+此進度指示器在以下情況都必須出現：
+- 每進入一個新步驟
+- 使用者回到某個步驟進行修改時
+- 完成某個步驟、詢問使用者確認後進入下一步時
+
+## 觸發方式
+- 「回到 Persona」「回到 JTBD」「回到 HMW」「回到 PR-FAQ」等任意步驟名稱
+- 「我想修改一下 [步驟名]」「[步驟名] 的部分我想改」
+- 直接對某個已產出的表格或內容說「這裡改成...」
+
+## 修改後的必要動作
+
+當任何步驟被修改，Claude **必須主動執行以下檢查**：
+
+```
+修改層級               受影響的下游（必須重新確認或更新）
+─────────────────────────────────────────────────────
+Persona / JTBD        → HMW、機會評估表、Positioning、PR-FAQ、North Star、產品規格摘要
+HMW / 機會評估        → PR-FAQ、平行解法、MVP、North Star、產品規格摘要
+Positioning           → PR-FAQ、產品規格摘要
+PR-FAQ / 解法         → Pre-mortem、GEM/RICE、MVP、Aha Moment、產品規格摘要
+MVP / Not Doing List  → User Story、DB schema（若已產出）、產品規格摘要
+North Star / 指標     → 假設驗證計畫、產品規格摘要
+產品規格摘要           → HTML 報告、PRD（若已產出）
+```
+
+### 功能擴充依賴關係：
+```
+功能擴充依賴關係：
+─────────────────────────────────────────────────────
+S1（問題 + 情境）     → S2（解法）、S3（風險）、S4（執行範圍）
+S2（選定解法）        → S3（風險）、S4（執行範圍）
+S3（風險評估）        → S4（執行範圍）
+```
+
+## 執行方式
+
+1. **告知使用者影響範圍**：「你修改了 [步驟]，這會影響到 [下游步驟清單]，我會逐一更新。」
+2. **逐一確認或自動更新下游**：
+   - 若下游改動小（措辭調整）→ 直接更新，說明改了什麼
+   - 若下游改動大（方向轉變）→ 提示使用者確認新方向再更新
+3. **最終重新整合產品規格摘要**
+4. **若已產出 HTML 報告或 PRD**：直接重新產出，並輸出版本快照：
+
+```
+📋 版本快照 v[舊版號] → v[新版號]
+修改的步驟：[步驟名稱]
+修改前的關鍵內容：[1-3 句話]
+修改後的關鍵內容：[1-3 句話]
+連帶更新的下游：[哪些步驟被一併調整]
+```
+
+## 原則
+- 任何修改都不會靜默發生——必須明確告知影響範圍
+- 使用者有權選擇「只改這一步，下游暫時不動」，Claude 需標記哪些部分已過時（加上 ⚠️ 待更新 標記）
+- 修改歷史在對話中保持可追溯

package/references/rules-commands.md

@@ -0,0 +1,98 @@
+# 🔧 框架選單 + 補充指令
+
+> 當使用者要求「列出框架」「給我看有哪些框架」或使用補充指令時載入。
+
+## 指定框架
+
+**觸發方式有兩種：**
+
+**方式 A（使用者直接說框架名稱）：** 直接進入該框架引導流程，不需要再問。
+
+**方式 B（使用者說「我想指定框架」「列出所有框架」等）：** 呈現以下選單：
+
+```
+📚 可指定的框架清單，請填寫編號或名稱：
+
+【理解用戶】
+ 1. JTBD（Jobs to Be Done）— 找出用戶真正想完成的工作
+ 2. Persona — 建立用途/任務/動機導向的用戶角色
+ 3. User Journey Map — 繪製用戶完整體驗旅程
+ 4. Continuous Discovery — 建立每週接觸用戶的持續習慣
+
+【定義問題】
+ 5. OST / 機會解法樹 — 系統化連結機會與解法
+ 6. Positioning / April Dunford — 找出真正的競爭場域和差異化
+ 7. HMW — 將痛點轉化為設計問題
+
+【解法設計】
+ 8. Working Backwards / PR-FAQ — 從用戶結果出發倒推解法
+ 9. Pre-mortem / 事前驗屍 — 在失敗前預測並預防失敗
+10. GEM — Growth / Engagement / Monetization 三維優先排序
+11. RICE — 量化功能優先排序
+12. MVP — 定義最小可行產品範圍
+
+【策略層】
+13. Strategy / Strategy Blocks — Mission → Vision → Strategy 層級結構
+14. DHM Model — Delight / Hard to copy / Margin-enhancing 機會檢驗
+15. LNO Framework — Leverage / Neutral / Overhead 時間分配
+16. Empowered Teams — 賦能型團隊 vs 功能型團隊
+
+【衡量層】
+17. North Star / 北極星指標 — 定義代表核心用戶價值的單一指標
+18. PMF — 判斷產品市場契合度的四個等級
+19. Sean Ellis Score — 量化 PMF 熱情程度
+
+【商業層】
+20. 商業模式與定價 — 收費模式選擇與價值定價對齊
+21. GTM 策略 — Go-to-Market 上市與獲客策略
+
+【開發銜接】
+22. Dev Handoff / 開發交接包 — 產出 CLAUDE.md + TASKS.md + TICKETS.md，銜接 Claude Code 開發
+
+請輸入框架編號或名稱（可多選，用逗號分隔）：
+```
+
+## 跳過 Discovery / 直接進實作
+
+當使用者說「跳過用戶研究」「問題已知」「直接進到 Develop」時，讀取 `references/rules-build.md` 並依照直接實作模式步驟序列執行。
+
+> 提醒使用者：「跳過用戶研究階段，代表解法建立在假設上。建議執行後盡快進行 Continuous Discovery 驗證。」
+
+## 功能擴充模式觸發
+
+- 「新增功能」/「我要在現有產品加一個功能」/「加新功能」→ 觸發功能擴充模式（讀取 `references/rules-build.md` → 功能擴充快速路徑）
+
+## 補充指令
+
+| 指令 | 行為 |
+|------|------|
+| `「切換到 [框架]」` | 立即切換，保留已完成內容 |
+| `「我想改變目標對象」` | 重新調整框架優先序和呈現方式 |
+| `「跳過這個步驟」` | 提醒必要性後尊重決定，進入下一步 |
+| `「回到 [步驟/框架名稱]」` | 回到指定的任意步驟重新引導（見 `references/rules-change-propagation.md`） |
+| `「幫我簡化」` / `「幫我展開」` | 濃縮核心要點 / 深入補充分析 |
+| `「產出報告」` | 讀取 `references/06-html-report.md`，產出 HTML 企劃報告 |
+| `「產出 PRD」` / `「產出給工程師的文件」` | 讀取 `references/04b-solutions.md`，整合 PR-FAQ + MVP + User Story + Pre-mortem，**自動一併產出：流程圖（Mermaid）+ DB schema（Mermaid ERD）+ UI wireframe（HTML）** |
+| `「產出流程圖」` / `「幫我畫流程圖」` | 以 Mermaid 語法產出流程圖（單獨觸發） |
+| `「產出 DB schema」` / `「幫我設計資料庫」` | 產出 DB schema（Mermaid ERD 語法）（單獨觸發） |
+| `「產出 UI wireframe」` / `「幫我畫線框圖」` | 以 HTML/SVG 產出低保真 UI 線框圖（單獨觸發） |
+| `「產出簡報」` / `「幫我做成 PPT」` | 呼叫系統 pptx skill |
+| `「把文件調整成給 [對象] 看的版本」` | 重新編排框架重點和呈現語言 |
+| `「我只有 15 分鐘」` | 給出最關鍵的三個決策問題或行動 |
+| `「幫我做完整性評估」` | 評估哪些環節完整、哪些有風險 |
+| `「幫我找出假設」` | 識別所有尚未驗證的核心假設清單 |
+| `「做一次 Pre-mortem」` | 對任何解法立即進行事前驗屍 |
+| `「產出給不同對象的版本」` | 自動產出多個對象版本的摘要 |
+| `「這個產品在 PMF 哪個等級？」` | 判斷 PMF 等級並說明下一步里程碑 |
+| `「幫我找出瓶頸」` | 分析最影響 Aha Moment 到達率的障礙 |
+| `「我要改版，不是新產品」` | 切換改版模式（讀取 `references/rules-revision.md`） |
+| `「我要說服老闆批准」` | 切換老闆模式，突出商業價值和資源邏輯 |
+| `「進入開發」` / `「產出開發交接包」` | 讀取 `references/07a-handoff-core.md`，確認技術棧後產出完整開發交接包 |
+| `「幫我建專案」` / `「接到 Claude Code」` | 同上 |
+| `「暫停」` / `「存檔」` / `「先做別的」` | 依 `references/rules-progress.md` 存檔 |
+| `「繼續」` / `「回到企劃」` | 依 `references/rules-progress.md` 恢復 |
+| `「清除進度」` / `「重新開始」` | 刪除進度檔案，從頭開始 |
+| `/export [format]` | 匯出為指定格式。format = `pdf` / `docx` / `pptx` / `html` / `md`。讀取 `references/rules-export-document.md`，首次使用時先載入 `references/rules-document-tools.md` 檢查工具。 |
+| `/parse [file]` | 解析上傳的文件為 Markdown。支援 PDF / DOCX / PPTX / 圖片。讀取 `references/rules-import-document.md`，首次使用時先載入 `references/rules-document-tools.md` 檢查工具。 |
+
+**上下文相關指令提示**：每個步驟完成時，根據當前進度主動提示 2-3 個最相關的可用指令。

package/references/rules-context.md

@@ -0,0 +1,291 @@
+# 📦 產品上下文累積規則
+
+> 此檔案定義 `.product-context.md` 的格式、讀寫規則、情境處理和衝突解決。
+> 由 SKILL.md 啟動流程觸發載入，或由各模式 S1 前置步驟載入。
+
+## 1. 檔案位置與生命週期
+
+- **路徑**：專案根目錄下的 `.product-context.md`（與 `.product-playbook-progress.md` 同層）
+- **永久保留**：此檔案在流程結束後**不會被刪除**，跨 session 持續累積
+- **首次建立時**提醒使用者：「⚠️ 建議將 `.product-context.md` 加入 `.gitignore`，此檔案可能包含敏感的產品策略資訊。」
+
+---
+
+## 2. 檔案格式
+
+```markdown
+# Product Context
+<!-- Auto-maintained by product-playbook. Do not delete. -->
+<!-- last-updated: [ISO timestamp] -->
+
+## Identity
+- **Product name**: [name]
+- **Product type**: [B2C / B2B / B2B2C / Internal tool]
+- **One-liner**: [一句話描述]
+- **Target audience**: [主要 Persona 摘要]
+
+## Core Strategy
+- **Core JTBD**: [Target Customer] + wants to [Job] + in [Context]
+  - Functional: [...]
+  - Emotional: [...]
+  - Social: [...]
+- **Positioning (April Dunford)**:
+  - Real competitive alternatives: [...]
+  - Unique attributes: [...]
+  - Core value: [...]
+  - Target market: [...]
+  - Market category: [...]
+- **North Star Metric**: [指標名 + 定義]
+- **Aha Moment**: [描述]
+
+## Architecture & Tech Stack
+- **Tech stack**: [語言、框架、基礎設施]
+- **Key modules**: [主要模組清單]
+- **Data model highlights**: [核心資料實體，若已知]
+
+## Decision History
+<!-- Append-only. 每次完成流程追加一筆。 -->
+
+### [ISO date] - [流程類型: Full/Quick/Revision/Feature Extension/Custom/Build]
+- **Scope**: [規劃/變更範圍]
+- **Key decisions**: [重大決策]
+- **Risks identified**: [風險]
+- **MVP boundary**: [做什麼 / 不做什麼]
+- **Success metrics**: [成功指標 + 目標值]
+
+## Language Preference
+- **Installed language**: [從 .lang 檔案自動偵測或使用者的語系]
+- **User's preferred language**: [使用者溝通時使用的語言]
+
+## Accumulated Insights
+- **Known pain points**: [痛點清單，附來源]
+- **User feedback themes**: [跨 session 的反饋主題]
+- **PMF status**: [最近評估等級 + 日期]
+- **Security posture**: [認證/授權方式、已知漏洞]
+- **Technical debt**: [跨 session 累積的技術債]
+```
+
+---
+
+## 3. 三種情境偵測
+
+啟動時（進度檔案檢查之後、模式選擇之前），偵測 `.product-context.md` 狀態：
+
+| 條件 | 情境 | 動作 |
+|------|------|------|
+| 檔案存在，`Core Strategy` section 有實際內容（非空/非 placeholder） | **情境 1：完整上下文** | 靜默載入。顯示：「📦 偵測到 **[產品名]** 的產品上下文，將作為本次規劃的基線。」 |
+| 檔案不存在 | **情境 2：無上下文** | 記錄此狀態。進入功能擴充或改版模式時觸發 Context Bootstrap（見 Section 4） |
+| 檔案存在，`Core Strategy` 空白或僅有 placeholder，但 `Decision History` 有至少一筆紀錄 | **情境 3：部分上下文** | 顯示已知資訊摘要，提供補充選項（見 Section 5） |
+
+**偵測邏輯**：
+1. 檔案是否存在？
+2. `Identity` section 是否有 Product name（非 placeholder）？
+3. `Core Strategy` section 是否有 Core JTBD（非 placeholder）？→ 有 = 情境 1
+4. `Decision History` section 是否有任何 `###` 條目？→ 有但 3 為否 = 情境 3
+
+---
+
+## 4. Context Bootstrap（情境 2 專用）
+
+當使用者進入**功能擴充**或**改版模式**但沒有 `.product-context.md` 時，在模式 S1 之前插入「Step 0」。
+
+**呈現方式**：
+```
+📦 這是你第一次在此專案使用產品規劃工具。為了讓後續流程更有效率，
+我先收集一些基本產品資訊（約 2-3 分鐘），之後會自動保存供未來使用。
+```
+
+### 漸進式收集（不要一次丟出所有問題）
+
+**Round 1（所有模式必問）**：
+- 產品叫什麼名字？
+- 一句話描述它做什麼？
+- 產品類型？（B2C / B2B / B2B2C / 內部工具）
+
+**Round 2（功能擴充必問，改版選問）**：
+- 使用什麼技術棧？（語言、框架、資料庫、基礎設施）
+- 主要模組或服務有哪些？
+
+**Round 3（改版必問，功能擴充選問）**：
+- 目前有 DAU/MAU 或留存率數據嗎？
+- 最常收到的用戶反饋或投訴是什麼？
+- 有已知的安全問題或技術債嗎？
+
+### Tech Stack 自動偵測
+
+除了使用者口述，Bootstrap 可**讀取專案檔案**輔助偵測（唯讀，不違反 Hard Gate）：
+
+| 檔案 | 偵測內容 |
+|------|---------|
+| `package.json` | Node.js 生態系、框架、依賴 |
+| `Cargo.toml` | Rust |
+| `go.mod` | Go |
+| `requirements.txt` / `pyproject.toml` | Python |
+| `Dockerfile` / `docker-compose.yml` | 容器化架構 |
+| 專案根目錄結構（`src/`、`app/`、`lib/` 等） | 模組推斷 |
+
+偵測後以**確認式**呈現：
+```
+我偵測到你的專案使用：
+- 技術棧：Next.js 14 + TypeScript + PostgreSQL + Redis
+- 主要模組：auth/、billing/、dashboard/、api/
+這些正確嗎？有需要補充或修正的嗎？
+```
+
+使用者確認後才寫入 `.product-context.md`。
+
+### Bootstrap 完成後
+
+將收集到的資訊寫入 `.product-context.md`，未收集的 section 留空（使用 placeholder），然後進入模式的正式 S1。
+
+---
+
+## 5. 部分上下文處理（情境 3）
+
+當 `.product-context.md` 存在但 Core Strategy 為空、僅有 Decision History 時：
+
+**呈現方式**：
+```
+📦 我有你之前 [N] 次規劃的紀錄：
+- 技術棧：[從 Decision History 合併的已知 stack]
+- 曾修改的模組：[從 Decision History 合併的 affected modules]
+- 核心產品策略尚未記錄。
+
+你想要：
+  1️⃣ 直接開始（使用已知資訊，策略部分跳過）
+  2️⃣ 先補充策略資訊（JTBD、定位、北極星指標）
+  3️⃣ 這些資訊有誤，我來修正
+```
+
+**自動重建嘗試**：掃描所有 Decision History 條目，從 `Affected modules`、`Scope`、`Key decisions` 中提取重複出現的產品名稱、技術棧、模組名稱，自動填入 `Architecture & Tech Stack`。以 `<!-- inferred from decision history -->` 標註推斷來源。
+
+---
+
+## 6. Context Auto-Read 規則
+
+各模式 S1 前置載入 context 時，**只注入相關 sections**，不要向使用者完整顯示檔案內容：
+
+| 模式 + 步驟 | 注入的 Context Sections |
+|-------------|------------------------|
+| 功能擴充 S1 | Identity, Architecture & Tech Stack, 最近 3 筆 Decision History |
+| 改版 S1 | Identity, Core Strategy, Accumulated Insights（痛點、PMF、安全）, 最近 3 筆 Decision History |
+| 完整/Quick/Build S1 | Identity only（產品名、類型、一句話描述） |
+| 任何模式的 Pre-mortem | Security posture + Technical debt（從 Accumulated Insights） |
+
+**膨脹控制**：Decision History 預設只注入最近 3 筆。使用者可要求載入更多。
+
+---
+
+## 7. 空白 Sections 跳過規則
+
+Context 檔案存在但某些 sections 為空時，依**模式**決定是否可跳過或需收集：
+
+| Section | 功能擴充 | 改版模式 | 完整/Quick/Build |
+|---------|---------|---------|-----------------|
+| Identity | 必要（無則 Bootstrap） | 必要（無則 Bootstrap） | 流程本身會產出，不需預載 |
+| Core Strategy | **可跳過** | 必要（無則在 S1 內快問快答補收集） | 流程本身會產出 |
+| Architecture & Tech Stack | 必要（無則 Bootstrap 或自動偵測） | 可跳過 | 流程本身會產出 |
+| Decision History | 可跳過 | 有則帶入，無則跳過 | 流程本身會產出 |
+| Accumulated Insights | 可跳過 | 有則帶入，無則跳過 | 流程本身會產出 |
+
+| 功能擴充模式 | Identity（僅確認）、Architecture & Tech Stack（必要）、Core Strategy（可跳過） |
+
+**原則**：空白 section **不阻擋流程**。只有對當前模式「必要」且為空的 section 才觸發收集。
+
+---
+
+## 8. Context Auto-Write 規則（流程結束時萃取）
+
+流程結束時（與 `rules-end-of-flow.md` 的結束條件檢查同步），自動萃取 context：
+
+| 流程類型 | 寫入/更新的 Sections |
+|---------|---------------------|
+| Quick | Identity, Core Strategy（JTBD + North Star）, 追加 Decision History |
+| Full | **全部 sections**（覆寫 Identity/Strategy/Insights，追加 History） |
+| Revision | 更新 Core Strategy（若有重新定位）, 更新 Insights, 追加 History |
+| Feature Extension | 合併 Architecture, 追加 Decision History（功能專用模板） |
+| Custom | 更新對應已完成步驟的 sections |
+| Build（7 步） | Identity, Core Strategy（部分）, 追加 History |
+
+### 寫入策略
+
+| Section | 策略 | 說明 |
+|---------|------|------|
+| Identity | **最新覆寫** | 每次都用最新流程的資料覆寫 |
+| Core Strategy | **最新覆寫** | 同上。改版後的策略取代改版前的 |
+| Architecture & Tech Stack | **合併** | 新增模組不刪除舊的。新技術項目追加 |
+| Decision History | **僅追加** | 永遠不刪除先前紀錄。每次完成流程追加一筆 |
+| Accumulated Insights | **合併去重** | 痛點、反饋主題去重追加。PMF、Security 覆寫為最新值 |
+
+### Decision History 追加模板
+
+**通用模板**：
+```markdown
+### [ISO date] - [流程類型]
+- **Scope**: [...]
+- **Key decisions**: [...]
+- **Risks identified**: [...]
+- **MVP boundary**: [...]
+- **Success metrics**: [...]
+```
+
+**功能擴充專用模板**：
+```markdown
+### [ISO date] - Feature Extension: [功能名稱]
+- **Problem**: [一句話問題陳述]
+- **Chosen solution**: [選定方案 + 理由]
+- **Affected modules**: [影響的模組]
+- **Scope**: [做什麼 / 不動什麼]
+- **Acceptance criteria**: [驗收標準]
+```
+
+### 完成後通知
+
+```
+✅ 產品上下文已更新至 `.product-context.md`，下次規劃時將自動載入。
+```
+
+---
+
+## 9. 衝突處理
+
+### 使用者修正既有 context
+
+完全允許。使用者提供的修正直接覆寫對應 section（latest wins）。
+
+### 使用者提供的資料與程式碼不一致
+
+當 S1 前置同時讀取了 `.product-context.md` 和專案檔案（如 `package.json`），發現兩者不一致時：
+
+```
+⚠️ 偵測到資訊不一致：
+- Context 記錄：[context 中的值]
+- 專案程式碼：[程式碼中偵測到的值]
+請確認哪個是正確的？
+  1️⃣ 以程式碼為準（更新 context）
+  2️⃣ 以 context 為準（可能正在遷移中）
+  3️⃣ 兩者都不完整，我來說明
+```
+
+**處理原則**：
+- **不自動覆寫**，由使用者裁決
+- 使用者選擇後更新 `.product-context.md`
+- 若選「正在遷移」，在 Architecture section 標注：`[遷移中] React → Vue 3`
+- 衝突紀錄寫入 Decision History
+
+### 流程中的新資料覆蓋 context
+
+若流程中產出的資料與 context 中的舊資料不同（例如改版模式重新定義了 JTBD），**流程資料優先**。流程結束時自動覆寫。
+
+---
+
+## 10. 語系偏好
+
+當 `.product-context.md` 被建立或更新時，將語系偏好記錄到 `Language Preference` section：
+
+- **Installed language**：從 skill 安裝目錄的 `.lang` 檔案偵測，或從使用者的語系設定取得。
+- **User's preferred language**：使用者在 session 中溝通所使用的語言。
+
+**載入規則**：載入既有的 `.product-context.md` 時，若已記錄語系偏好，則以該語言繼續 session。
+
+**寫入時機**：語系偏好在 Context Bootstrap（Section 4）時寫入，或在首次建立 context 檔案的流程結束時寫入。當使用者在 session 中明確切換語言時，會同步更新。

package/references/rules-custom.md

@@ -0,0 +1,63 @@
+# ✏️ 自訂模式步驟序列
+
+> 此檔案為自訂模式的權威步驟定義。由 SKILL.md 核心派發載入。
+
+依使用者選擇的完整性等級：
+
+## 🔴 低（Lean）— 共 4 步
+
+```
+S1. JTBD 陳述 → 讀取 references/02b-jtbd.md
+S2. HMW 一個 → 讀取 references/03-define.md → 2.3
+S3. PR-FAQ → 讀取 references/04a-prfaq.md
+S4. North Star → 讀取 references/05a-northstar-aha.md
+（任一步驟可由使用者替換為其他框架）
+────
+最終產出 → 產品規格摘要（未執行欄位標記「未執行」）
+```
+
+## 🟡 中（Standard）— 共 10 步
+
+```
+S1.  Persona Table + Persona 卡片 → 讀取 references/02a-persona.md
+S2.  JTBD 分析 → 讀取 references/02b-jtbd.md
+S3.  痛點彙整表 → 讀取 references/03-define.md
+S4.  HMW 問題轉化 → 讀取 references/03-define.md
+S5.  April Dunford 定位 → 讀取 references/03-define.md
+S6.  PR-FAQ → 讀取 references/04a-prfaq.md
+S7.  平行解法 + MVP + Not Doing List → 讀取 references/04b-solutions.md + references/04c-mvp.md
+S8.  North Star + 三層訊號 + Aha Moment → 讀取 references/05a-northstar-aha.md
+S9.  PMF 等級判定 → 讀取 references/05b-pmf-gtm.md
+S10. 產品規格摘要 → 讀取 references/05c-validation-spec.md
+```
+
+## 🟢 高（Comprehensive）— 共 16 步
+
+```
+S1.  Strategy Blocks + Rumelt → 讀取 references/01-strategy.md
+S2.  Persona Table + Persona 卡片 → 讀取 references/02a-persona.md
+S3.  JTBD 分析 → 讀取 references/02b-jtbd.md
+S4.  OST 機會解法樹 → 讀取 references/02c-ost-journey.md
+S5.  User Journey Map → 讀取 references/02c-ost-journey.md
+S6.  痛點彙整表 → 讀取 references/03-define.md
+S7.  HMW + April Dunford 定位 → 讀取 references/03-define.md
+S8.  機會評估表 → 讀取 references/03-define.md
+S9.  PR-FAQ → 讀取 references/04a-prfaq.md
+S10. 平行原型 → 讀取 references/04b-solutions.md
+S11. Pre-mortem → 讀取 references/04b-solutions.md
+S12. GEM + RICE → 讀取 references/04b-solutions.md
+S13. MVP + Not Doing List → 讀取 references/04c-mvp.md
+S14. North Star + 三層訊號 + Aha Moment → 讀取 references/05a-northstar-aha.md
+S15. 假設驗證計畫 → 讀取 references/05c-validation-spec.md
+S16. 產品規格摘要 → 讀取 references/05c-validation-spec.md
+```
+
+## Reference 載入規則
+
+進入各步驟時，僅讀取對應的 reference 檔案（不要預先全部載入）。各步驟旁已標注對應的 reference 路徑。
+
+## 最終產出格式
+
+**產品規格摘要**（僅整合已完成的步驟，未執行的欄位標記為「未執行」）
+
+完成後，依 `references/rules-end-of-flow.md` 執行流程結束規則。