Skill: Craft Observation
"The best time to capture a learning is when it happens."
When
Record an observation when:
- A pattern emerges
- A problem is solved (not just fixed — understood)
- Something unexpected happens
- A key insight crystallizes
The Standard
- Location:
observations/NNN-topic.mdin branch memory. - Sequence: Increment NNN from last observation.
- Brevity: Capture the essence. One page max.
- Actionable: Future you should be able to act on it.
The Protocol
- Identify type: Pattern, problem, solution, or discovery?
- Describe what: What actually happened?
- Capture context: What were you doing?
- Extract learning: What's the takeaway?
- Save: Write to
observations/NNN-topic.md.
The Anti-Patterns
| Don't | Do | Why |
|---|---|---|
| Wait until later | Capture now | Context fades fast |
| Over-explain | Distill essence | Signal over noise |
| Skip the learning | State the takeaway | That's the whole point |
Template
See templates/observation.md.
Integration
Observations are reference material, not auto-loaded. Search when relevant context arises.