adr-capturelisted

Capture Architecture Decision Records (ADRs) from .context/ plans, findings, and analyses. Extracts binding decisions into numbered ADRs under docs/ADR/, maintains a machine-readable index, and validates coverage. Use when creating or reviewing context files that contain decisions. DO NOT use for observational findings without decisions, retroactive documentation of long-settled decisions, or inline comments. Triggers: 'capture decision', 'create ADR', 'document decision', 'architectural decision', 'record decision as ADR', 'extract decisions', 'ADR review', 'index ADRs', 'check ADR coverage'.
pantheon-org/skill-quality-auditor · ★ 2 · Data & Documents · score 68

Install: claude install-skill pantheon-org/skill-quality-auditor

# ADR Capture Capture Architecture Decision Records from `.context/` analysis, findings, plans, and reviews. Automatically extract decisions, create numbered ADRs, and maintain the index. > **Immutability rule:** Immutability begins at **acceptance**, not creation. A `proposed`, unmerged ADR is a draft and may be edited freely in place. Once **accepted**, an ADR's title, body, and context fields are frozen and only `status` and `superseded_by` may change; to replace an accepted decision, supersede it — create a new ADR and mark the old one as superseded. See ADR-061. ## Prerequisites - A `.context/` file (plan, finding, or analysis) containing a **binding decision** — a choice that affects future development direction, architecture, conventions, or processes - The `context-file` skill to create the source `.context/` file if it doesn't exist yet - `assets/schemas/adr-frontmatter.schema.json` and `assets/templates/adr-template.yaml` for schema validation ## Quick Start ```bash # Regenerate ADR index after adding or updating ADRs scripts/regenerate-adr-index.sh # Check for decisions in context files that lack ADRs scripts/check-undocumented-decisions.sh ``` ## ADR Location and Structure ADRs live at `docs/ADR/adr-NNN-kebab-case-title.md`. See `docs/ADR/index.yaml` for the full list. ### ADR Frontmatter Schema Every ADR MUST start with frontmatter. Use the template at `assets/templates/adr-template.yaml` to bootstrap new files. ```yaml --- title: "ADR-NNN: Human-read