/Brain
Navigation

Examples

The best way to understand a /Brain is to see what good files look like: specific, compact, and operational.

Example WORKING_WITH_ME.md

# Working With Me

- Lead with the answer.
- Keep iteration tight and direct.
- Show tradeoffs when there is a real decision.
- Prefer simple systems over clever ones.
- If a plan is weak, say why plainly.

This works because it changes behavior. It is not a personality essay.

Example context/now.md

# Now

## Priorities
- Launch public /Brain docs
- Tighten onboarding copy

## Constraints
- Keep public docs learner-first
- Do not leak internal roadmap language

## Open questions
- Which examples deserve their own pages?

This works because it is current, specific, and short.

Example durable memory entry

- I make faster decisions when tradeoffs are named explicitly.
- Agents should avoid long preambles during iteration.
- Weekly review is enough to keep my knowledge system healthy.

This belongs in durable memory because it is likely to matter again.

Example decision record

# Separate learner docs from product help

## Decision
Public docs teach /Brain concepts and practice. Product-specific behavior lives in help pages.

## Why
Mixing the two confuses learners and leaks internal implementation detail.

Common mistakes

  • writing examples that look polished but would not help a real session
  • making example files too long to copy or adapt
  • showing structure without showing decision quality

Next steps