brain

Brain

跨会话持久记忆。位于 brain/ 的 Obsidian 知识库。

Brain 是整个工作流的基础——每个 Agent、技能和会话都会读取它。低质量或推测性内容会影响下游的一切。添加任何内容前，先问自己：“这真的能改善系统的运行方式吗？”如果答案不是明确的肯定，就不要写入。

写入前

先阅读 brain/index.md。然后阅读与你的主题相关的入口文件：

• 原则更新：阅读 brain/principles.md
• 计划相关笔记：阅读 brain/plans/index.md

对于尚无专属索引文件的目录（brain/codebase/、brain/audits/），直接查看附近的文件，并尽可能编辑已有笔记。

结构

brain/
├── index.md              ← root entry point, links to everything
├── principles.md         ← index for principles/
├── todos.md              ← product backlog
├── vision.md             ← elevator pitch + link to architecture
├── architecture.md       ← full technical reference
├── principles/           ← engineering and design principles
├── codebase/             ← project-specific knowledge and gotchas
├── plans/                ← numbered feature plans (02-arrow-bindings/, etc.)
└── audits/               ← design and quality audits (date-prefixed filenames, e.g. 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 是根索引。每个 brain 文件都必须能从中访问。
• 文件名：全部小写，用连字符连接。worktree-gotchas.md。
• 计划目录：以 brain/todos.md 中的 todo ID 为前缀。目录使用 02-arrow-bindings/，其中包含 overview.md 和 phase-N-*.md。

Wikilinks

格式：[[section/file-name]]。解析顺序：同一目录，然后是相对路径，最后是知识库根目录。解析时会移除标题锚点（[[file#heading]]）。

写作风格

• 多用项目符号，少用散文。不写前言。
• 使用带 # Title 的纯 Markdown。不使用 Obsidian frontmatter。
• 笔记控制在约 50 行以内。更长时拆分。

写入后

添加或删除任何文件后，都要更新 brain/index.md。适用时还要更新相关入口文件（brain/principles.md、brain/delegation.md 或 brain/plans/index.md）。索引仅保留链接，便于快速浏览。

持久性测试

问自己：“我会把这条内容放进另一个任务的提示词里吗？”

• 会 → 写入 brain/。这是持久知识。
• 不会，是特定于计划的内容 → 改为更新计划的阶段文档。
• 不会，是技能问题 → 直接更新技能文件。
• 不会，还需要后续处理 → 使用 todo 技能创建 todo。

维护

• 删除过时或已被取代的笔记。
• 删除 brain/plans/ 中名称随意的文件——这些是过时的计划模式产物。
• 添加新笔记前，先合并重叠的笔记。