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

| 項目 | 內容 |
|------|------|
| 緣由 | 原中控 session context 滿，交棒。你的角色**不是寫 spec**，是總指揮：發包給執行 session、盤進度、抽查退件、解 blocker、管 gate 與最終收尾 |
| Branch | `main`（全程，不切）｜**所有 commit 未 push**，push 永遠等 user 明示 |
| 建議模型 | Opus（要做品質抽查與退件判斷） |

## 🧭 原始需求 / WHY（先懂再接）

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 的「品質紅線」段=退件標準）

## §0 讀序

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 六輪打磨的合格樣貌）

## §1 交棒當下戰況（2026-07-05 傍晚）

**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/` 覆蓋同路徑

## §2 前段教訓（別重蹈）

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 動靜，不是等通知

## §3 你的常規動作（中控迴圈）

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、等明令

## §4 立即待辦（接手先做）

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. 報表群完成時抽查一頁

## §5 發包 prompt 模板（連續作業版）

```
改為連續作業模式，照 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）
```

## §6 Pre-flight（必跑）

```bash
cd ~/Projects/Billows/Audit-Manager/compliance-manager-be
git branch --show-current   # main
git log --oneline -5        # 應見 FR-047 量產 commits
python3 scripts/deliverables/render_html.py "docs/specs/v1.8.0" | tail -3   # 全 ✅
grep -c '✅' docs/features/FR-047-2607-feature-spec-handbook/tracker.md      # ≥40
```

## §7 未完成的舊帳（等 user 下令才做）

原中控 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 說「收尾」才動**

## §8 不在 scope（別順手做）

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

## §9 給 fresh session 的超短 prompt

```
請讀 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 中控迴圈。
```