new-adrlisted

Author a new ADR — record a DECISION (what the system must do, or how it is built) in a documentation-led repo. Picks the next contiguous number, chooses the shape (capability vs technology), fills the template, sets status Proposed, regenerates INDEX, updates domain READMEs, handles supersede/deprecate linkage, commits. Use when the user says "add an ADR", "new ADR", "record a decision", "create an architecture decision record", or invokes /new-adr. NOT for queueing a unit of work against an existing decision (use /new-plan) and NOT for recording a reusable rule, practice, or naming/process standard (use /add-convention).
EvolveHQ/docflow · ★ 3 · Web & Frontend · score 74

Install: claude install-skill EvolveHQ/docflow

# new-adr Author one new ADR, consistent with this repo's conventions. ## Step 0 — Preconditions and context 1. Confirm the repo is bootstrapped: `AGENTS.md`, `CONVENTIONS.md`, and an `adr/` directory with at least `adr/0000-template.md` must exist. If not, stop and offer to run the **bootstrap** skill first. 2. Read `CONVENTIONS.md` to learn this repo's choices: ADR shape (single vs. capability/technology split and the cutoff number), status lifecycle, language mandate (if any), whether `domains/` groupings exist, and the multi-agent mode. 3. Read `INDEX.md` and `ls adr/` to learn existing numbers and titles. ## Step 1 — Determine shape and number - **Shape.** If the repo uses a single ADR shape, use `adr/0000-template.md`. If it uses the split, decide capability vs. technology from the user's intent (what the system must do → capability; how it is built → technology); confirm with the user if ambiguous. Use `adr/0000-template.md` (capability) or the technology template (`adr/NNNN-template.md`). - **Number.** Next contiguous integer after the highest existing ADR, zero-padded to 4 digits. No gaps, no reuse. For a split repo, keep capability ADRs below the cutoff and technology ADRs at/above it. ## Step 2 — Gather content Ask for the pieces the chosen template needs, one prompt at a time: - Title (sentence case), Context. - Capability ADR: capability statement, user stories, **numbered, testable** acceptance criteria. - Technology ADR: de