Core Files

me/WORKING_WITH_ME.md

This is the operational contract between you and the agent.

Include:

• how you prefer to communicate
• how you make decisions
• what level of detail is useful
• what to optimize for
• anti-patterns the agent should avoid

Avoid autobiography. The file should change behavior, not just describe personality.

context/now.md

This is the session-start anchor for the present moment.

Keep it focused on:

• current priorities
• active projects
• pressing constraints
• open questions
• recent changes that matter

If this file is stale, the rest of the /Brain starts to drift.

MEMORY.md

Use this for durable truths that should survive time and context switching:

• stable preferences
• repeated lessons
• important long-term constraints
• recurring collaboration patterns

If something only matters this week, it belongs in context/now.md, not here.

Deeper folders (add later)

Once the three core files are working well, you may want to add:

• frameworks/ for mental models and reusable heuristics
• decisions/ for decision records and rationale
• learnings/ for durable insights that may matter later

These are optional. Do not create them until you have real content that belongs there.

Common mistakes

• Letting startup files become long archives
• Repeating the same content in three different places
• Putting project detail in identity files
• Creating agent-specific files before the core files are solid

Next steps

• Read Capture to feed the system consistently
• Read Maintenance to keep startup files compact
• Read Examples to see concrete file patterns