dflow-sdd-ddd 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,1176 @@
+# Changelog
+
+本文件記錄 SDD/DDD Skill 的版本變更。早期變更依 Proposal 編號分段；historical proposal records 已移到 `archive/proposals/`，新發布紀錄可直接按 release / closeout milestone 分段。
+
+格式：每個版本標註日期、關聯 Proposal、影響範圍。新版本加在最上方。
+
+---
+
+## 0.2.0 — 2026-05-09 — Public migration tooling, governance baseline, and evaluator onboarding
+
+**Proposals**：PROPOSAL-016（governance baseline）、PROPOSAL-017（AI-assisted feedback flow）、PROPOSAL-018（repository consistency）、PROPOSAL-021（verification-only CI）。其餘為 backlog 推進的公開 docs 與 migration tooling 累積項。
+
+**變更**：
+- 新增 CLI 子命令 `dflow doctor`，read-only 健檢三條 V1 migration signal（root `specs/`、`_共用/`、缺 `> Dflow Version:` 行），輸出指向 `docs/migrating-to-dflow-v1.md`。
+- 生成檔 shape 調整：`dflow/specs/shared/_conventions.md` front matter 新增 `> Dflow Version: <version>` 行，由 `lib/init.js` 用 `package.json#version` 替換為實際版本。
+- 新增 `/dflow:report-dflow-feedback` workflow，AI 將 upstream 觀察整理為本地 sanitized draft，不自動送出（PROPOSAL-017）。
+- `AI-AGENT-GUIDE.md` 新增 `## Pre-V1 Artifacts Detection` 段，要求 AI 偵測 6 類 pre-V1 殘留訊號並 surface，禁止 silent rewrite。
+- 新增 `docs/migrating-to-dflow-v1.md` 人讀 migration guide 覆蓋 5 條 V1 baseline 變更；README Status 與 `lib/init.js` legacy `specs/` warning 都加 cross-link。
+- Public governance baseline（PROPOSAL-016）：`CONTRIBUTING.md`、`docs/release-versioning-policy.md`、`docs/npm-publish-checklist.md`、4 套 GitHub issue templates。
+- Public onboarding：`docs/evaluating-dflow.md` 公開評估者指引、`docs/using-with-claude-code.md`、`docs/using-with-codex.md` per-tool walkthrough、`tutorial/README.md` English Reading Guide、README Get Started cross-link。
+- Verification-only GitHub Actions workflow（PROPOSAL-021），對 `pull_request` / `push` 至 `main` 自動跑 `npm test` + `npm pack --dry-run` + `git diff --check`，不附 publish-capable secrets。
+- Dev-only consistency tooling（PROPOSAL-018）：`scripts/check-repo-consistency.sh` 一鍵驗證；`scripts/export-dist.sh` 新增 `--check` / `--dry-run`。
+- npm package hygiene：`package.json#files` 涵蓋 `CONTRIBUTING.md`、`CHANGELOG.md`、`TEMPLATE-COVERAGE.md`、`TEMPLATE-LANGUAGE-GLOSSARY.md`。
+- `TEMPLATE-COVERAGE.md` / `TEMPLATE-LANGUAGE-GLOSSARY.md` 內 PROPOSAL-013 reference 改指 `archive/proposals/PROPOSAL-013-system-document-template-coverage.md`。
+
+**Migration notes**：
+- 既有 0.1.x 專案的 generated `_conventions.md` 不會自動補 `> Dflow Version:` 行；可手動加，或循 `docs/migrating-to-dflow-v1.md` 在新建專案時自動帶入。
+- Pre-V1 採用者循 `docs/migrating-to-dflow-v1.md` 5 條 manual migration paths；CLI 對 legacy 路徑仍 warn-only，無 destructive auto-migration。
+
+**驗證**：
+- `npm test`
+- `npm pack --dry-run`
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- `git diff --check`
+
+詳見以下 dated entries（按時間倒序）。
+
+---
+
+## 2026-05-08 — `dflow doctor` read-only health check command
+
+**變更**：
+- 新增 `dflow doctor` CLI 子命令（`bin/dflow.js` + `lib/init.js`
+  `runDoctor`），提供 read-only 健檢，不修改任何檔案
+- 健檢三條 signal：
+  - 偵測 root `specs/` 是否含 Dflow 內容（指向 migration guide §1）
+  - 偵測 `_共用/` 是否殘留於 `specs/` 或 `dflow/specs/`（指向 §2）
+  - 偵測 `dflow/specs/shared/_conventions.md` 是否缺 `> Dflow Version:`
+    front-matter 行（建議 manual backfill）
+- 輸出格式列出 finding level（warn / info）、title、detail、action 與
+  finding 統計，並明示 doctor 為 read-only
+- `bin/dflow.js` 新增 `doctor` 子命令、`--help` 與 main help 說明
+- `test/smoke.mjs` 新增兩條 doctor 斷言（clean V1 init 與 legacy specs/
+  專案各一），驗證 finding 文字與 read-only stance
+- README "Get Started" 加段提到 `dflow doctor`；
+  `docs/migrating-to-dflow-v1.md` "Before You Start" 補一條 cross-link
+
+**邊界**：
+- read-only：doctor 不寫 / 不改 / 不刪除任何檔案；exit code 為操作成功
+  與否（findings 存在仍 exit 0），便於互動式檢查與 CI smoke
+- 依 `docs/release-versioning-policy.md`，新增 CLI 子命令屬 minor，本次
+  不 bump version、不 publish、不 tag、不建 GitHub Release；變更 accumulate
+  到下次 minor release window
+
+**驗證**：
+- `npm test`
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-08 — AI-AGENT-GUIDE adds Pre-V1 artifacts detection segment
+
+**變更**：
+- `AI-AGENT-GUIDE.md` scaffolding 新增 `## Pre-V1 Artifacts Detection`
+  段，要求 AI agent 在偵測到 6 類 pre-V1 殘留訊號時 surface 給使用者
+  並指向 `docs/migrating-to-dflow-v1.md`，明確禁止 silent rewrite
+  - top-level `specs/` 含 Dflow 內容
+  - `_共用/` directory
+  - V1 templates 應為 canonical English 但實際為繁中 heading
+  - 文件提及 runtime `/dflow:init-project` slash command
+  - root `CLAUDE.md` / `AGENTS.md` 為 full file 而非 thin shim
+  - `_conventions.md` 缺 `> Dflow Version:` 前 matter 行
+- 兩 track 同步：`sdd-ddd-greenfield-skill/scaffolding/AI-AGENT-GUIDE.md`、
+  `sdd-ddd-brownfield-skill/scaffolding/AI-AGENT-GUIDE.md` 與 packaged
+  template mirror 全部更新
+
+**邊界**：
+- 行為性質：AI 偵測後只 surface 觀察與建議手動 migration；不允許 AI
+  自行改寫既有檔案路徑或 heading
+- 不 bump version、不 publish、不 tag、不建 GitHub Release
+- 既有專案的 AI-AGENT-GUIDE 不會自動更新；要 backfill 可手動將該段
+  貼入 `dflow/specs/shared/AI-AGENT-GUIDE.md`，或在新建專案時自動帶入
+
+**驗證**：
+- `npm test`
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-08 — Init records Dflow Version in generated `_conventions.md`
+
+**變更**：
+- `_conventions.md` scaffolding template 在 front matter 新增一行
+  `> Dflow Version: {dflow-version}`，由 `lib/init.js` 在 init 時用
+  `package.json#version` 替換為實際版本號
+- 兩 track 同步：`sdd-ddd-greenfield-skill/scaffolding/_conventions.md`、
+  `sdd-ddd-brownfield-skill/scaffolding/_conventions.md` 與 packaged
+  template mirrors 全部更新
+- `test/smoke.mjs` 補兩條 assertions（Greenfield / Brownfield）驗證
+  該欄位存在且符合 semver 格式
+- 既有 0.1.0 / 0.1.1 init 過的專案不會自動補欄位；要補可在
+  `dflow/specs/shared/_conventions.md` front matter 自行加一行，或參考
+  `docs/migrating-to-dflow-v1.md` 的「Pre-V1 / V1 升級」流程後在新建
+  專案時自動帶入
+
+**邊界**：
+- 不改既有 init 行為的其他輸出，不新增 prompt
+- 不 bump version、不 publish、不 tag、不建 GitHub Release
+
+**驗證**：
+- `npm test`
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-08 — Migration guide cross-links from README and init warning
+
+**變更**：
+- `README.md` Status 段補一行連到 `docs/migrating-to-dflow-v1.md`，
+  讓既有 pre-V1 Dflow 採用者從首頁就能找到 manual migration checklist
+- `lib/init.js` 偵測到 legacy root `specs/` 時的 warning 文末附上
+  migration guide 連結，使 init 階段的 hint 可直接導向人讀步驟
+- CLI 行為仍為 warn-only：不修改既有檔案、不執行任何 migration 動作；
+  V1 clean cut 立場不變
+
+**邊界**：
+- 不 bump version、不 publish、不 tag、不建 GitHub Release
+- 不擴張 init 行為（無新 prompt、無自動 migration）
+
+**驗證**：
+- `npm test`
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-08 — Manual migration guide for V1 baseline
+
+**變更**：
+- 新增 `docs/migrating-to-dflow-v1.md`：人工 migration guide，覆蓋五條 V1 baseline 變更
+  - root `specs/` → `dflow/specs/`（PROPOSAL-014）
+  - `dflow/specs/_共用/` → `dflow/specs/shared/`（PROPOSAL-012）
+  - Chinese template heading → canonical English heading（PROPOSAL-013）
+  - `/dflow:init-project` runtime slash command → `npx dflow-sdd-ddd init` shell command（PROPOSAL-014）
+  - Claude-only init → multi-AI thin shim（PROPOSAL-020）
+- 文件刻意保留 manual：V1 不提供 auto-migration、`dflow doctor`、`dflow migrate`；相關 trigger 條件記錄於 `planning/version-upgrade-migration-strategy.md`
+
+**邊界**：
+- 不修 README cross-link（避免本批次擴張到 README rewriting）
+- 不 bump version、不 publish、不 tag、不建 GitHub Release
+
+**驗證**：
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- dist `npm test`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-08 — Template coverage / glossary archived P013 link fix
+
+**變更**：
+- `TEMPLATE-COVERAGE.md` 與 `TEMPLATE-LANGUAGE-GLOSSARY.md` 的 HTML comment 與 anchor-add 步驟改指向 `archive/proposals/PROPOSAL-013-system-document-template-coverage.md`
+- 舊路徑 `proposals/PROPOSAL-013` 已於 P013 implementation closeout 時 archive，公開讀者沿著舊 link 會 404
+
+**驗證**：
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- dist `npm test`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-08 — Per-tool walkthrough docs (Claude Code, Codex CLI)
+
+**變更**：
+- 新增 `docs/using-with-claude-code.md`：說明 `init` 在 Claude Code 環境下產生的檔案、`/dflow:*` slash commands 在 Claude Code 中如何呼叫、project-level 與 user-level 安裝差異
+- 新增 `docs/using-with-codex.md`：同範本對應 Codex CLI，覆蓋 `AGENTS.md` shim 與 Codex CLI 對 Dflow workflow 的呼叫方式
+- README "Files Created by Init" 段加 per-tool walkthrough cross-link
+- `docs/evaluating-dflow.md` AI tool support 段補上 per-tool walkthrough 連結
+
+**邊界**：
+- Gemini CLI / GitHub Copilot 兩條 walkthrough 本次不附，仍 gated；trigger 條件記錄於 `planning/public-onboarding-tasklist.md` §5
+
+**驗證**：
+- `scripts/export-dist.sh --check`
+- dist `npm test`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-08 — Public evaluator guide and onboarding cross-links
+
+**變更**：
+- 新增 `docs/evaluating-dflow.md`：public-facing decision aid，涵蓋 What `init` Creates and Does Not Do、Greenfield or Brownfield 選擇指引、30-Minute Evaluation Playbook、AI tool 支援
+- README "Get Started" 段加 evaluator guide 與 `tutorial/` cross-link，將 evaluator guide 定位為公開試用主入口
+- README "Files Created by Init" 段澄清 `init` 不複製 `tutorial/`，`tutorial/` 為 source repo 的 evaluation material，並連到 tutorial reading guide
+- `tutorial/README.md` 開頭加入 English Reading Guide：scenario 命名、step-file 編號、`outputs/` 鏡像規則、與 `docs/evaluating-dflow.md` 的分工
+- README 與 `CONTRIBUTING.md` 補 verification CI 說明：PR 會自動跑 GitHub Actions verification workflow，CI 為 verification-only
+
+**驗證**：
+- `scripts/export-dist.sh --check`
+- dist `npm test`
+- dist `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-07 — Verification-only CI workflow
+
+**Proposal**：PROPOSAL-021（implemented）
+
+**變更**：
+- 新增 `.github/workflows/verification.yml`：對 `pull_request` 至 `main`、`push` 至 `main`、`workflow_dispatch` 三類事件執行 `npm test`、`npm pack --dry-run`、`git diff --check`
+- Workflow 採 `permissions: contents: read`、workflow-level `concurrency`、Node 22；dev-only `scripts/check-repo-consistency.sh` 由 `MAINTAINERS.md` / 該腳本自身雙重 guard，dist workflow 自動 skip 該步
+- Actions runtime 升至 Node 24 compatible：`actions/checkout@v6`、`actions/setup-node@v6`
+- 新增 dev `.gitattributes`：`*.sh text eol=lf`，確保 shell scripts 在 Windows checkout 時不會被 CRLF 化破壞執行
+
+**邊界**：
+- CI 為 verification-only，不執行 publish、tag、Release，不需 publish-capable secrets
+- 詳細 release-boundary 設計與決策見 `archive/proposals/PROPOSAL-021-verification-ci-and-release-boundary.md`
+
+**驗證**：
+- dev / dist Verification GitHub Actions run 均 success
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- `git diff --check`
+
+---
+
+## 2026-05-06 — Public package docs polish
+
+**變更**：
+- README Get Started 補 Node.js / npm prerequisite，並說明 `init` 只建立 workflow docs / AI instruction files，不會 inspect、refactor、migrate application code
+- README 補建議 first adoption pass 可先用 branch 或 disposable sample project 檢查 generated `dflow/specs/`
+- CONTRIBUTING 補 template / scaffolding change 時需同步 skill source 與 packaged templates
+- CONTRIBUTING 的 common shared flow list 補 `dflow-feedback-flow.md`
+- Release / publish docs 補 maintainer-facing 語氣，避免 contributor 誤以為一般 PR 需要執行 publish checklist
+
+**驗證**：
+- `scripts/check-repo-consistency.sh`
+- `scripts/export-dist.sh --check`
+- dist `npm test`
+- dist `npm pack --dry-run`
+- dist `git diff --check`
+
+---
+
+## 2026-05-06 — Repository consistency local verification
+
+**Proposal**：PROPOSAL-018（implemented）
+
+**變更**：
+- 新增 dev-only `scripts/check-repo-consistency.sh`
+- 一鍵執行 `npm test`、`npm pack --dry-run`、`git diff --check`
+- 補 skill source vs npm packaged template mirror byte-compare
+- 補 Greenfield / Brownfield common reference flow coverage 檢查
+- 補 track-specific file manifest、`package.json#files`、`bin/dflow.js` shebang / executable、retired localized skill references 檢查
+- `AGENTS.md` / `CLAUDE.md` 補 dev repo consistency check 規則
+- Phase 1 不新增 GitHub Actions、不改 release ownership、不碰 npm publish / tag / GitHub Release
+
+**驗證**：
+- `scripts/check-repo-consistency.sh`
+- `git diff --check`
+
+---
+
+## 2026-05-06 — Dist sync script hardening
+
+**變更**：
+- `scripts/export-dist.sh` 新增 `--check`，可非破壞性確認 dist repo 已等同 dev public file set
+- `scripts/export-dist.sh` 新增 `--dry-run`，可預覽會 copy / update / remove 的 public distribution paths
+- 正常 export 結尾新增 known excluded stale path 驗證，避免 dev-only material 殘留在 dist repo
+- `AGENTS.md` 補上 `--check` / `--dry-run` 的長期操作規則
+
+**驗證**：
+- `bash -n scripts/export-dist.sh`
+- `scripts/export-dist.sh --check`
+- `scripts/export-dist.sh --dry-run`
+- `npm test`
+- `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-06 — Public README release-state clarification
+
+**變更**：
+- README Status 補清楚 npm latest 仍為 `0.1.1`
+- README Status 補清楚 GitHub source 可能已包含 post-`0.1.1` docs / governance / feedback-flow 更新，實際 release history 以 `CHANGELOG.md` 為準
+- Smoke test harness 改用 synchronous subprocess + scripted stdin，避免非 TTY 環境下等待 first output 導致 init 未實際執行
+
+**驗證**：
+- `npm test`
+- `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-06 — npm package hygiene: include referenced maintainer docs
+
+**變更**：
+- `package.json#files` 新增 `CHANGELOG.md`、`TEMPLATE-COVERAGE.md`、`TEMPLATE-LANGUAGE-GLOSSARY.md`
+- 原因：`CONTRIBUTING.md` 已進 npm package，且會指引 contributor 閱讀 template coverage / glossary；release policy 也以 `CHANGELOG.md` 作為 release history source
+- 保持 `.github/` 不進 npm package；issue templates 仍只屬 GitHub public repo surface
+
+**驗證**：
+- `npm test`
+- `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-06 — npm package hygiene: include contributing guide
+
+**變更**：
+- `package.json#files` 新增 `CONTRIBUTING.md`
+- 原因：README 已連到 `CONTRIBUTING.md`；下一次 npm package 應包含該文件，避免 npm package / npm README 上的 governance link 指向 package 內不存在的檔案
+- `.github/` 維持只屬於 GitHub public repo，不納入 npm package
+
+**驗證**：
+- `npm test`
+- `npm pack --dry-run`
+- `git diff --check`
+
+---
+
+## 2026-05-06 — AI-assisted Dflow feedback draft flow
+
+**Proposal**：PROPOSAL-017（implemented）
+
+**變更**：
+- 新增 `/dflow:report-dflow-feedback` standalone flow，讓 AI 將使用 Dflow 時發現的 upstream 問題或改良點整理成本地草稿
+- 新增雙版 `references/dflow-feedback-flow.md`，規範分類、safe evidence capture、redaction checklist、GitHub issue body draft、optional PR plan
+- 雙版 `SKILL.md` command routing、reference table、standalone command list 同步新增 feedback flow
+- 雙版 `AI-AGENT-GUIDE.md` 與 `CLAUDE-md-snippet.md`（含 packaged `templates/*/scaffolding/` source）同步新增命令說明
+- README / CONTRIBUTING 補 AI-assisted feedback draft 說明
+- `TEMPLATE-COVERAGE.md` 補 reference flow parity note，明示 GitHub CLI submission 需另案
+
+**邊界**：
+- 不自動執行 `gh issue create` / `gh pr create`
+- 不 push、不開 PR、不將本地資訊送出
+- 使用者必須審核 redaction checklist 後才可自行提交
+
+**驗證**：
+- `npm test`
+- `git diff --check`
+
+---
+
+## 2026-05-06 — Public project governance baseline
+
+**Proposal**：PROPOSAL-016（implemented）
+
+**變更**：
+- 新增 `CONTRIBUTING.md`，定義 public issue / PR guidance、Greenfield/Brownfield common-flow sync expectations、template heading change guard
+- 新增 `docs/release-versioning-policy.md`，定義 0.x patch / minor / breaking-change handling，以及 dev repo / dist repo / npm / GitHub Release 的 release surface
+- 新增 `docs/npm-publish-checklist.md`，整理 manual publish、post-publish smoke、tag、GitHub Release、dist sync closeout
+- 新增 GitHub issue templates：bug report、workflow change request、docs feedback、question
+- README 補 contributing / release policy / publish checklist links，並將 status wording 更新到 `0.1.1`
+- `planning/public-distribution-backlog.md` 標記 governance baseline 已由 P016 接管；release automation 仍保留為後續議題
+
+**驗證**：
+- `git diff --check`
+
+---
+
+## 0.1.1 — 2026-05-05 — Multi-AI init guide and tool shims
+
+**變更**：
+- CLI init 新增 Q6 AI coding agents，可選 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`.github/copilot-instructions.md`
+- 新增 `dflow configure-agents`，供已初始化專案後續追加 AI tool shims，不需重跑 init
+- 新增 `dflow/specs/shared/AI-AGENT-GUIDE.md` 作為 tool-neutral canonical guide
+- Tool-specific root files 改為 thin shim，既有檔案不覆寫，改產生 `dflow/specs/shared/*-snippet.md`
+- Optional starter Q5 移除 Claude-only 選項，避免 public init 看起來綁定單一 AI 工具
+- README、init contract、tutorial init 段與 coverage matrix 同步 multi-AI wording
+
+**驗證**：
+- `npm test`
+- `npm pack --dry-run`
+- `diff -qr` skill source vs packaged templates
+- `git diff --check`
+
+---
+
+## 2026-05-04 — Public distribution naming：Greenfield / Brownfield tracks
+
+**變更**：
+- 公開 track naming 從早期 `core` / `webforms` 改為 `greenfield` / `brownfield`
+- CLI init 移除第二題 edition prompt；Q1 project type 直接決定 packaged template set
+- package templates 目錄改為 `templates/greenfield/` 與 `templates/brownfield/`
+- AI-facing skill source 目錄改為 `sdd-ddd-greenfield-skill/` 與 `sdd-ddd-brownfield-skill/`
+- Tutorial 目錄改為 `tutorial/01-greenfield/` 與 `tutorial/02-brownfield/`
+- README / package metadata 同步 public dist repo wording，並納入 `docs/why-ddd-for-ai.md`
+
+**驗證**：
+- `npm test`
+- `npm pack --dry-run`
+- `diff -qr` skill source vs packaged templates
+- `git diff --check`
+
+---
+
+## 2026-05-01 — Public npm publish：`dflow-sdd-ddd@0.1.0`
+
+**發布**：`dflow-sdd-ddd@0.1.0` 已發布到 npm public registry。
+
+**驗證**：
+- `npx dflow-sdd-ddd --version` 回傳 `0.1.0`
+- `npx dflow-sdd-ddd --help` 顯示 `Dflow CLI 0.1.0`
+- `npx dflow-sdd-ddd init` 已在乾淨 temp project 寫出 Core greenfield baseline：`CLAUDE.md`、`dflow/specs/shared/*`、`dflow/specs/domain/*`、`dflow/specs/architecture/tech-debt.md`
+
+**Post-publish docs cleanup**：
+- 分段 tutorial 的 init 劇本標明為教學化轉寫，避免被誤讀為 `dflow-sdd-ddd@0.1.0` 的逐字 CLI transcript
+- 移除已退場的 P001 前 / P001 hybrid 單檔 tutorial，避免後續 AI 或人讀者誤用過期流程素材
+- 將歷史 proposal / review 材料移入 `archive/`，讓 `proposals/`、`reviews/` 保留給後續 active work
+- 完成 Closeout C2 tutorial 索引收尾：新增 `tutorial/README.md`、補 `01-greenfield/00-setup.md`，並加入 Mermaid reading map
+
+**備註**：npm publish 使用 npm Security Key / WebAuthn 2FA flow；不要使用 TOTP `--otp` 作為新帳號的預設發布路徑。
+
+---
+
+## 2026-05-01 — Post-R9 Publish Prep：npm package name 與 metadata
+
+**背景**：npm 上 unscoped `dflow` package name 已被既有 package 使用；本 repo 不能直接以 `dflow` 發布。
+
+**變更**：
+- `package.json` package name 改為 `dflow-sdd-ddd`
+- CLI bin 保留 `dflow`，並新增 `dflow-sdd-ddd` alias
+- README、skill source、package templates、tutorial init entry 更新為 `npx dflow-sdd-ddd init`
+- 補 npm publish metadata：keywords、repository、bugs、homepage、`publishConfig.access`
+- 新增 MIT `LICENSE`
+
+**使用方式**：
+- V1 public default：`npx dflow-sdd-ddd init`
+- 進階 global install：`npm install -g dflow-sdd-ddd` 後執行 `dflow init`
+
+---
+
+## 2026-05-01 — R9 Implement：PROPOSAL-014 CLI init + `dflow/specs/` namespace、PROPOSAL-015 prose language convention
+
+**前置**：PROPOSAL-014 / PROPOSAL-015 已於 2026-04-30 approved；實作採 shared-cut，避免 init flow、path namespace、prose-language convention 反覆 cascade
+**Proposal**：`proposals/PROPOSAL-014-cli-init-and-dflow-root-namespace.md`、`proposals/PROPOSAL-015-templates-prose-language-convention.md`（implemented）
+
+**W1 — init contract + npm package skeleton**
+- 新增 `planning/init-contract-spec.md` 作為 `npx dflow init` 的 authoritative contract
+- 新增 npm CLI skeleton：`package.json`、`bin/dflow.js`、`lib/init.js`
+- 打包 `templates/{core,webforms}/`；init 預設寫入 `dflow/specs/`
+- init Q&A 納入必填 `prose-language`，並寫入 `dflow/specs/shared/_conventions.md`
+
+**W2a — skill source cascade**
+- 雙版 `SKILL.md` 移除 `/dflow:init-project` runtime slash command 入口，init 改由 npm CLI 負責
+- 雙版 references、templates、scaffolding 路徑 cascade 到 `dflow/specs/`
+- 五條 prose-generating flow 在 Step 1 讀取 `dflow/specs/shared/_conventions.md` 的 `Prose Language`
+- 雙版 `_conventions.md` scaffolding 新增 `## Prose Language` 段
+
+**W2b — tutorial cascade**
+- Tutorial 對話與 outputs 改為 `npx dflow init` + `dflow/specs/`
+- Tutorial outputs 搬移到 `outputs/dflow/specs/**`
+- 補齊 brownfield WebForms init 段，承接後續 modify-existing / baseline-capture 劇情
+
+**W2c — root docs / closeout**
+- README adoption 改為 npm CLI first；V1 預設入口為 `npx dflow init`
+- `TEMPLATE-COVERAGE.md` generated / maintained paths 改為 `dflow/specs/...`
+- 明示 repo / project root `CLAUDE.md` 是特殊例外，維持在 root 供 AI tools 探測
+- `TEMPLATE-LANGUAGE-GLOSSARY.md` 補 `Prose Language`、`free prose`、`structural language` 等術語對照
+- P014 / P015 狀態更新為 `implemented`，保留原 user evaluation 決策紀錄語氣
+
+**Post-review fixes**
+- 修正 `dflow/specs/shared/` scaffolding 內指向 sibling `domain/`、`architecture/`、`migration/` 的 relative links，避免 generated `_overview.md` / `_conventions.md` 指到 `shared/` 底下的錯路徑
+- 補 smoke test assertion，防止 shared scaffolding link target 回歸為 unqualified sibling path
+- 補 planning docs closeout note，標明 W1a handoff / public-distribution backlog 中已由 P014 / P015 收斂的決策
+
+**V1 clean cut**
+- 新 baseline 是 `npx dflow init` + `dflow/specs/`
+- 不提供 legacy root `specs/` migration tool、dual-read 或自動搬移
+- R7 / R8 既有 CHANGELOG 歷史條目保留原樣，不追溯改寫
+
+---
+
+## 2026-04-28 — R8b 實施：PROPOSAL-013 系統文件樣板覆蓋與 Template Coverage Matrix
+
+**前置**：R8a / PROPOSAL-012 已 implemented；R8b Review + Approve 處理 17 個 finding（accept: 11 / accept-with-choice: 6）；4 項設計決策拍板 per `reviews/round-8b-decisions.md`
+**Proposal**：`proposals/PROPOSAL-013-system-document-template-coverage.md`（implemented）
+
+**Sub-wave 1 — 純新增**
+- 新增 `templates/glossary.md` / `models.md` / `rules.md` / `context-map.md` / `tech-debt.md` 雙版共 10 檔
+- 新增 `templates/events.md`（Core only）
+- 新增 `scaffolding/architecture-decisions-README.md`（Core only，per F-07 / F-16 修補 P010 baseline）
+- 新增 `<repo root>/TEMPLATE-COVERAGE.md`（含 Section anchors 欄，per F-06 Path A）
+- 新增 `<repo root>/TEMPLATE-LANGUAGE-GLOSSARY.md`（per F-11 Path A 雙版共用）
+
+**Sub-wave 2 — 既有 templates / scaffolding canonical English + anchor 注入**
+- 修改 `templates/_index.md` / `phase-spec.md` / `lightweight-spec.md` / `behavior.md` / `context-definition.md`（雙版共 10 檔）
+- 修改 `templates/aggregate-design.md`（Core only）
+- 修改 `templates/CLAUDE.md`（雙版，per F-01 Path A 全 H2/H3 英文化）
+- 修改 `scaffolding/_conventions.md`（雙版，per F-04 cascade 將「輕量修改紀錄」改為 `Lightweight Changes`）；`scaffolding/_overview.md` 雙版檢查 verify 為已英文化結構，無需修改
+- 修改 `scaffolding/Git-principles-{gitflow,trunk}.md`（雙版共 4 檔，per F-14 精化 Integration Commit labels）
+- 修改 `scaffolding/CLAUDE-md-snippet.md`（雙版，per F-01 Path A 同步全英化）
+- 注入 6 個 initial `<!-- dflow:section X -->` anchor 到對應 templates
+- 擴充 `<repo root>/TEMPLATE-LANGUAGE-GLOSSARY.md`
+
+**Sub-wave 3 — references cascade + SKILL.md**
+- 修改 `references/init-project-flow.md` / `new-feature-flow.md` / `modify-existing-flow.md` / `finish-feature-flow.md` / `drift-verification.md` / `pr-review-checklist.md` / `git-integration.md`（雙版共 14 檔）+ `ddd-modeling-guide.md`（Core only）
+- `finish-feature-flow.md` Step 5 Integration Summary labels 英文化（per F-04）
+- `drift-verification.md` 補 Anchor coexistence rule 段（per F-08）
+- `pr-review-checklist.md` section name cascade 同步（per F-03）
+- `git-integration.md` 檢查級別，加 R8b verified 註記（per F-17）
+- `ddd-modeling-guide.md` 補 context-map.md 缺檔處理（per F-13）
+- 修改 `SKILL.md`（雙版，per F-05：Templates 表 + Coverage Matrix 引用 + section name cascade）
+
+**Sub-wave 4 — lightweight-spec Implementation Tasks + task guard**
+- 修改 `templates/lightweight-spec.md`（雙版）：補 `Implementation Tasks` 段 per §7 + 雙版 layer tags
+- 修改 `references/modify-existing-flow.md`（雙版）：完善 task guard 流程（不以項目數自動升級；AI 主動詢問）
+
+**繁中版同步**：延至 Post-Review Closeout C1（依 review-workflow.md §七）
+
+**設計動機補寫**（R8b approve 階段識別並落地於 P013）：
+- §1 補 Anchor coexistence rule 段 + Anchor naming rules（namespacing only，versioning 延後到 backlog § 7）+ Design intent 段（明示 anchor 機制啟用 localized heading 的長期動機）
+- `planning/public-distribution-backlog.md` § 1 加註 P013 接管；新增 §1.1「anchor-enabled localized heading（P013 後）」候選方向
+
+**下一步**：R8b Implement Review（仿 R7 Implement Review pattern）
+
+---
+
+## 2026-04-27 — R8a Implement：PROPOSAL-012 路徑英文化（`specs/_共用/` → `specs/shared/`）
+
+**前置**：R8a Review（Cursor Claude Opus 4.7，`reviews/round-8a-report.md`）+ R8a Approve（Claude Opus 4.7，`reviews/round-8a-decisions.md`）；PROPOSAL-012 處理 10 個 finding（accept 5 / accept-with-choice 3 / reject 2 / defer 0）後 approved
+**決議文件**：`reviews/round-8a-decisions.md`
+**實作範圍**：
+
+- **Path policy 落地**：`/dflow:init-project` 產生的專案級 scaffolding 目的地由 `specs/_共用/` 改為 `specs/shared/`，符合「machine-facing paths and filenames default to English」政策（P012 §1）
+- **Skill 引用同步**：
+  - 雙版 `SKILL.md § Templates & Scaffolding` 段路徑文字更新
+  - 雙版 `references/init-project-flow.md`（Step 2 Q5、Step 3 file-list preview、Step 4 `CLAUDE.md` special handling、Step 5 results report）全部 `_共用/` → `shared/`
+  - 雙版 `scaffolding/CLAUDE-md-snippet.md`：WebForms 5 處 inline 引用 + directory tree 範例（`_overview.md` / `_conventions.md` / `Git-principles-*.md` 從 `specs/` 直接子節點移到 `specs/shared/` 之下）；Core 1 處 inline 引用
+- **`templates/CLAUDE.md` tree 同步 + 兩版 oversight 補全**（per F-04 Path B）：
+  - WebForms `templates/CLAUDE.md` directory tree 將 `_overview.md` / `_conventions.md` 從 `specs/` 直接子節點移到 `specs/shared/`
+  - Core `templates/CLAUDE.md` directory tree 順手補上漏列的 `_overview.md` / `_conventions.md`（兩版 init-project-flow 都會產生，但 Core tree 是 P010 之前就存在的 oversight）
+- **`planning/project-review-brief.md` 過時引用更新**（per F-01 Path A）：line 51 移除「P012 後預期改名」前瞻性段落；§ 3.1 / § 3.2 directory tree 註解去除前瞻性 wording；§10 P012 候選議題段加註「（已由 P012 處理）」
+- **README.md 確認**（per P012 §影響範圍 「可能只需確認」）：grep verify README.md 無 `_共用` 字面引用，無需修改
+
+**歷史條目保持原樣**（per F-10 accept）：CHANGELOG.md 既有 **2026-04-24 R7 Implement Review Fix 段下的 F-03 條目**、**2026-04-22 R7 Wave 3 段下的 P010 init-project `CLAUDE.md` 特別處理條目** 對 `specs/_共用/` 的引用是當時的事實紀錄，**不改寫**；implementer 不應對 CHANGELOG 做全域 grep-and-replace。（內容式自指；P012 §影響範圍 row 10 描述的 line 17 / line 61 行號是 R8a 修訂期、新段尚未插入時的位置，新段加入後行號位移屬正常）
+
+**實際修改檔案（10 檔；P012 §影響範圍 11 列中 `README.md` 經 verify 無 `_共用` 引用、無需修改）**：
+- `sdd-ddd-{webforms|core}-skill/SKILL.md`（2 檔）
+- `sdd-ddd-{webforms|core}-skill/references/init-project-flow.md`（2 檔，replace_all）
+- `sdd-ddd-{webforms|core}-skill/scaffolding/CLAUDE-md-snippet.md`（2 檔；WebForms 含 tree restructure）
+- `sdd-ddd-{webforms|core}-skill/templates/CLAUDE.md`（2 檔；WebForms tree restructure；Core 補檔 + tree restructure）
+- `planning/project-review-brief.md`（4 處更新）
+- `CHANGELOG.md`（本段新增）
+
+**不納入**（per P012 §不納入影響範圍）：
+- 文件內容語言（中文 heading 不英文化；由 PROPOSAL-013 處理，包含 canonical English templates + `TEMPLATE-LANGUAGE-GLOSSARY.md`）
+- 繁中版（`sdd-ddd-*-skill-tw/`）（延到 Closeout C1）
+- npm / package files（延到 `planning/public-distribution-backlog.md § 2`）
+- Dflow 文件根目錄命名（`specs/` vs `dflow/`）（延到 backlog § 6）
+
+**剩餘待辦**：R8a Implement Review（仿 R7 pattern）；R8b（PROPOSAL-013）Implement 啟動依賴本實作完成。
+
+---
+
+## 2026-04-24 — R7 Implement Review Fix：4 findings 修正
+
+**前置**：R7 Implement Review（Codex gpt-5.4 xhigh，`reviews/round-7-implement-review-report.md`）對 Wave 1-3 實施產物產出 4 個 findings（1 Critical / 2 Major / 1 Minor / 0 Question）
+**決議文件**：`reviews/round-7-implement-review-decisions.md`（Approve + Fix 合併 session）
+**修正項目**：
+
+- **F-01 (Critical, accept + 擴 scope)**：`new-phase-flow.md` Step 5 row 範例的 `_index.md` 檔案連結誤用 `{slug}` 而非 `{phase-slug}`，會產生失配連結破壞 P009 Path A-3 命名一致性。修正：雙版 `new-phase-flow.md` 第 5 欄 `{slug}` → `{phase-slug}`；scope 擴至 `templates/_index.md` 雙版 row 1 範例（同類 within-row 不一致 typo）。`new-feature-flow.md` 雙版保持不動（self-consistent 設計；首 phase 預設 phase-slug = feature-slug）
+- **F-02 (Major, accept-with-choice Path B)**：Wave 1 `git-flow-integration.md` → `git-integration.md` 的 rename 在 git 預設門檻看不出。Verify 結果：**`git mv` 實際有執行**，但同 commit 大幅內容重寫使相似度（WebForms 43%、Core 18%）低於 `-M50` 預設。採 Path B：保留 commit 歷史 + 修 CHANGELOG 自述 + 雙版 `git-integration.md` 頂部加 file history note。理由：(a) Codex review report 以 `bf5bb85` 為對照 hash，改 history 破壞可追溯性；(b) Dflow 非活躍 blame repo；(c) 誠實記錄 > 修歷史。**教訓（後記於本 CHANGELOG Wave 1 段）**：`git mv` + 大重寫需拆為兩個 commit（先純 rename、再內容改寫），未來納入 `git-integration.md`「Directory Moves Must Use git mv」段
+- **F-03 (Major, accept)**：WebForms `CLAUDE-md-snippet.md` 5 處路徑（3 個 unique pattern）引用 `specs/_overview.md` / `specs/_conventions.md` / `specs/Git-principles-*.md`，但 `init-project-flow.md` 實際產出 `specs/_共用/...`；Core 版已正確。修正：WebForms 版所有相關路徑加 `_共用/` 前綴
+- **F-04 (Minor, accept)**：雙版 `templates/CLAUDE.md` 引用 `scaffolding/Git-原則-gitflow.md`（中文化檔名），Wave 3 實際檔名為 `Git-principles-gitflow.md`（英文）。修正：兩版 `Git-原則-gitflow.md` → `Git-principles-gitflow.md`
+
+**修改檔案**（10 檔英文版）：
+- `sdd-ddd-{webforms|core}-skill/references/new-phase-flow.md`（F-01）
+- `sdd-ddd-{webforms|core}-skill/templates/_index.md`（F-01 擴 scope）
+- `CHANGELOG.md` Wave 1 段 + 新增本段（F-02）
+- `sdd-ddd-{webforms|core}-skill/references/git-integration.md`（F-02，頂部加 file history note）
+- `sdd-ddd-brownfield-skill/scaffolding/CLAUDE-md-snippet.md`（F-03，5 處路徑修正）
+- `sdd-ddd-{webforms|core}-skill/templates/CLAUDE.md`（F-04）
+
+**不變動**：
+- Wave 1 / 2 / 3 commit history（採 Path B 保留歷史）
+- 繁中版檔案（延至 Closeout C1）
+- Proposal 本身（已 approved，不修）
+- `new-feature-flow.md` 雙版（F-01 self-consistent 設計，不擴 scope）
+
+**統計**：accept 3 / accept-with-choice 1 / reject 0 / defer 0 / clarify 0 / out-of-scope 0
+
+**下一步**：**R7 全部完成**。進入 Post-R7 —— Global Sweep（選擇性）→ Closeout C1（繁中同步）→ Closeout C2（Tutorial 重建）→ 改名 + 遷移新 repo → Dflow V1 ships
+
+---
+
+## 2026-04-24 — R7 Wave 3 實施：PROPOSAL-010 `dflow init` 機制 + Scaffolding 範本集
+
+**前置**：R7 Wave 1（PROPOSAL-011 Git Flow Decoupling）+ Wave 2（PROPOSAL-009 Feature 目錄化 + 多階段規格 + 新命令）已完成（見下方兩段 CHANGELOG）；R7 Review + Approve 處理 3 個 PROPOSAL-010 相關 finding（accept-with-choice：F-04 Path B；accept：F-05、F-07）
+**Proposal**：`proposals/PROPOSAL-010-dflow-init-and-scaffolding.md`（implemented）
+**影響範圍**：
+
+**新增 Scaffolding 目錄**（雙版共 10 檔）
+- `sdd-ddd-{webforms|core}-skill/scaffolding/_overview.md` —— 系統概觀範本（WebForms 版強調漸進式 Domain 抽離 + 遷移策略；Core 版強調 Clean Architecture 四層 + ADR）
+- `sdd-ddd-{webforms|core}-skill/scaffolding/_conventions.md` —— 規格撰寫慣例範本（引用 SKILL.md 的三層 Ceremony T1/T2/T3，不重寫判準；Core 版補 Aggregate / VO / Domain Event 的 DDD 特有慣例）
+- `sdd-ddd-{webforms|core}-skill/scaffolding/Git-principles-gitflow.md` —— Git Flow 版專案 Git 規範範本；**含 Integration Commit 訊息慣例段（F-04 Path B）** 對應 `/dflow:finish-feature` 產出的 Integration Summary 的 `--no-ff` merge commit 格式；含 hotfix 24h 補 spec 時限（人對人承諾，Dflow 不追蹤）
+- `sdd-ddd-{webforms|core}-skill/scaffolding/Git-principles-trunk.md` —— Trunk-based / GitHub Flow 版；**含 Integration Commit 訊息慣例段（F-04 Path B）** 的 Squash / Rebase / Fast-forward 三種 commit 格式；不含 hotfix / release branch 規範（trunk-based 不用）
+- `sdd-ddd-{webforms|core}-skill/scaffolding/CLAUDE-md-snippet.md` —— 加入專案 `CLAUDE.md` 的片段；**沿用 P007c 的 H2 分段**（系統脈絡 / 開發流程），明示完整 Dflow 決策邏輯在 skill 本體、不重抄
+- 每份 scaffolding 檔頂部有版本註記：`<!-- Scaffolding template maintained alongside Dflow skill. See proposals/PROPOSAL-010 for origin. -->`（proposal 風險 1 緩解）
+- Scaffolding 不重疊 skill 本體：不重述 SKILL.md 的 AI 決策邏輯、不重複 references/ 的 flow 文件；專注「專案治理」
+
+**新增 Flow 文件**（雙版）
+- `sdd-ddd-{webforms|core}-skill/references/init-project-flow.md` —— `/dflow:init-project` 五步流程（Step 1 現況盤點 / Step 2 專案資訊 5 題問答 / Step 3 File-list 預覽（Phase Gate：AI 列出 create / skip 清單供使用者確認，proposal 風險 2 緩解）/ Step 4 逐檔 Write，既有檔不覆寫 / Step 5 結果報告 + 下一步建議）
+  - Step 3「必產清單」依 skill 版本分拆（**F-05 決議**）：
+    - WebForms 版必產：`specs/features/{active,completed,backlog}/`、`specs/domain/glossary.md`、`specs/migration/tech-debt.md`
+    - Core 版必產：`specs/features/{active,completed,backlog}/`、`specs/domain/glossary.md`、`specs/domain/context-map.md`、`specs/architecture/tech-debt.md`、`specs/architecture/decisions/README.md`
+  - **`behavior.md` 不在 init 階段產生**（F-05 決議）：明確註記由 `/dflow:new-feature` Step 8.3 或 P007a baseline capture 於首個 bounded context 建立時產生，不在 init 階段製造 stale placeholder
+  - `CLAUDE.md` 特別處理：已存在則不覆寫，以 `specs/_共用/CLAUDE-md-snippet.md` 形式提供片段供使用者合併；不存在則建立最小版
+
+**修改**
+- `sdd-ddd-{webforms|core}-skill/SKILL.md` —— Frontmatter Primary triggers 加入 `/dflow:init-project` + NL 二次觸發詞（"set up SDD in this project" / "adopt Dflow"）；決策樹新增 `/dflow:init-project` 節點；Slash Commands 表新增「專案級命令」子分類**置於「啟動類」之上**（proposal § 5）；Reference Files 表新增 `references/init-project-flow.md` 列；Templates 段改為「Templates & Scaffolding」，新增 Scaffolding 子段（5 檔清單 + 一句話說明 + 引用 `init-project-flow.md`）
+- `README.md`（repo 根）—— 新增「How to adopt Dflow in your project」四步流程段：步驟 1 **用中立措辭不寫死 `.claude/skills/` 路徑**（F-07 決議；以 "using the current Claude Code skill-installation mechanism" + "Refer to Claude Code's official documentation" + "installation paths and conventions change over time, so Dflow deliberately does **not** hardcode a specific directory" 表達）；新增 V2 / Dflow 分工說明子段（4-column 對照表 + 共存 note + C2 Tutorial 重建鉤子）；**未改動既有「如何使用」段**（不鋪張不改寫舊內容）
+
+**繁中版同步**：延至 Post-Review Closeout C1（依 review-workflow.md §七）；scaffolding 範本若使用者選中文語言，可選擇性新增繁中版（屬人讀內容，本 wave 先以英文版為主，繁中版選擇性）
+
+**範圍外（嚴格遵守）**：
+- 繁中版（`*-tw/`）—— 延到 Closeout C1
+- PROPOSAL-009 / PROPOSAL-011 scope 產物未被修改（`templates/_index.md` / `templates/phase-spec.md` / `references/new-phase-flow.md` / `references/finish-feature-flow.md` / `references/git-integration.md` / SKILL.md 的三層 Ceremony + `/dflow:new-phase` / `/dflow:finish-feature` 段）
+- V2 級別的完整 onboarding 文件（`SDD-AI協作開發模式介紹.md` / `使用說明.md` 等）—— 屬 Closeout C2 範圍
+- R1-R6 既有機制的核心結構 —— 只擴充，不動核
+
+**下一步**：R7 Implement 三 wave 全部完成；進入 **R7 實作品質審查**（Codex review，仿 R1-R6 pattern）
+
+---
+
+## 2026-04-24 — R7 Wave 2 實施：PROPOSAL-009 Feature 目錄化 + 多階段規格 + 新命令
+
+**前置**：R7 Wave 1（PROPOSAL-011 Git Flow Decoupling）已完成（見下段 CHANGELOG）；R7 Review + Approve 處理 4 個 finding（accept-with-choice：F-01 Path A-3 / F-02 Path C / F-04 Path B；accept：F-03）
+**Proposal**：`proposals/PROPOSAL-009-feature-directory-and-phases.md`（implemented）
+**影響範圍**：
+
+**結構 + 命名 + 範本（Sub-wave 9a）**
+- 新增：`templates/_index.md`（雙版）—— feature 級 dashboard 六段範本（Metadata / 目標與範圍 / Phase Specs / Current BR Snapshot / 輕量修改紀錄 / 接續入口）+ 選用 Follow-up Tracking 段；含 Snapshot refresh 時機註解（new-phase / phase-spec 完成 / T2 lightweight 定稿）
+- `git mv`：`templates/feature-spec.md` → `templates/phase-spec.md`（雙版）—— 在「業務規則」之後新增「Delta from prior phases」段（首 phase 免填 / phase 2+ 必填，沿用 P002/P004 ADDED/MODIFIED/REMOVED/RENAMED + 選用 UNCHANGED 格式）；範本 note 補充 phase-spec 語意 + phase 2+ 業務規則段只列新增/修改 BR
+- 修改：`templates/lightweight-spec.md`（雙版）—— 範本內容不變，補充 Template note 明確對應 T2 ceremony、實例化檔位置（feature 目錄內，命名 `lightweight-{date}-{slug}.md` / `BUG-{NUMBER}-{slug}.md`）、定稿後 AI 須更新 `_index.md` 輕量修改紀錄 + Current BR Snapshot
+- 修改：`SKILL.md`（雙版）—— Project Structure 範例改為目錄形式（`active/{SPEC-ID}-{slug}/` 含 `_index.md` / `phase-spec-*.md` / `lightweight-*.md`）；Ceremony Scaling 表重寫為三層（T1 Heavy / T2 Light / T3 Trivial）含 T3 四項判準 + Dflow 不走的底線；Templates 表加入 `_index.md` + `phase-spec.md`，移除 `feature-spec.md`；Phase 3 Spec Writing 引用更新
+
+**新命令 + Flow（Sub-wave 9b）**
+- 新增：`references/new-phase-flow.md`（雙版）—— `/dflow:new-phase` 五步流程（Step 1 Read context with active-only refusal / Step 2 Confirm scope / Step 3 Slug Confirmation / Step 4 Write phase-spec with Delta / Step 5 Refresh `_index.md` BR Snapshot + Phase Specs row + 接續入口）；嚴格只適用於 active feature，遇 completed 拒絕並導向 `/dflow:modify-existing` follow-up
+- 新增：`references/finish-feature-flow.md`（雙版）—— `/dflow:finish-feature` 六步流程（Step 1 驗證 phase-specs + `_index.md` / Step 2 flip status / Step 3 同步 BR Snapshot 到 BC 層 `rules.md` / `behavior.md`，延續 Step 8.3 / 5.3 既有機制 / Step 4 `git mv` 整目錄到 `completed/` / Step 5 emit Integration Summary（**Git-strategy-neutral**，F-04 Path B）/ Step 6 反向更新舊 feature 的 Follow-up Tracking）；明確「AI 做 git mv + add，不 commit、不 merge、不 push」（風險 5 緩解）
+- 修改：`SKILL.md`（雙版）—— Frontmatter Primary triggers 加入 `/dflow:new-phase` + `/dflow:finish-feature`；決策樹對應節點；Slash Commands 表加入「Phase commands」+「Closeout commands」兩個子分類；Reference Files 表加入兩新 flow
+- 修改：`references/new-feature-flow.md`（雙版）—— Step 3 → Step 3.5 Phase Gate 新增；Step 3.5 Slug Confirmation（中英文 slug 範例各一份）；Step 4 改為「建 feature 目錄 + `_index.md`（含初始 BR Snapshot）+ 第一份 phase-spec（首 phase Delta 註明免填）」；Step 6 branch naming 補中英文範例；Step 8.4 archival 改為整目錄 `git mv` + 推薦多 phase feature 走 `/dflow:finish-feature`
+- 修改：`references/modify-existing-flow.md`（雙版）—— Step 1 重寫為三層 Ceremony 判準表（Part A）+ feature 定位（Part B：active / completed / standalone）+ layer 識別（Part C，僅 Core 版）；新增 Step 1.5 Completed-Feature Reopen Detection（A/B/C 三選項，C 拒絕並導向 follow-up）；新增 Step 1.6 Create Follow-up Feature（新 SPEC-ID + `follow-up-of` + BR Snapshot baseline 從 `rules.md` 繼承 + 反向 Follow-up Tracking 同 commit）；Step 5.4 / 6.4 archival 改為 feature-level 不再搬單檔，整目錄交 `/dflow:finish-feature`
+
+**既有文件同步（Sub-wave 9c）**
+- 修改：`references/git-integration.md`（雙版）—— 新增完整「Directory Moves Must Use `git mv`」段（理由、6 種適用情境、commit message 提示、什麼不該做、驗證方式、CI hook 未來方向），取代 P011 留的 placeholder；Branch naming 加 Slug Language 子段（中英文 slug 都合法、Obts 實測背書、slug-shape guidance）；Gate Checks 路徑假設更新為 `active/{SPEC-ID}-{slug}/` 目錄形式（`_index.md` + 多 phase-spec），Pre-PR checklist 加入 BC 層同步 + `git mv` 驗證項
+- 修改：`references/pr-review-checklist.md`（雙版）—— Step 0 重寫為「先讀 `_index.md` 取得 feature 全貌 → 識別 PR 觸及的 phase-spec / lightweight-spec / T3 inline 哪一類 → 全部讀過」；Spec Compliance 拆為「Per-feature checks」（含 `_index.md` 完整性 + follow-up 連結驗證）+「Per-phase-spec / lightweight-spec checks」（多份逐一檢查 + Delta integrity）+「If closeout commit」（BC 同步 + `git mv` rename detection + Integration Summary）
+- 修改（輕量）：`references/drift-verification.md`（雙版）—— 新增「This command does NOT do (feature-directory aggregation — explicitly excluded)」明確段（F-03 決議：不擴張 scope 到跨 phase-spec 聚合，BR 現況聚合由 `_index.md` Snapshot 承擔）；新增「Path Assumptions (post-PROPOSAL-009)」段，明示 verify 不讀 feature 目錄；When to Run 加入「After `/dflow:finish-feature` lands」觸發點
+- 修改：`templates/CLAUDE.md`（雙版）—— 「目錄結構」段 features 子樹改為目錄形式；「開發流程」段重寫為 Ceremony 三層 + 五個命令分節（new-feature / new-phase / modify-existing / bug-fix / finish-feature），明示 follow-up 規則與 BC 同步動作；「系統脈絡」段（P007c segmentation）保持不動
+
+**繁中版同步**：延至 Post-Review Closeout C1（依 review-workflow.md §七）
+
+**範圍外（嚴格遵守）**：
+- 繁中版（`*-tw/`）—— 延到 Closeout C1
+- PROPOSAL-010 scope（`scaffolding/`、`init-project-flow.md`、`CLAUDE-md-snippet.md`、`README.md`）—— 屬 R7 Wave 3
+- P003 / P005 / P007 / P008 既有核心結構 —— 只更新引用 / 路徑，不改核心
+
+**下一步**：R7 Wave 3（PROPOSAL-010 實施）—— 本 proposal 完成後，`/dflow:init-project` 可引用本輪定義的 `_index.md` 範本與 feature 目錄結構
+
+---
+
+## 2026-04-24 — R7 Wave 1 實施：PROPOSAL-011 Git Flow Decoupling
+
+**前置**：R7 Review（Codex，2026-04-22 產出 `reviews/round-7-report.md`）+ R7 Approve（2026-04-22）處理 2 個 finding（accept-with-choice：F-04 Path B；accept：F-06）
+**Proposal**：`proposals/PROPOSAL-011-git-flow-decoupling.md`（implemented）
+**影響範圍**：
+- 重命名：`references/git-flow-integration.md` → `references/git-integration.md`（雙版，**實際執行 `git mv`**；但因同 commit 內大幅內容重寫，git 預設 rename detection（`-M50`）無法識別為 rename，詳見下方 F-02 後記 —— R7 Implement Review F-02）
+- 內容重構：`git-integration.md`（雙版）—— 移除 Git Flow 專屬段（develop/release/hotfix 分支圖、release checklist、hotfix expedited process、24h 補 spec）、保留 SDD ↔ Git 核心耦合（feature branch per feature、`git mv` 規範總則、Gate Checks、Commit Message Convention、CI/CD Future Enhancement）
+- 修改：`SKILL.md`（雙版）—— references 表檔名更新 + 描述中立化、決策樹「I'm creating a branch」節點檔名引用更新、`/dflow:bug-fix` 語意澄清（不綁分支策略，雙處：決策樹 + Slash Commands 段）
+- 修改：`drift-verification.md`(雙版)—— 移除「Before a release branch cut」觸發點；Purpose 段的「before a release」passing mention 同步中立化（當場移除 Git Flow 殘餘語句，符合 proposal § 5 指導）
+- 修改：`templates/CLAUDE.md`（雙版）—— 「Git Flow」段標題改為「Git 整合」，加註「分支策略由專案決定，Dflow 不強制」，移除 `hotfix/` / `release/` 預設分支命名與 24h 補 spec 規則，新增「若採 Git Flow 可參考 scaffolding 範本」指引
+
+**不在本輪 scope（已於 R7 Review F-06 verify 過現況無 Git Flow 字樣）**：
+- `modify-existing-flow.md`（雙版）
+- `pr-review-checklist.md`（雙版）
+
+**繁中版同步**：延至 Post-Review Closeout C1（依 review-workflow.md §七）
+
+**R7 Implement Review F-02 後記（2026-04-24）**：
+
+Codex R7 Implement Review 指出本 commit（`bf5bb85`）在 `git diff-tree --summary` 預設（`-M50`）顯示為 delete+add 而非 rename。經 verify，**實際上有執行 `git mv`**，但此 commit 同時刪除 Git Flow 專屬內容並新增大量新內容，新舊檔相似度：WebForms 版 43%、Core 版 18%，低於 git 預設 rename detection 門檻（50%）。
+
+查看 rename 軌跡的指令：
+- WebForms：`git log --follow -M30 sdd-ddd-brownfield-skill/references/git-integration.md`
+- Core：`git log --follow -M10 sdd-ddd-greenfield-skill/references/git-integration.md`
+
+**教訓**：`git mv` **不等於** git 會自動把 commit 識別為 rename。當 rename 與大幅內容改寫發生在同一 commit 時，git 依新舊檔相似度判斷；若低於 `-M50` 預設門檻，會顯示為 delete+add。
+
+**對未來大重寫的建議**（應納入 `git-integration.md` 的「Directory Moves Must Use git mv」段長期原則）：
+1. 先用獨立 commit 執行純 `git mv`（不改內容）—— 這樣 git 100% 能識別為 rename
+2. 再用後續 commit 進行內容改寫 —— rename 軌跡不受影響
+
+**本輪採 Path B（保留歷史，更新 CHANGELOG 與 `git-integration.md` 頂部 file history note）**，不 rewrite commit history。理由：(a) Codex review report 以 `bf5bb85` 為對照 hash，改 history 會失去可追溯性；(b) Dflow 為方法論 repo，`git blame` 穿 rename 的實用價值有限；(c) 誠實記錄比修歷史更具教學價值。
+
+**下一步**：R7 Wave 2（PROPOSAL-009 實施）—— 本 proposal 完成後，`git-integration.md` 基底穩定，009 可在其上擴增「Directory Moves Must Use git mv」完整段與 slug 語言段
+
+---
+
+## 2026-04-21 — Round 4 審查修正：Source of Truth 與漂移驗證（P003 + P008）
+
+**關聯 Proposal**: P003, P008
+**審查輪次**: R4
+**對應決議文件**: `reviews/round-4-decisions.md`
+
+### 修正項目
+
+- **F-01 (Major)**: `/dflow:verify` 在 SKILL.md Slash Commands 段被歸類於 Control commands（manage an active workflow），但同條目又以括號註記「standalone, no active workflow needed」自相矛盾 → 新增第三類 `Standalone commands` 小節，將 `/dflow:verify [<bc>]` 從 Control commands 移出並移除原括號註記。
+- **F-02 (Major)**: `drift-verification.md` Step 3 的 BR-ID 擷取規則將「section headings」與「body text」等值處理，違背 P008「對應情境段落」原意，會造成誤通過（body-text 提到就當 pass）與誤告警兩類雜訊 → Step 3 改為建立 primary set（scenario-bound，section headings 或 Given/When/Then 中的 BR-NNN marker）與 supplementary set（僅 body-text 提及）兩層；Step 4 三項檢查改以 primary set 為主要比對基礎，supplementary set 不能單獨滿足 forward / reverse 條件；Step 5 報告格式新增 ℹ 資訊狀態與區分失敗訊息（no scenario section for BR-NNN vs body-text only reference）。
+
+### 影響檔案
+
+- `sdd-ddd-brownfield-skill/SKILL.md`
+- `sdd-ddd-greenfield-skill/SKILL.md`
+- `sdd-ddd-brownfield-skill/references/drift-verification.md`
+- `sdd-ddd-greenfield-skill/references/drift-verification.md`
+
+### 繁中版同步狀態
+
+延後至 Post-Review Closeout 階段統一處理（見 `proposals/review-workflow.md` 第七節）。
+
+---
+
+## 2026-04-20 — Round 2 審查修正：變更描述格式（P002 + P004）
+
+**關聯 Proposal**: P002, P004
+**審查輪次**: R2
+**對應決議文件**: `reviews/round-2-decisions.md`
+
+### 修正項目
+
+- **F-01 (Major)**: 兩版 `references/new-feature-flow.md` Step 8.1 的「實作任務」驗證項未依 PROPOSAL-004 實施紀錄自述的「加入第一項」位置語放在清單首位（WebForms 版落第 5 項、Core 版落第 8 項） → 將該驗證項移到 Step 8.1 清單第 1 項，其餘項相對順序不動。
+
+### 影響檔案
+
+- `sdd-ddd-brownfield-skill/references/new-feature-flow.md`
+- `sdd-ddd-greenfield-skill/references/new-feature-flow.md`
+
+### 繁中版同步狀態
+
+延後至 Post-Review Closeout 階段統一處理（見 `proposals/review-workflow.md` 第七節）。
+
+---
+
+## 2026-04-20 — Round 1 審查修正：流程入口與透明度（P001 + P007b）
+
+**關聯 Proposal**: P001, P007b
+**審查輪次**: R1
+**對應決議文件**: `reviews/round-1-decisions.md`
+
+### 修正項目
+
+- **F-01 (Major)**: Core `SKILL.md` 的 `/dflow:status` Response Format 範例 Step 3 沿用 WebForms 版 `Domain Concept Discovery`，與 Core `references/new-feature-flow.md` 正式名稱 `Domain Modeling` 不一致 → 將範例中 Step 3 兩處（line 179 status line、line 186 in-progress checklist）改為 `Domain Modeling`，與 Core flow 檔對齊。
+
+### 影響檔案
+
+- `sdd-ddd-greenfield-skill/SKILL.md`
+
+### 繁中版同步狀態
+
+延後至 Post-Review Closeout 階段統一處理（見 `proposals/review-workflow.md` 第七節）。
+
+---
+
+## 2026-04-17 — Tutorial 同步 P001–P008：兩份 hybrid 教學文件更新
+
+**關聯 Proposal**: 無（非 Proposal，為 P001 Hybrid 教學的 P002–P008 累積同步）
+
+**目的**：`TUTORIAL_WEBFORMS_tw_hybrid.md` / `TUTORIAL_CORE_tw_hybrid.md` 兩份「情境帶領、身歷其境」的教學文件原本只反映 P001 Hybrid，P002–P008 完成後需同步，否則新人照著教學體驗不到新行為。
+
+### 新增
+
+- **WebForms 教學新增情境五：Brownfield 基準線補寫（P007a）**——以「請假單退回規則要改，但沒寫過 spec」的場景展示 B1–B4 四步（定位 → 抽取 → 結構化 → 確認），補完後接回 modify-existing-flow 用 Delta 記錄變更。
+- **兩份教學在 Scenario 1 / 2 加入四層完成 checklist narrative**：5.1 / 8.1 AI 獨立跑、5.2 / 8.2 一題一題問、5.3 / 8.3 動文件（含 behavior.md B3/B4 子步驟）、5.4 / 8.4 歸檔（P005a / P005b）。
+- **兩份教學 Scenario 2 spec 輸出加入 Phase markers 與 `實作任務` 段**（P004），Step 5 規劃後展示 `[LAYER]-[NUMBER]` 任務清單。
+- **Core 教學 Scenario 2 spec frontmatter 加入 `ddd-modeling-depth`**（P006a），narrative 解釋輕 / 中 / 重三級與 PR Review 嚴格度的對應。
+- **兩份教學 Scenario 2 結尾加入 `/dflow:verify` 執行示範**（P008），展示 drift 機械檢查回報格式。
+- **WebForms 教學 Scenario 3 / Core 教學 Scenario 4（PR Review）加入 A+C 結構對齊檢查與 DDD Depth 嚴格度調整**（P003 / P006a / P007b）。
+
+### 變更
+
+- **兩份教學的 title 與 intro**：從「P001 實作後」改為「P001–P008 實作後」，並明示本文涵蓋的所有新特性。
+- **兩份教學「原版 vs 新版」對照表**：加入 Delta 格式、A+C 結構、DDD Depth（Core 限定）、四層完成、verify、Brownfield（WebForms 限定）等新列。
+- **兩份教學指令速查表**：加入 `/dflow:verify`；其餘指令的用途欄位補上新特性標註（Phase markers、Delta、Aggregate 邊界複檢、Step 0 Spec Intent）。
+- **兩份教學 flow 圖**：Step 5 / Step 8 展開為四層子結構；Scenario 2 的 Step 4 標示含 Phase markers + 實作任務段。
+- **Core 教學 Ceremony Scaling 表新增 `DDD Modeling Depth` 欄**（P006a），行數擴展到涵蓋「新 Aggregate」「跨 / 內 Aggregate 規則變更」「Domain 層 bug 修復」等更細的情境。
+- **WebForms 教學 Ceremony Scaling 表新增 `格式` 欄**（feature-spec / Delta / Brownfield 基準線 / lightweight），與「要抽 Domain？」欄互補。
+- **WebForms 教學目錄加入情境五的連結**。
+
+### 設計判斷
+
+- **教學文件不重寫 scenario，只添加新特性敘述**：為了保留原 P001 教學的情境故事性（使用者身歷其境），採「在既有情境裡插入新特性 narrative」而非另開 P002–P008 專屬情境。例外是 Brownfield（P007a）——因它改變整個進入流程，必須獨立成一個情境。
+- **Core vs WebForms 差異保留**：DDD Modeling Depth 欄位僅 Core 教學呈現（P006a 本為 Core-only）；Brownfield 基準線補寫僅 WebForms 教學呈現（P007a 本為 WebForms-only）。
+
+### 影響檔案
+
+- `tutorial/TUTORIAL_WEBFORMS_tw_hybrid.md`
+- `tutorial/TUTORIAL_CORE_tw_hybrid.md`
+
+---
+
+## 2026-04-17 — P005b 實施：完成流程 Checklist 補完 behavior.md + Tasks 分層項（Wave B 子集）
+
+**關聯 Proposal**: `PROPOSAL-005b-completion-checklist-wave-b.md`（approved → implemented）
+
+**Wave**: B（依賴 P003 + P004，兩者已於 Wave A / Wave B 先行實施）
+
+### 新增
+
+- **X.1 AI 可獨立驗證** 加入兩項標 `*(post-X.3)*` 的 post-merge 項（兩版 new-feature-flow Step 8、WebForms modify Step 6、Core modify Step 5）：
+  - `behavior.md` 對本 spec 的每個 `BR-*` 有對應 section anchor（`/dflow:verify` 機械輸入）
+  - `behavior.md` `last-updated` 晚於 spec `created` 日期（機械 drift 防線）
+  - modify-existing 版特別提 REMOVED delta 的 anchor 刪除
+- **X.2 需開發者確認** 加入兩題：
+  - 合併進 `behavior.md` 的情境是否忠實表達預期行為（Core 版補 Aggregate 轉換 + Events）
+  - 完成後 spec 的 `實作任務` 段要不要摺疊 / 移除（團隊慣例）
+- **X.3 文件更新** 的 `behavior.md` bullet 擴充含兩個子步驟：
+  - 把 Phase 3 draft 段落（B3 中途同步）轉為正式段落
+  - 更新對應 `rules.md` anchor 的 `last-updated` 日期（B4）
+- **X.3 新增 `behavior.md` 草稿清理 bullet**：中途放棄的 spec 要保留 `## 提案中變更` 段歷史或明確 REMOVE
+
+### 變更
+
+- **兩版 SKILL.md `Completion Checklist Execution` / `完成流程 Checklist 的執行方式` 子節**：
+  - AI-independent 段落拆成「合併前」/「X.3 之後」兩類時機說明，讓 post-merge 項目的執行順序清晰。
+  - Developer-confirmation 段落加入 P005b 的兩題。
+  - 文件更新段落加入 `behavior.md` 合併的兩個子步驟（B3 / B4）與草稿清理指引。
+
+### 設計判斷
+
+- **8.1 放 post-merge 項還是另闢新段？** 選擇放回 8.1 用 `*(post-X.3)*` 標籤區分，避免 checklist 多一層結構。SKILL.md 描述段明確區分兩類時機。
+- **B3 / B4 的前瞻性**：P003 實作時採精簡版，尚未正式建立「Phase 3 draft 段落」與「rules.md anchor last-updated」的機械結構。本次 checklist 引導語為前瞻性——後續補強這些結構時，文字無需再改。
+
+### 影響檔案
+
+EN（6 個）：兩版 new-feature-flow.md、兩版 modify-existing-flow.md、兩版 SKILL.md
+TW（6 個）：兩版 new-feature-flow_tw.md、兩版 modify-existing-flow_tw.md、兩版 SKILL_tw.md
+
+另：`proposals/PROPOSAL-005b-completion-checklist-wave-b.md`（status + 實施紀錄）
+
+---
+
+## 2026-04-17 — P008 實施：Drift Verification 指令（/dflow:verify）
+
+**關聯 Proposal**: `PROPOSAL-008-drift-verification.md`（approved → implemented）
+
+**前置依賴**: P003（A+C 結構），同日提前實施後解除封鎖。
+
+### 新增
+
+- **`references/drift-verification.md`（兩版）**：5 步驟驗證流程——找檔案 → 擷取 rules.md BR-ID → 擷取 behavior.md BR-ID → 交叉比對 → 回報。三項機械檢查：正向（rules→behavior）、anchor 有效性、反向（behavior→rules）。Core 版額外含 events.md 交叉引用警告。語意層明確排除（Wave D）。
+- **`drift-verification_tw.md`（兩版）**：繁體中文翻譯。
+
+### 變更
+
+- **兩版 SKILL.md**：`/dflow:verify [<bc>]` 加入 description frontmatter、決策樹、Slash Commands 段、Reference Files 表格
+- **兩版 SKILL_tw.md**：決策樹、Slash 指令段、參考文件表格同步新增 `/dflow:verify`
+
+### 影響檔案
+
+EN（4 個）：兩版 references/drift-verification.md（新增）、兩版 SKILL.md
+TW（4 個）：兩版 drift-verification_tw.md（新增）、兩版 SKILL_tw.md
+
+---
+
+## 2026-04-17 — P003 實施：系統現狀 Source of Truth（behavior.md）
+
+**關聯 Proposal**: `PROPOSAL-003-system-source-of-truth.md`（draft → implemented）
+
+**原排程**: Wave B（等 Checkpoint A）。提前實施理由：用戶實際使用 OpenSpec 後確認「一覽行為全貌」是核心需求，不需等團隊回饋。
+
+### 新增
+
+- **`templates/behavior.md`（兩版）**：行為規格彙整模板。按功能區域組織、每個 BR-ID 一個 section 含 Given/When/Then。Core 版額外強調 Aggregate 狀態轉換和 Domain Events。
+- **「Behavior Source of Truth」段（兩版 SKILL.md + SKILL_tw.md）**：說明 A+C 結構——`rules.md`（宣告式索引）+ `behavior.md`（情境式內容）——的分工與維護方式。對比 OpenSpec 的 `specs/` 目錄角色。
+- **完成流程文件更新段加入 behavior.md**（四個 EN flow + 四個 TW flow）：new-feature-flow 完成時合併 spec 情境；modify-existing-flow 完成時依 Delta 結果更新（合併最終狀態，不保留 Delta 標記）。
+
+### 變更
+
+- **兩版 SKILL.md Project Structure**：`rules.md` 註解改為「BR-ID index」，新增 `behavior.md` 行
+- **兩版 `templates/context-definition.md`**：關鍵業務規則段提及 rules.md + behavior.md 分工
+- **兩版 SKILL.md Templates 表格**：新增 `behavior.md` 條目
+
+### 影響檔案
+
+EN（12 個）：兩版 templates/behavior.md（新增）、兩版 SKILL.md、四個 flow 檔案、兩版 templates/context-definition.md
+
+TW（6 個）：兩版 SKILL_tw.md、四個 flow TW 檔案
+
+---
+
+## 2026-04-17 — Wave C 實施：P006a / P007a / P007c
+
+**關聯 Proposal**: `PROPOSAL-006a-ddd-depth-column.md`、`PROPOSAL-007a-brownfield-reverse-documentation.md`、`PROPOSAL-007c-claude-md-segmentation.md`（全部 approved → implemented）
+
+**Wave**: C（獨立微調，無前置依賴）
+
+**備註**: P008（`/dflow:verify` drift 驗證）排程為 Wave C 但依賴 P003（A+C 結構，Wave B），本次未實施。
+
+### P006a — Ceremony Scaling 加入 DDD 建模深度欄
+
+- Core 版 `SKILL.md` Ceremony Scaling 表格欄位 `DDD Modeling` → `DDD Modeling Depth`
+- 四級深度定義：Full（Aggregate 設計 + Events + Context Map）/ Standard（確認歸屬 + 更新 models/rules）/ Lightweight（確認正確的層）/ Skip
+- 「New feature」拆為「New Aggregate / BC」（Full）和「New feature (within existing BC)」（Standard）
+- 繁中版同步更新
+
+### P007a — Brownfield 系統性逆向文件化
+
+- WebForms 版 `modify-existing-flow.md` Step 2 新增「Systematic Baseline Capture」子段
+- 5 步機會主義掃描指引：讀相關 Code-Behind → 提取業務規則 → 識別領域概念 → 檢查重複邏輯 → 記錄到 domain docs + tech-debt
+- 範圍限定在被修改功能和鄰近頁面，不做完整 codebase 掃描
+- 繁中版同步更新
+
+### P007c — CLAUDE.md 標題分段強化
+
+- 兩版 `templates/CLAUDE.md` 重構為兩大區塊：
+  - `## 系統脈絡（What is this system?）` — 背景、架構、目錄結構
+  - `## 開發流程（How do we work?）` — SDD 流程、Git Flow、Domain 規範、AI 協作
+- 模板為 AI 使用（英文），無需繁中同步
+
+### 影響檔案
+
+- `sdd-ddd-greenfield-skill/SKILL.md`（P006a）
+- `sdd-ddd-greenfield-skill-tw/SKILL_tw.md`（P006a 繁中）
+- `sdd-ddd-brownfield-skill/references/modify-existing-flow.md`（P007a）
+- `sdd-ddd-brownfield-skill-tw/modify-existing-flow_tw.md`（P007a 繁中）
+- `sdd-ddd-brownfield-skill/templates/CLAUDE.md`（P007c）
+- `sdd-ddd-greenfield-skill/templates/CLAUDE.md`（P007c）
+- `proposals/PROPOSAL-006a-ddd-depth-column.md`（status + 實施紀錄）
+- `proposals/PROPOSAL-007a-brownfield-reverse-documentation.md`（status + 實施紀錄）
+- `proposals/PROPOSAL-007c-claude-md-segmentation.md`（status + 實施紀錄）
+
+---
+
+## 2026-04-17 — 繁體中文版同步 Wave A 全部變更（P001 / P002 / P004 / P005a / P007b）
+
+**關聯 Proposal**: Wave A 全部（P001、P002、P004、P005a、P007b）
+
+### 同步內容
+
+將 Wave A 實施的所有英文版變更同步到繁體中文版（`sdd-ddd-brownfield-skill-tw/` 和 `sdd-ddd-greenfield-skill-tw/`），包括：
+
+- **P001**：決策樹改為雙軌（/dflow: 指令 + NL 安全網）；新增完整「工作流程透明度」章節（三層透明度、Phase Gate 位置、確認訊號、/dflow:status 格式）
+- **P002**：modify-existing-flow 的 Step 2 改用 Delta 格式（ADDED / MODIFIED / REMOVED / RENAMED + 可選 UNCHANGED）
+- **P004**：SKILL 引導問題加 Phase 標記說明；new-feature-flow / modify-existing-flow 加「產生實作任務清單」子段
+- **P005a**：new-feature-flow Step 8 / modify-existing-flow 最終 Step 改為四段分層 Completion Checklist（X.1 AI 驗證 / X.2 開發者確認 / X.3 文件更新 / X.4 歸檔）；SKILL 加「完成流程 Checklist 的執行方式」子段
+- **P007b**：pr-review-checklist 開頭加 Step 0（理解變更意圖）
+- **所有 flow 檔案**加 Phase Gate / step-internal 轉換標記
+
+### 影響檔案（8 個）
+
+- `sdd-ddd-brownfield-skill-tw/SKILL_tw.md`
+- `sdd-ddd-brownfield-skill-tw/new-feature-flow_tw.md`
+- `sdd-ddd-brownfield-skill-tw/modify-existing-flow_tw.md`
+- `sdd-ddd-brownfield-skill-tw/pr-review-checklist_tw.md`
+- `sdd-ddd-greenfield-skill-tw/SKILL_tw.md`
+- `sdd-ddd-greenfield-skill-tw/new-feature-flow_tw.md`
+- `sdd-ddd-greenfield-skill-tw/modify-existing-flow_tw.md`
+- `sdd-ddd-greenfield-skill-tw/pr-review-checklist_tw.md`
+
+---
+
+## 2026-04-16 — P007b 實施：PR Review Step 0（Spec Intent）
+
+**關聯 Proposal**: `PROPOSAL-007b-pr-review-spec-intent.md`（approved → implemented）
+
+**Wave**: A（D1 優先級從 Wave C 提前至 Wave A，理由：完成 SDD 回饋迴路）
+
+### 新增
+
+- **PR Review Step 0**（兩版 pr-review-checklist.md 開頭）：`/dflow:pr-review` 進入時第一步。四項 checkbox：讀 spec / 讀 Delta（含 RENAMED、可選 UNCHANGED）/ 用一句話陳述 PR 意圖 / 然後才進入 code review。
+- **無 spec 的引導話術**：要求 PR author 提供 spec 位置或先開 lightweight-spec。
+- **Core 版額外檢查**：若 `behavior.md` 存在，交叉確認 Delta 是否已反映（B3 中途同步 review 閘門）；特別留意 Delta 中的 Aggregate 狀態轉換與 Domain Events。
+
+### 為什麼 D1 提前
+
+原排程放 Wave C 是工作量導向判斷失誤。真正價值在於：沒有 Step 0，reviewer 不會先看 spec，前面所有規格工作（Delta、behavior.md、tasks）就失去驗證機制。SDD 流程的回饋迴路必須由 Step 0 收合。
+
+### 影響檔案
+
+- `sdd-ddd-brownfield-skill/references/pr-review-checklist.md`
+- `sdd-ddd-greenfield-skill/references/pr-review-checklist.md`
+- `proposals/PROPOSAL-007b-pr-review-spec-intent.md`（status + 實施紀錄）
+
+### 繁中版同步狀態
+
+- 已同步（2026-04-17）— 見「繁體中文版同步 Wave A 全部變更」entry。
+
+---
+
+## 2026-04-16 — P005a 實施：完成流程分層 Checklist（Wave A 子集）
+
+**關聯 Proposal**: `PROPOSAL-005a-completion-checklist-wave-a.md`（approved → implemented）；`PROPOSAL-005-completion-flow.md` 同步改為 `superseded`，新增 `PROPOSAL-005b-completion-checklist-wave-b.md`（approved，Wave B，暫不實施）。
+
+**Wave**: A
+
+### 拆分決定
+
+原 P005 依賴 P003 / P004，整體排到 Wave B。評估後發現其中「Domain 純淨度、Given/When/Then 覆蓋、文件更新、歸檔」這些項目不依賴 P003/P004，先行實施可建立驗證文化。拆為 P005a（Wave A，本次實施）+ P005b（Wave B，等 P003/P004 穩定後補上 behavior.md 轉正式 + Tasks 勾選整併）。
+
+### 新增
+
+- **四段分層 Completion Checklist**（兩版 new-feature-flow.md Step 8、modify-existing-flow WebForms Step 6 / Core Step 5）：
+  - `X.1 AI-independent verification`：BR/EC/Given-When-Then 覆蓋、Domain 純淨度（無 `System.Web` / 無外部 NuGet）、Tasks 狀態；Core 版補 Aggregate invariants、Domain Events raised、EF Fluent API only。
+  - `X.2 Developer-confirmation verification`：AI 一次問一項，不 dump；涵蓋意圖一致性、Aggregate boundary、Domain Event placements、tech-debt 補漏。
+  - `X.3 Documentation updates`：glossary / models / rules / events / context-map / tech-debt。
+  - `X.4 Archival`：`status` → `completed`、檔案移到 `completed/`。
+- **Completion Checklist Execution 子節**（兩版 SKILL.md）：明定 Phase Gate 是唯一觸發點、執行順序嚴格為 X.1 → X.4、AI-independent 一次報完 ✓/✗、Developer-confirmation 一次問一項；若開發者跳過 Phase Gate 直接 commit，auto-trigger 安全網須攔截並引導跑 checklist。
+
+### 重要簡化
+
+取消原提案的「自然語言完成信號偵測」。直接用 P001 `/dflow:next` Phase Gate 作為觸發點，理由：精準、開發者控制感強、免維護信號詞表。
+
+### 新增 Proposal 檔
+
+- `PROPOSAL-005a-completion-checklist-wave-a.md`（本次實施）
+- `PROPOSAL-005b-completion-checklist-wave-b.md`（Wave B，尚未實施）
+- `PROPOSAL-005-completion-flow.md` 狀態改為 `superseded`，`superseded-by` 指向 P005a + P005b
+
+### 影響檔案
+
+- `sdd-ddd-brownfield-skill/references/new-feature-flow.md`
+- `sdd-ddd-greenfield-skill/references/new-feature-flow.md`
+- `sdd-ddd-brownfield-skill/references/modify-existing-flow.md`
+- `sdd-ddd-greenfield-skill/references/modify-existing-flow.md`
+- `sdd-ddd-brownfield-skill/SKILL.md`
+- `sdd-ddd-greenfield-skill/SKILL.md`
+- `proposals/PROPOSAL-005-completion-flow.md`
+- `proposals/PROPOSAL-005a-completion-checklist-wave-a.md`（新檔）
+- `proposals/PROPOSAL-005b-completion-checklist-wave-b.md`（新檔）
+
+### 繁中版同步狀態
+
+- 已同步（2026-04-17）— 見「繁體中文版同步 Wave A 全部變更」entry。
+
+---
+
+## 2026-04-16 — P002 實施：Delta Spec 變更描述格式（含 RENAMED + UNCHANGED）
+
+**關聯 Proposal**: `PROPOSAL-002-delta-spec-format.md`（approved → implemented）
+
+**Wave**: A
+
+### 新增
+
+- **Delta Spec 格式**（兩版 modify-existing-flow.md Step 2）：ADDED / MODIFIED / REMOVED / RENAMED 四種變更操作 + 可選的 UNCHANGED 段落，取代原本自由文字的 Current Behavior / Changed Behavior 對照。
+  - `MODIFIED` 必填「原本 / 改為」對照。
+  - `RENAMED`（B1 追加）：brownfield 常見的業務概念改名（「簽核」→「審批」等）。
+  - `UNCHANGED`（B2 追加）：建議但非必填；regression 風險高時主動填。
+  - Core 版的 Delta 格式包含 Aggregate 狀態轉換與 Domain Events，讓 `/dflow:pr-review` Step 0 能讀出語義。
+- **lightweight-spec Delta 精簡版**（兩版）：原「現有行為 / 預期行為」改為單一 MODIFIED 條目，保留「原本 / 改為 / 原因」結構；若需要其他 delta 類型指引開發者參考 modify-existing-flow.md。
+
+### 重要澄清（寫入 PROPOSAL-002）
+
+Delta 標記**僅用於變更 spec**，不累積到 P003 的 `behavior.md`（consolidated source of truth）。behavior.md 讀取 delta 後 merge 成當前真相，不保留歷史軌跡（git 已覆蓋）。
+
+### 影響檔案
+
+- `sdd-ddd-brownfield-skill/references/modify-existing-flow.md`
+- `sdd-ddd-greenfield-skill/references/modify-existing-flow.md`
+- `sdd-ddd-brownfield-skill/templates/lightweight-spec.md`
+- `sdd-ddd-greenfield-skill/templates/lightweight-spec.md`
+- `proposals/PROPOSAL-002-delta-spec-format.md`（status + B1/B2 追加 + 評估紀錄）
+
+### 繁中版同步狀態
+
+- 已同步（2026-04-17）— 見「繁體中文版同步 Wave A 全部變更」entry。
+
+---
+
+## 2026-04-16 — P004 實施：Spec 模板 Phase 標記 + 實作任務清單（精簡版）
+
+**關聯 Proposal**: `PROPOSAL-004-spec-template-restructure.md`（approved → implemented，精簡版）
+
+**Wave**: A
+
+### 精簡化決定
+
+原方案要求將 feature-spec 模板重構為顯式五段式章節。評估後採精簡版：保留既有段落結構不動，改用 HTML comment phase 標記 + 新增實作任務段落。理由：既有 spec 不需要破壞性遷移；Phase 歸屬可以機讀但對人不干擾。
+
+### 新增
+
+- **HTML comment phase 標記**（兩版 feature-spec.md）：每個段落 heading 行尾加 `<!-- 填寫時機：Phase N -->`，對應 SKILL.md § Guiding Questions by Phase。模板頂部加 template note 區塊說明用途。
+- **實作任務段落**（兩版 feature-spec.md）：
+  - WebForms 分類 `DOMAIN / PAGE / DATA / TEST`
+  - Core 分類對應 Clean Architecture `DOMAIN / APP / INFRA / API / TEST`，標註建議產出順序 `DOMAIN → APP → INFRA → API`
+- **Tasks 產生指引**（new-feature-flow Step 5、modify-existing-flow WebForms Step 4 / Core Step 3）：規定 AI 在計畫定稿後把 task 清單寫入 spec，提供格式與範例。
+- **Tasks 驗證項**（new-feature-flow Step 8、modify-existing-flow WebForms Step 6 / Core Step 5）：完成時驗證實作任務段全部勾選，或未勾選項明確標註 follow-up。
+
+### 變更
+
+- **SKILL.md § Guiding Questions by Phase**（兩版）：段首補上 HTML comment 標記約定說明，指向「實作任務」段由哪個 flow step 產生。
+- modify-existing-flow 中的 tasks 產生限定為「使用完整 feature-spec 時才產生」，bug-fix lightweight-spec 模式跳過。
+
+### 影響檔案
+
+- `sdd-ddd-brownfield-skill/templates/feature-spec.md`
+- `sdd-ddd-greenfield-skill/templates/feature-spec.md`
+- `sdd-ddd-brownfield-skill/references/new-feature-flow.md`
+- `sdd-ddd-greenfield-skill/references/new-feature-flow.md`
+- `sdd-ddd-brownfield-skill/references/modify-existing-flow.md`
+- `sdd-ddd-greenfield-skill/references/modify-existing-flow.md`
+- `sdd-ddd-brownfield-skill/SKILL.md`
+- `sdd-ddd-greenfield-skill/SKILL.md`
+
+### 繁中版同步狀態
+
+- 已同步（2026-04-17）— 見「繁體中文版同步 Wave A 全部變更」entry。
+
+---
+
+## 2026-04-16 — P001 實施：指令化入口 + 流程透明化（Hybrid）
+
+**關聯 Proposal**: `PROPOSAL-001-workflow-transparency.md`（approved → implemented）
+
+**Wave**: A
+
+### 新增
+
+- **`/dflow:` slash command 族**：`/dflow:new-feature`、`/dflow:modify-existing`、`/dflow:bug-fix`、`/dflow:pr-review`、`/dflow:status`、`/dflow:next`、`/dflow:cancel`
+- **Workflow Transparency 章節**（兩版 SKILL.md）：涵蓋 Slash Commands 定義、Auto-Trigger Safety Net 規則、Three-Tier Transparency（Flow entry / Phase gate / Step-internal）、Confirmation Signals（NL ↔ command 等價）、`/dflow:status` 回應格式
+- **Phase Gate markers**（兩版 new-feature-flow.md + modify-existing-flow.md）：每個 step 邊界標註為 Phase Gate 或 step-internal，Phase Gate 處有具體發話內容 + wait for confirmation 規則
+
+### 變更
+
+- **description 欄位**（兩版 SKILL.md）：從單純 NL 觸發改為 PRIMARY（/dflow: commands）+ SECONDARY（NL 安全網，判斷後等確認、不自動前進）
+- **Decision Tree**（兩版 SKILL.md）：重寫為「/dflow: 命令 → 直接路由；NL → 判斷後等確認」雙軌結構
+- **modify-existing-flow 的 `/dflow:bug-fix` 說明**：兩版在頂部明確寫出 bug-fix 模式下的 ceremony 調整（用 lightweight-spec、預設 defer 抽離/DDD 影響判斷）
+
+### 實施期發現的結構差異
+
+- Core 版 modify-existing-flow 實際為 5 步（非原 P001 假設的 6 步），Phase Gate 位置對應調整為 2→3 / 3→4 / 4→5。兩版 SKILL.md 的 Workflow Transparency 段落分別列出各自的 Phase Gate 位置。
+
+### 影響檔案
+
+- `sdd-ddd-brownfield-skill/SKILL.md`
+- `sdd-ddd-brownfield-skill/references/new-feature-flow.md`
+- `sdd-ddd-brownfield-skill/references/modify-existing-flow.md`
+- `sdd-ddd-greenfield-skill/SKILL.md`
+- `sdd-ddd-greenfield-skill/references/new-feature-flow.md`
+- `sdd-ddd-greenfield-skill/references/modify-existing-flow.md`
+
+### 繁中版同步狀態
+
+- 已同步（2026-04-17）— 見「繁體中文版同步 Wave A 全部變更」entry。