脑库
跨会话持久化记忆。Obsidian 保险库位于 brain/。
脑库是整个工作流的基础——每个智能体、技能和会话都会读取它。低质量或推测性内容会降低后续所有流程的效果。在添加任何内容之前，问自己：“这真的能改善系统的运作方式吗？”如果答案不是明确的“是”，就不要写。
写入前
先阅读 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/中随机命名的文件——这些是过时的计划模式产物。 - 在添加新笔记前，合并重叠的笔记。