adr-workflowlisted
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