| name | brain-log |
| description | Capture a thought, flag, or decision into the brain system. Trigger on "capture this", "log this", "flag this", "park this decision", "note this", "remember this", "save this thought", "brain dump", "I had an idea", "something to track", or any variation. Also fires on user-vocabulary equivalents: "journal entry", "note to self", "diary", "log to journal", "add to my journal", "write in my journal" - the brain log is the journal. Also fires on post-hoc decision phrasing: "I decided", "I made a decision", "decision: <text>" - route into context/decisions.md Resolved section, not just brain/log.md. Also fires when the user shares an observation that should be recorded but does not need immediate action. Three modes: log, cross-reference, or act.
|
| why | Keeps thoughts, decisions, and flags from living only in your head - a running log is how the OS learns what is actually happening in your week. |
| enhance | Log in Mode B or C when you can - thoughts cross-referenced to a client, decision, or priority are far more useful to skills like weekly-review and brain-pass than standalone entries. |
| allowed-tools | ["Read","Write","Edit","Bash"] |
| mcp_requirements | [] |
Brain Log
Runs on: local-writes - creates or edits files in your OS folder; needs an agent with write access.
Three modes for incoming thoughts, plus flags and parked decisions.
Routing
When the founder gives you something to capture, determine which mode:
Mode A: Log and Move On
The thought is worth recording but doesn't connect to anything specific right now.
- Append to
brain/log.md with timestamp and a stamped ID (see ID Stamping below)
- Tag:
#context
- No follow-up
Mode B: Log and Cross-Reference
The thought connects to an existing file or topic.
- Append to
brain/log.md with timestamp and a stamped ID
- Tag:
#xref:[target-file]
- Insert a dated note into the referenced file
- Examples: "This changes my priorities" -> xref to priorities.md. "This affects the deal with X" -> xref to clients.md
Mode C: Log and Act
The thought requires immediate action.
- Append to
brain/log.md with timestamp and a stamped ID
- Tag:
#acted
- Take the action (update a file, create a task, move a priority)
- Note what was done in the log entry
Default: Infer the mode from context. The founder can override: "just log it" (Mode A), "tie this to priorities" (Mode B), "act on this now" (Mode C).
Brain context (default)
Before producing output, read brain/.snapshot.md. If it is missing, or its date: line is more than 3 days old, run python scripts/brain-snapshot.py --write first and read the fresh one - a stale snapshot read as current presents last week's flags and must-dos as today's, which is worse than no memory at all. If Python is unavailable, proceed without it and say so.
If the snapshot is missing, run:
python scripts/brain-snapshot.py --write
Then read it. If the snapshot script is also missing (older install), proceed using only the profile files. Do not block.
The snapshot tells you what flags are open, what the user is working on this week, and what the latest staleness state is. Apply this context to your output where it is relevant. Do not surface every snapshot field in every output - use judgment. For brain logging, recent decisions and open flags help you choose the right tag - if a thought connects to an active flag or recent decision, prefer Mode B (cross-reference) over Mode A (log in isolation).
