What problem does it solve? Technical decisions often get made in chat threads or meetings and the reasoning behind them is lost, forcing teams to re-litigate choices or guess at past intent. This Skill forces a decision through structured reasoning and captures the rationale as a durable ADR file in the repository. ## Core Features & Use Cases - Structured Decision Process: Parses the decision topic, gathers only decision-relevant context (existing code, prior ADRs), lays out 2-4 options with trade-offs, and commits to one with explicit rationale. - ADR Authoring: Fills the shipped ADR template and writes it to omnigrid/artifacts/adrs/ADR-NNNN-<slug>.md with the next free sequence number, archiving prior versions on re-runs. - Security Escalation: Pulls in a security-reviewer sign-off before finalizing any decision touching auth, crypto, secrets, or PII. - Use Case: A tech lead debating PostgreSQL versus SQLite for a new service runs the Skill, gets the trade-offs laid out, and ends with ADR-0007-use-postgresql.md documenting why PostgreSQL won. ## Quick Start Ask the AI to decide which database to use for the new billing service and record the decision as an ADR.
