← 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 · ★ 4 · AI & Automation · score 73
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`** — flip Status from `Proposed (YYYY-MM-DD)` to `Accepted (YYYY-MM-DD)`, and stamp the canonical `status: Accepted` frontmatter field in the **same** atomic write (spec 073-02 / ADR-0026 — frontmatter is the canonical status home; prose and frontmatter cannot diverge). - **`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 actual ADR files present. Idempotent. - **`resolve-todo`** — strike through a `### Decision: ...` heading in `docs/refinem