文件體系總指揮（中控）交接 — 2026-07-05

user 要把 Guidant AI 的文件體系整個現代化，兩條產品線同時進行：

1. FR-046 顧問交付文件（docs/交付文件/v1.8.0/）：七份正式 Word（GAI-SD-01~07：架構/API 563 endpoints/DB 161 表/安全/jedi-*/授權/功能規格 29 UC），給外部顧問做架構評估。Markdown 內容源 + render_docx.py（Direction A 海軍藍設計，user 驗收過）
2. FR-047 功能 SPEC 手冊（docs/specs/v1.8.0/）：給新手全端工程師的內部手冊。一頁 FE route = 一份 13 節 spec（UC 流程圖/權限矩陣 FE↔︎BE 對照/前後端檔案地圖/API/DB/已知坑），md 為本體 → render_html.py 產文件站（已部署 POC nginx）
3. 兩個配套政策已生效：①docs/changelog/ 停止新增，功能變更=更新頁面 spec（CLAUDE.md 已改，SOP=writing-feature-specs skill）②UI 截圖一律亮色模式

冷接自檢 3 問：①為什麼 spec 事實只能來自 code/dump 不能信探勘摘要？（pilot 抓到 4 個 schema 寫錯，dump 是唯一真相）②執行 session 的「完成」定義？（build ✅+掃描 0+顯式 add commit+tracker 更新）③你抽查什麼？（量產 prompt 的「品質紅線」段=退件標準）

1. docs/features/FR-047-2607-feature-spec-handbook/tracker.md（主戰情板，所有頁面狀態）
2. docs/features/FR-046-2607-client-delivery-docs/tracker.md（顧問文件線狀態）
3. .claude/skills/writing-feature-specs/（執行者的 SOP，抽查時的依據）
4. handoff/2026-07-05-mass-production-prompt.md（量產發包 prompt 模板 + 品質紅線）
5. 範本：docs/specs/v1.8.0/project-management/project-planning.md（user 六輪打磨的合格樣貌）

FR-047 量產：40/63 ✅（63%）

• ✅ 全數完成：專案管理、稽核執行、合規框架與 SSP、證據管理、問卷、協作（六群）
• 🚧 報表與儀表板：Lane A session 活著在跑（_overview ✅ + 2 頁進行中），跑完會接認證群（⬜3 頁）
• ⬜ 系統管理群（_overview+15 頁+5🔍）+ 背景服務 spec 無人接手——Lane B session context 滿，中繼交接在 commit 45336472（handoff/ 下找檔）。這是你第一優先要發的包
• 📸 截圖 session 連續模式運作中（已 10 張 PNG，規劃頁 §5 已嵌入；追著 ✅ 頁面補圖）

FR-046 顧問文件：Phase 3 卡 user gate

• Task 11 對帳 ✅ 全綠（4449ac8e：563=563/161=161/依賴全對/敏感 0）→ 🛑 等 user 回「對帳 OK」才跑 Task 12 一致性 review + Task 13 build 七份 docx → user 最終驗收 → 才 commit docx
• docx 檔案目前 untracked 留 working tree，這是刻意的

部署：HTML 手冊站已上 POC https://192.168.50.189/docs/specs/v1.8.0/（nginx location /docs/ + index README.html）。更新流程=重跑 render_html.py 後 rsync html/ 覆蓋同路徑

1. 執行 session 憑探勘摘要寫 schema 會錯——退件標準裡有「§9 沒對 db_schema.json」
2. tracker 是多 session 共用檔，改前重讀（曾發生 file-modified 撞針）
3. working tree 常駐他人 WIP 與 untracked（docx、ddd-layer-audit、img/）——顯式 add、禁 -am，commit 前看 git diff --cached --name-status
4. 背景 Explore agent 曾被使用者中斷波及而 silent 死掉——發包後定期看 tracker commit 動靜，不是等通知

1. 盤進度：git log --oneline --since="2 hours ago" + tracker 統計（頁尾統計表執行者會更新）
2. 發包：照 mass-production prompt 模板（連續作業模式版本見 §5），lane 按功能群切避免相撞
3. 抽查：每群完成後抽 1 頁對品質紅線（§1.1 是否按 UI 盤點、schema 對 dump、UC 圖、build 過）；不合格退件重做
4. 解 🔍：執行者驗存廢後會回報，仲裁除名或補寫
5. Gate 管理：FR-046 的 user gate、量產全完成後的總驗收，都提醒 user、等明令

1. 發 Lane B 續跑包（系統管理 18 項）：新 session（Opus）貼「請讀 commit 45336472 的中繼交接文件，接手 Lane B 連續作業到清空」
2. 提醒 user 去 FR-046 session 回「對帳 OK 繼續」（或由你接管 FR-046 Task 12/13：dispatch 一致性 reviewer + build）
3. 報表群完成時抽查一頁

改為連續作業模式，照 lane 順序把頁面全部做完，不逐批停：
Lane：<功能群清單>
規則：1) 每頁照 writing-feature-specs skill 8 步；每頁獨立 commit + 立即更新 tracker（改前重讀）
2) tracker 標 Sonnet 的頁可派 Sonnet subagent 寫、你抽品質紅線後 commit；Opus 頁自己寫
3) 每完成一群回報一句話後繼續 4) context 快滿照 closing-and-handoff 寫中繼交接停下
5) 不切 branch、不 push、禁 -am；§5 截圖留佔位（截圖另有專責 session）

原中控 session 的收尾被 user 暫停在「對話歸檔」步，欠：

• 對話歸檔：session id aeb9bd69 的 JSONL → docs/conversation-history/2026-07-05/client-docs-and-spec-handbook/（命令：python3 scripts/extract_claude_sessions.py --date 2026-07-05 --topic client-docs-and-spec-handbook --sessions aeb9bd69 --auto --ts-prefix；commit 前必 redact——dump 內含測試密碼明文，掃 Billows@ 複驗 =0）
• arc SUMMARY（FR-046 Phase1 + FR-047 全程）、memory 條目（文件體系座標）、Notion 任務
• 這些照收尾鐵則等 user 說「收尾」才動

• 不自己寫頁面 spec（你是中控；真要救火先告知 user）
• 不 push、不發 jedi-*、不動 FR-046 renderer 與已驗收內容
• 交付文件總藍圖（FR-046 tracker 頂部）的 🔴 待排程項（部署/維運/測試文件）——等 user 開新一批才立案

請讀 docs/features/FR-047-2607-feature-spec-handbook/handoff/2026-07-05-orchestrator-handoff.md，
接手文件體系中控角色：先完成冷接自檢與 §6 pre-flight，
然後執行 §4 立即待辦（發 Lane B 續跑包、處理 FR-046 gate），進入 §3 中控迴圈。