| name | reflect |
| description | Reflect on the conversation and update the brain. Use when wrapping up, after mistakes or corrections, or when significant codebase knowledge was gained. Triggers: "reflect", "remember this". |
Reflect
Review the conversation and persist learnings — to brain/, to skill files, or as structural enforcement.
Process
- Read
brain/index.md to understand what notes already exist
- Scan the conversation for:
- Mistakes made and corrections received
- User preferences and workflow patterns
- Codebase knowledge gained (architecture, gotchas, patterns)
- Tool/library quirks discovered
- Decisions made and their rationale
- Friction in skill execution, orchestration, or delegation
- Repeated manual steps that could be automated or encoded
- Skip anything trivial or already captured in existing brain files
- Route each learning to the right destination (see Routing below)
- Update
brain/index.md if any brain files were added or removed
Routing
Not everything belongs in the brain. Route each learning to where it will have the most impact.
Structural enforcement check
Before routing to brain/, ask: can this be a lint rule, script, metadata flag, or runtime check? If yes, encode it structurally and skip the brain note. See [[encode-lessons-in-structure]]. Complements meditate (vault audit) — same backbone, different entry point.
Brain files (brain/)
Codebase knowledge, principles, gotchas — anything that informs future sessions. This is the default destination. Use the brain skill for writing conventions.
- One topic per file. File name = topic slug.
- Group in directories with index files using
[[wikilinks]].
- No inlined content in index files.
Skill improvements (.agents/skills/<skill>/)
If a learning is about how a specific skill works — its process, prompts, or edge cases — update the skill directly.
Backlog items
Follow-up work that can't be done during reflection — bugs, non-trivial rewrites, tooling gaps. File as a todo or backlog item.
Summary
## Reflect Summary
- Brain: [files created/updated, one-line each]
- Skills: [skill files modified, one-line each]
- Structural: [rules/scripts/checks added]
- Todos: [follow-up items filed]
