mindmuxai/brain.md

What it solves

代码代理通常缺乏持久的内存；一旦聊天会话结束，决策、约束和理由就会丢失。这迫使后续的代码代理或新的会话必须从零开始，丢失了为什么选择或避开某些技术路径的上下文信息。

How it works

它通过直接存储在项目仓库中的纯 Markdown 文件来建立一个持久化、基于文件的内存层。一个零依赖的 Node CLI 作为读取和写入此数据的唯一接口，确保了“大脑”结构的 consistency 保持一致。系统使用 BRAIN.md 协议文件来教导任何代理如何与内存进行交互。每个内存页都包含一个“编译后的真相”（当前的理解）和一份仅限追加的记录时间轴，用于跟踪跟踪每一个变化和其背后的证据。

Who it’s for

使用 AI 代码代理（如 Claude Code, Codex, 或 Cursor）的开发者，希望维护一个长期的、与代理无关的项目决策和需求知识库，该知识库可以跨会话和机器持久化。 ment

Highlights

• Repo-native: 知识存储在 git 中的 Markdown，使其具有可移植性，且独立于任何特定工具的运行时。
• Agent-agnostic: 任何能够读取文件的代理都可以通过遵循 BRAIN.md 协议来使用该大脑。
• Tamper-evident: update-truth 命令原子性地更新当前状态，同时在时间轴中记录理由，防止未记录的变更。
• Automated Seeding: 包含一个引导技能，可以分析现有代码、文档和 git logs 来自动草拟初始内存页。