腦部
跨會話持久記憶。位於 brain/ 的 Obsidian 保險庫。
腦部是整個工作流程的基礎——每個代理、技能和會話都讀取它。低品質或推測性內容會使下游所有東西降級。在新增任何內容之前,問自己:「這是否真正改善了系統的運作方式?」如果答案不是明確的「是」,就不要寫。
寫入前
首先讀取 brain/index.md。然後讀取主題相關的入口點:
brain/principles.md用於原則更新brain/plans/index.md用於計劃相關筆記
對於還沒有專用索引檔案的目錄(brain/codebase/、brain/audits/),直接掃描附近的檔案並在可能時編輯現有筆記。
結構
brain/
├── index.md ← 根入口點,連結到所有內容
├── principles.md ← principles/ 的索引
├── todos.md ← 產品待辦事項
├── vision.md ← 電梯簡報 + 架構連結
├── architecture.md ← 完整技術參考
├── principles/ ← 工程和設計原則
├── codebase/ ← 專案特定知識和陷阱
├── plans/ ← 編號功能計劃(02-arrow-bindings/ 等)
└── audits/ ← 設計和品質審核(日期前綴檔案名稱,例如 2026-02-20-quality-audit.md)
規則:
- 每個檔案一個主題。
brain/codebase/noodle-spawn-gotchas.md,而不是一個大型檔案。 - 維護現有索引入口點:
brain/index.md、brain/principles.md、brain/plans/index.md。 - 如果引入一個新的頂層類別,為它添加一個索引樣式的入口點(僅連結,無內嵌內容)。
brain/index.md是根。每個腦部檔案必須從它可達。- 檔案名稱:小寫、連字符。
worktree-gotchas.md。 - 計劃目錄:使用來自
brain/todos.md的待辦事項 ID 作為前綴。02-arrow-bindings/,內部有overview.md和phase-N-*.md。
維基連結
格式:[[section/file-name]]。解析順序:相同目錄,然後相對路徑,然後保險庫根目錄。標題錨點([[file#heading]])在解析過程中被移除。
寫作風格
- 要點優先於散文。無前文。
- 純 Markdown,使用
# 標題。無 Obsidian 前文。 - 將筆記保持在約 50 行以下。如果更長,則拆分。
寫入後
對任何新增或移除的檔案更新 brain/index.md。在適用時也更新相關的入口點(brain/principles.md、brain/delegation.md 或 brain/plans/index.md)。保持索引僅含連結且易於掃描。
耐久性測試
問自己:「我會把這個包含在一個不同任務的提示中嗎?」
- 是 → 寫入
brain/。這是持久知識。 - 否,是計劃特定的 → 改更新計劃的階段文件。
- 否,是技能問題 → 直接更新技能檔案。
- 否,需要後續工作 → 使用
todo技能記錄一個待辦事項。
維護
- 刪除過時或被取代的筆記。
- 刪除
brain/plans/中隨機命名的檔案——過時的計劃模式產物。 - 在新增新筆記之前合併重疊的筆記。