3.0 KiB
BRAIN.md - External Memory System
Purpose: Structured external memory to reduce context window usage and improve recall accuracy.
Rule: If it's not in BRAIN.md, it doesn't exist. Context window is for active work only.
🎯 Active Projects (Top 3 Only)
Keep only the 3 most active projects here. Archive others to memory files.
| Project | Status | Last Update | Next Action |
|---|---|---|---|
| Mission Control | In Progress | 2026-02-22 | Complete Phases 6-9 |
| Gantt Board | Maintenance | 2026-02-20 | Bug fixes as needed |
| Blog Backup | Maintenance | 2026-02-18 | Daily digest running |
🧠 Key Decisions Log
Recent architectural or strategic decisions with rationale.
2026-02-22: Memory Optimization Implementation
- Decision: Applied Ramya's memory optimizations (BRAIN.md, write discipline, heartbeat state)
- Rationale: Token bloat was causing slower responses and missed context
- Impact: Reduced skill load, structured memory system
2026-02-20: Mission Control Architecture
- Decision: Phased approach (dashboard first, automation later)
- Rationale: Vox's article showed closed-loop requires solid foundation
- Impact: Focus on read-only Phases 6-9 before auto-proposals
📋 Recurring Patterns
Code patterns, conventions, and templates used frequently.
Supabase Table Naming
<project>_<table> with underscores (NO hyphens)
Examples: mission_control_documents, blog_messages, heartbeat_status
Project Creation Checklist
- Check TOOLS.md for existing projects
- Create in
/Users/mattbruce/Documents/Projects/OpenClaw/[Web|iOS]/ - Update TOOLS.md immediately
- Set correct git identity (OpenClaw Bot vs Matt Bruce)
Git Identity Rules
- OpenClaw projects: OpenClaw Bot / ai-agent@topdoglabs.com
- Matt's projects: Matt Bruce / mbrucedogs@gmail.com
⚠️ Gotchas & Lessons
Mistakes made and how to avoid them.
- Table Names: Always use underscores, never hyphens in Supabase
- Gitea Server: Runs on 192.168.1.128:3000 (NOT localhost!)
- Port 3000: Reserved for Gantt Board dev (don't use for other projects)
- Skills Load: 58 skills available - check SKILL.md before assuming capability
🔗 Quick Links
Frequently accessed resources.
- Mission Control: https://mission-control-rho-pink.vercel.app/
- Gantt Board: https://gantt-board.vercel.app
- Gitea: http://192.168.1.128:3000
- Supabase Dashboard: https://qnatchrjlpehiijwtreh.supabase.co
📝 Write Discipline
After EVERY task, you MUST:
-
Log to memory file →
memory/YYYY-MM-DD.md- What was requested
- What was decided
- What was done
-
If mistake made → Append to
memory/LEARNINGS.md- What went wrong
- Why it happened
- How to avoid next time
-
If significant context → Update
MEMORY.md- Only during heartbeat reviews
- Curated wisdom, not raw logs
- Keep under 100 lines
Remember: Text > Brain. If you don't write it down, it dies with the session.