FR-170 · 需求索引 · 本頁由 build 掃資料夾生成
Agent 從主系統的手腳變成第二個宿主，程式要有自己的架構與守衛。
evidence-agent（定案改名 guidant-agent）21,000 行程式平鋪在一層、36 支檔各寫 SQL、27 處全域狀態、與主系統重複實作密碼政策、LDAP、session、事件碼。本案把它收成七個模組（模組在外、層在內），先解掉 jedi-common 版本斷層讓 Agent 能裝 kernel 庫，再搭宿主殼與六支守衛測試，之後新需求有地方放、功能可以在兩個宿主之間搬。
| 要知道 | 看 |
|---|---|
| 為什麼要做、考慮過什麼、為什麼不照抄主系統 | docs/analysis/2026-10-29-agent-architecture-direction.md |
| 改完長什麼樣、45 支檔各去哪、依賴規則 | architecture.html |
| 定案、拆卡、驗收、風險 | design.md |
| 拆卡底表（Notion 卡從這裡產） | P0 handoff/cards.py、P1 cards_p1.py、P2 cards_p2.py、P3 cards_p3.py |
| 無人值守派工與合回主線踩到什麼 | docs/analysis/2026-10-31-fr170-unattended-workshop-and-merge-lessons.md |
| 終局結構與守衛（機器可讀的憲章） | Agent repo docs/ARCHITECTURE.md、test/test_module_boundaries.py |
| 接手現況與下一步 | handoff/FR-170-STATE.md；沿革 handoff/FR-170-LOG.md |
P0～P3 全部完成並合回主線（2026-10-31）。 Agent 的 core/、api/、di_containers/ 已刪，八個模組在 guidant_agent/；守衛白名單（跨模組 import、模組層全域、模組內層級方向）歸零；對外行為不變（主控台與資料面 49 條路由、心跳欄位與重構前相同，全量 2014 綠）。主系統與 Agent 都已接 jedi-agent-protocol 0.1.0。Agent 1.4.7 是第一個新架構包。
母卡：P0 CM-3232（17 張）、P1～P3 CM-3324（16 張，單一工作坊批 12～23 無人值守跑完）。
未做、等決策者：P4（心跳回應 24 鍵裡指令類改直推 8443、設定類帶版本號；要改主系統，暫緩）；sonarqube.py、inspec.py 兩支千行 connector 拆分；主系統與 Agent 的升級包各自出。
以下全部由 build 掃資料夾產生，新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML，md 連向源檔。
| 文件 | 類型 | 標題 | 最後更新 |
|---|---|---|---|
| architecture | 文件（手刻 HTML） | Agent 架構定案 | 2026-10-31 |
由新到舊。每份是某一棒次交接當下的完整現況快照，看某個時間點「當時知道什麼」請從這裡進。
| 日期 | 文件 | 標題 |
|---|---|---|
| 未提交 | unattended-rules ／ md | — |
| 2026-10-31 | FR-170-STATE ／ md | FR-170 交接現況（STATE） |
| 2026-10-31 | FR-170-LOG ／ md | FR-170 交接日誌（LOG） |