adrlisted

Write an Architectural Decision Record (ADR) in the Structured MADR format — one decision, its drivers, the options weighed with risk, the chosen outcome, the consequences accepted, and an audit trail — validated by the structured-madr Action in both smadr and MIF modes. Use when a team is making or capturing a consequential, hard-to-reverse technical choice and needs it documented with rationale. Anti-trigger; for a how-to use diataxis-how-to, for requirements use prd or feature-spec, not an ADR.
modeled-information-format/mif-docs-plugin · ★ 0 · AI & Automation · score 73

Install: claude install-skill modeled-information-format/mif-docs-plugin

# adr Produces an **Architectural Decision Record**: a short, immutable document that captures one architecturally significant decision — the context that forced it, the options considered, the option chosen, and the consequences the team accepts. An ADR records a *decision*, not a task and not a requirement; if there are no alternatives to weigh, it is not an ADR. This genre is **fully aligned to Structured MADR (structured-madr)** — the MIF-native ADR format. The emitted ADR validates against the canonical `modeled-information-format/structured-madr` GitHub Action in **both** of its modes: `smadr` (the structured-MADR frontmatter + section schema) and `mif` (MIF conformance, levels 1-3). The suite reuses that Action; it does not re-implement ADR validation. ## Pattern (Structured MADR) Required frontmatter: `title`, `description`, `type: adr`, `category`, `tags`, `status` (lifecycle enum), `created` (date), `updated` (date), `author`, `project`. Optional: `technologies`, `audience`, `related` (each `*.md`). Required sections, in order: 1. **# ADR-NNNN: \<Title\>** — H1 matches the frontmatter `title`. 2. **## Status** — the lifecycle state. 3. **## Context** → `### Background and Problem Statement` (+ `### Current Limitations`). 4. **## Decision Drivers** → `### Primary Decision Drivers` + `### Secondary Decision Drivers`. Express testable drivers in EARS (`ears-acceptance-criteria`). 5. **## Considered Options** — `### Option N: <Name>` each with a **Risk As