ox-decision

name

ox-decision

description

Consult team context BEFORE creating or editing a Decision Record (ADR, DDR, architecture/design decision doc). Auto-fire when the user asks to "write an ADR", "add a decision record", "amend/update ADR-NNN", cites a DR by number, or edits a file under docs/adr/ or docs/decisions/. Run `ox decision enrich --topic "<subject>"` before drafting a new DR and `ox decision enrich --file <dr.md>` before editing an existing one — related decisions, numbering, conventions, drift, and ready-to-paste citations at zero LLM cost. Follow the returned `guidance`.

Use when

The task creates, edits, amends, or cites a Decision Record.

Do

1. New DR: ox decision enrich --topic "<subject>" — BEFORE drafting.
2. Existing DR: ox decision enrich --file <path> — BEFORE editing, and again after your edit (it re-verifies every ref).
3. Follow the guidance string in the JSON output — it carries the corpus conventions, crediting contract, and verification rule for this repo.

DR full text is searchable via ox code search "<terms>".