← ClaudeAtlas

adr-workflowlisted

Scaffold, accept, index, and link Architectural Decision Records (ADRs). Use when the user says "write an ADR", "record this decision", "resolve [deferred item] with an ADR", "supersede ADR-NNNN", or otherwise wants to capture a hard-to-reverse decision in `docs/decisions/`. Also use when a refinement-todo entry needs to be marked RESOLVED with a link back to the ADR. Do NOT use for ad-hoc design discussion that hasn't crystallized into a decision yet — wait until the choice is firm.
ramboz/jig · ★ 6 · AI & Automation · score 74
Install: claude install-skill ramboz/jig
> Spec 005 created this skill from scratch. The mechanics live in `adr.py`; > Claude owns the judgment (what the decision actually says). ## What this skill does Codifies the ADR lifecycle that ADR-0001 and ADR-0002 were written by hand to exercise. Five deterministic operations: - **`new`** — scaffold `docs/decisions/adr-NNNN-<slug>.md` from the template, with auto-numbering and a slug-collision check. The scaffold carries `status: Proposed` in frontmatter (from the template) alongside the prose `Proposed (date)` line (spec 073-02 / ADR-0026). - **`accept`** — stamp the canonical `status: Accepted` frontmatter field and flip the prose Status line to `Accepted (YYYY-MM-DD)` in the **same** atomic write. Frontmatter is the authoritative status home; the prose line is a best-effort mirror, rewritten only when it is canonical (spec 073-02 / [ADR-0046](../../docs/decisions/adr-0046-adr-status-frontmatter-authority.md), which supersedes ADR-0026). - **`supersede`** — append `Superseded by [ADR-NNNN](./adr-NNNN-<slug>.md) (date)` to an Accepted ADR's Status block and `Supersedes ADR-NNNN` to the replacement's Status block, and stamp the **old** ADR's `status: Superseded` frontmatter field in the same atomic write (the replacement retains `status: Accepted`). This is the **one** edit allowed on an immutable ADR per the Nygard convention. Atomic write on both files. - **`index`** — regenerate the `## Index` section of `docs/decisions/README.md` from the