設計計畫與歷史¶
這裡收錄的是設計演進的歷史紀錄：每個功能在動工前的 grill-me / plan 文件、被否決的替代方案、以及給接手者的 handoff。它們不是目前架構的權威說明——權威說明請看 系統架構、線上契約 與 開發者指南。
為什麼留著？這些文件記錄了「為什麼這樣設計、當初考慮過哪些路、為什麼不走」。當你想改某個決策時，先回來看看它原本被否決的理由，通常能省下重踩一次坑的時間。
平台與 App 模板¶
| 文件 | 主題 |
|---|---|
| plan-app-templates.md | #89 RCA → 多 App 平台：apps/<slug>/ 模板、WorkItemBase、三層 agent resolve |
| plan-backend.md | 最初的後端設計計畫（分層 / Protocol / SSE 的原始脈絡） |
| plan-frontend.md | 最初的前端設計計畫（VSCode 風格 UI） |
| plan-topic-hub.md | Topic Hub App：跨 collection 探究工作區、檔案記憶、多 chat |
| plan-item-memory.md | item 記憶機制（仿 Claude Code memory）：記憶即 workspace 檔案、agent 在 turn 中自寫、全 App 預設開 |
| plan-collab-workspace.md | #43 多人協作 workspace（檔案 + chat，無 notebook） |
| plan-permissions.md · plan-permissions-pr2-handoff.md | 權限模型設計與分階段交接 |
| plan-ai-sheet.md | *.ai.csv 試算表編輯：格子直接打字、增刪列欄、虛擬化、範圍選取與 TSV 剪貼簿（Excel 互通）、undo/redo；單一檔案零 sidecar，後端零知識；附「為何不用 xlsx」實測 |
知識庫（KB）與檢索¶
| 文件 | 主題 |
|---|---|
| plan-kb-parsers.md | #39 KB 解析器：parser 吐整檔 Document、splitter 掌管切塊粒度 |
| plan-llamaindex-ingest.md | 以 LlamaIndex 重構攝取管線 |
| plan-kb-retrieval-enhancements.md | multi-query / HyDE / rerank 的 enhancement 旋鈕設計 |
| plan-retrieval-llm-refactor.md | 檢索 LLM 介面重構 |
| plan-llm-wiki.md | #50 LLM wiki：與 chunk-RAG 平行的第二條維基管線 |
| plan-context-cards.md | #106 Context cards：輕量、確定性的詞彙卡（glossary） |
| plan-collab-kb.md | KB 協作設計 |
Workflows¶
| 文件 | 主題 |
|---|---|
| plan-workflows.md | #100 API 觸發的 headless workflow：FS-as-journal、produce→review→commit |
| workflows-frontend-brief.md | Workflows 前端設計 brief |
| plan-make-deck-runtime-craft.md | #284 make_deck：意圖 → 多模態子代理迴圈產投影片 |
Sandbox 與基礎設施¶
| 文件 | 主題 |
|---|---|
| plan-http-sandbox.md | #60 HTTP sandbox host：把 sandbox 拆成獨立 HTTP 服務 |
| plan-sandbox-sot.md | sandbox 真相來源（source-of-truth）設計 |
| plan-sandbox-resource-quota.md | 依 App 設定 sandbox 資源（cpu/memory/disk）+ 每人跨 App 總量上限；債務人是 item 的 owner（前提見 #687） |
| plan-llm-failover.md | LLM failover / 多供應商備援 |
| plan-sanity-checks.md | 開機健康檢查 / sanity matrix |
| plan-repetition-guard.md | #113 重複迴圈偵測與優雅阻擋 |
| plan-turn-replay-buffer.md | 同台重連無損：#43 broadcast 加 in-pod seq + ring buffer，?since= replay 斷線期間漏掉的事件 |
| plan-event-bus-cross-pod-streaming.md | 跨 pod live 串流：RabbitMQ fanout 事件匯流排（IEventBus，memory 預設 + rabbitmq），不再依賴 sticky |
| plan-skills-and-tools.md | Skills 與 tools 套件設計 |
| plan-sci-plot.md | #285 sci-plot 科學繪圖工具 |
| plan-read-image.md | #112 read_image：VLM-over-workspace-image 工具 |
| plan-code-qa.md | 程式碼 QA 設計 |
各 issue 的計畫¶
逐 issue 的小型計畫文件（grill-me 鎖定決策 + flat phase 拆解）：
plan-issue-93 · 105 · 132 · 177 · 178 · 219 · 226 · 227 · 231 · 245 · 247 · 254 · 263 · 271 · 280 · 283 · 284 · 287 · 288 · 298 · 419 · 435 · 448 · 455 · 479 · 492 · 501 · 513
彙整型：plan-issues.md · plan-followups.md
前端 handoff 與設計交接¶
| 文件 | 主題 |
|---|---|
| fe-kickoff.md | 前端開工說明 |
| fe-blocking-gaps.md | 前端阻擋性缺口盤點 |
| handoff-launcher-design.md | Launcher 設計交接 |
| handoff-wiki-fe-design.md | Wiki 前端設計交接 |
給 specstar 框架的問題¶
| 文件 | 主題 |
|---|---|
| q-specstar-efficient-aggregates.md | 如何不 materialise 整批 row 就做 page 聚合 |
| q-specstar-reindex-on-blob-edit.md | blob 編輯後如何重新索引 |