feat: BDD Contract

README.md

@@ -194,6 +194,7 @@ node packages/html-transform/src/cli.js scan
 .ht/spec/{page}.spec.json
 .ht/spec/{page}.validation.json
 .ht/spec/{page}.ui-contract.md
+.ht/spec/{page}.bdd.md
 ```
 
 `.ht/api-catalog.json` 是跨頁面的 backend API catalog，來源是 `backendDocs` 目錄下的 markdown 文件。它會包含：
@@ -210,8 +211,11 @@ node packages/html-transform/src/cli.js scan
 - `prototypeGuide`：該 prototype 對應的人工 guide、舊 JSP/PB、target view 與 checklist。
 - `prototypeGuide.flowRefs`：從 guide 的 legacy flow code block 比對出的相關流程節點，包含 menu、task、nodeType、JSP、PB、動作與原始流程行。
 - `maintenanceContract`：頁面型態、capabilities、data model、row actions、business rules 與 warnings。
+- `bddContract`：以頁面 evidence 產生的 Gherkin 草稿、scenario evidence trace 與人工 review warnings。
 - `regions`：目前仍保留，目的是相容既有資料形狀；不要把它視為 Stage 2 decomposition。
 
+`.bdd.md` 是 BDD 起始模版，會依 `pageKind` 產生 auth、query、maintenance、application、print 或 generic scenario。每個 scenario 會保留欄位、actions、tables、API endpoints、prototype checklist 與 legacy flow refs，供人工 review 後再轉成可執行測試。若 scan 看見錯誤流程、必填驗證、狀態限制、API error format 或尚未被 scenario 使用的 checklist/action/API，會列入 `candidateScenarios` 或 `uncoveredEvidence`，避免 evidence 被靜默漏掉。
+
 `.ht/app-map.json` 是跨頁面的應用結構推論。通用 prompt 應先讀它，再決定每個 prototype 是 `auth`、`legacy-shell-reference`、`feature-page` 或其他角色。MVP 固定策略是 template layout/style 優先，prototype 只提供內容與功能證據。
 
 route 也會包含 implementation hints，例如：