ADR Tracking

Manage Architecture Decision Records in docs/adrs/. Interpret $ARGUMENTS as natural language.

Creating an ADR

Ask the user for any missing information. You need at minimum: title, context, decision, and owner (@github-username).

If the decision is made → create docs/adrs/NNN-short-title.md with status Accepted. If the decision is open → create docs/adrs/DRAFT-short-title.md with status Proposed.

Assign the next number by reading docs/adrs/index.md. Always update the index after creating a file.

Updating an ADR

Valid status transitions: Accepted, Deprecated, Superseded by ADR-NNN.

When promoting a Draft to Accepted: rename DRAFT-title.md → NNN-title.md and move the row from Drafts to Accepted in the index.