brain.md

Why we included this project

Coding agents lose the context of a long-running project the moment a session ends, and this tool gives them a persistent memory to carry forward. It defines a plain-Markdown standard: a BRAIN.md file and a brain/ directory that capture the durable decisions your team made, the requirements you've agreed on, and any constraints that should stick. A zero-dependency CLI reads and writes that memory, so a team can adopt it without standing up a backend or database. If you use Claude Code, Codex, or Cursor on real work, this stops architectural choices and agreed constraints from dissolving into chat logs, and the context stays with the repo regardless of which agent or machine is reading it. Because the memory is ordinary Markdown, it remains auditable and portable, and git tracks its history.