Observation Capture
Capture observations before closing work. Invoked by /close command.
Questions
Answer these 4 questions about the work just completed:
- •
What surprised you?
- •Unexpected behaviors, bugs encountered
- •Things easier or harder than anticipated
- •Assumptions that proved wrong
- •Principles revealed through the work
- •Operator insights that shifted understanding
- •
What's missing?
- •Gaps in tooling, docs, or infrastructure
- •Features that would have helped
- •AgentUX friction points
- •Schema or architectural concepts not yet codified
- •Patterns that should exist but don't
- •
What should we remember?
- •Learnings for future work
- •Patterns worth reusing or naming
- •Warnings for similar tasks
- •Decisions that should become ADRs
- •Principles worth adding to L3/L4
- •
What drift did you notice?
- •Reality vs documented behavior
- •Code vs spec misalignment
- •Principles violated or bent
- •Patterns that have evolved past their docs
Gate
MUST provide:
- •At least one substantive answer, OR
- •Explicit "None observed" with brief justification
Empty responses BLOCK closure.
Output
Write answers to docs/work/active/{id}/observations.md using simplified template.