craft-observationlisted

# 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 1. **Location**: `observations/NNN-topic.md` in branch memory. 2. **Sequence**: Increment NNN from last observation. 3. **Brevity**: Capture the essence. One page max. 4. **Actionable**: Future you should be able to act on it. ## The Protocol 1. **Identify type**: Pattern, problem, solution, or discovery? 2. **Describe what**: What actually happened? 3. **Capture context**: What were you doing? 4. **Extract learning**: What's the takeaway? 5. **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.