ox decision
Work with this repo's Decision Records (DRs -- ADRs are one type). ox decision enrich computes deterministic team context for a DR -- related-decision candidates, corpus conventions, drift and reference checks, and ready-to-paste citations -- with zero LLM or network cost.
Usage
DRs are committed markdown files (default discovery: docs/adr, docs/decisions, adr, docs/architecture/decisions; override via the committed .sageox config decision.paths). They are already full-text searchable via ox code search --decisions.
Subcommands
| Command | Description |
|---|---|
ox decision enrich | Enrich a Decision Record (or DR topic) with team context (JSON by default) |
Enrich a Decision Record
Run enrich before you write. --topic consults team context before drafting a new DR; --file verifies an existing DR and adds code-drift and reference checks. ox computes everything locally and never edits the DR -- the agent authors every word.
Pipe a draft on stdin to verify it before you present it:
Output is JSON by default (the agent path). Add --text for a human summary.
Flags
Flags for ox decision enrich:
| Flag | Description |
|---|---|
--topic | Consult mode: the DR subject, before drafting |
--file | An existing DR file to enrich (adds drift + ref checks) |
--text | Human summary instead of JSON |