Decision Journal Contract

When To Use

• A workflow has just made a decision and needs to record the tradeoff: what was chosen, what was rejected, what was sacrificed.
• A workflow has hit a failed approach, rework, or blocker and needs to record the lesson.
• Building or validating a consumer hook that writes to the journal.

When NOT To Use

• Scaffolding the files at project init (that is attune:project-init).
• Recording a full architecture decision that warrants a numbered ADR in docs/adr/; reference its number from a journal entry instead of duplicating it.