By name: brain-manager description: Manage your project's brain — export/import decisions, architecture notes, and project context.
Brain Manager
Manages the .agent/brain/ directory — your project's persistent memory. It stores architecture decisions, tech stack choices, conventions, and lessons learned so AI agents always have context.
Usage
Add a Decision
python .agent/skills/brain-manager/scripts/brain.py add-decision "Use PostgreSQL over MongoDB for relational data needs"
Show Project Context
python .agent/skills/brain-manager/scripts/brain.py show
Export Brain (for sharing/backup)
python .agent/skills/brain-manager/scripts/brain.py export --output brain_backup.json
Import Brain (from another project or backup)
python .agent/skills/brain-manager/scripts/brain.py import --input brain_backup.json
Files
| File | Purpose |
|---|---|
brain/project_context.json |
Core project metadata and settings |
brain/decisions.jsonl |
Architecture Decision Records (ADR) |
brain/conventions.md |
Coding conventions and style guide |
How AI Agents Use It
When an agent starts working, it reads project_context.json to understand:
- What tech stack is used
- What patterns/conventions to follow
- Past decisions and their rationale
- Known issues to avoid