record-knowledge

Capture a non-obvious decision or trap while the reasoning is still available — into docs/decisions (durable), the plan file (branch-scoped), or auto-memory (cross-session). Use when a "we chose X over Y because Z" moment happens mid-work. Never edits a durable doc's status; that is the docs contract's job.