← ClaudeAtlas

create-adrlisted

Use when creating Architecture Decision Records under docs/ADR/. Numbered PREFIX-NNNN format, English content, structured context/decision/consequences with index ledger. Triggers on ADR, decision, architecture decision.
eminboydak/embedded-agent-skills · ★ 0 · AI & Automation · score 68
Install: claude install-skill eminboydak/embedded-agent-skills
# Create Architecture Decision Record Create new ADRs under `docs/ADR/`. Content is **English**. File names use **English kebab-case**. The numbering prefix is project-specific (e.g. `DT` for duckTerm, `TEZG` for tezgah) — ask the user once per repo, then reuse it. ## Format ADRs follow the MADR-lite format: ```markdown # <PREFIX>-NNNN: Title * **Date:** YYYY-MM-DD * **Status:** Proposed | Accepted | Deprecated | Superseded by <PREFIX>-NNNN * **Domain:** Architecture & Governance ## Context [Problem statement and background] ## Decision [The decision with numbered sub-sections] ## Consequences * **Positive:** [benefits] * **Negative:** [trade-offs] ## References * [cross-references to other ADRs] ``` ## Procedure 1. Read `docs/ADR/INDEX.md` to find the next available number. 2. Create `docs/ADR/<PREFIX>-NNNN-short-descriptive-title.md` with the format above. 3. Fill all sections with English content. 4. Set the `Status` field: `Proposed`, `Accepted`, `Deprecated`, or `Superseded`. 5. Update `docs/ADR/INDEX.md` — add a row to the ledger table. 6. Commit with `docs(adr): add <PREFIX>-NNNN title`. ## Rules - Never delete historical ADRs. Mark old ones as `Deprecated` or `Superseded`. - Sequential numbering, no gaps. - English prose only in ADR bodies. - Keep `docs/ADR/INDEX.md` up to date. - Stage only the ADR files. Never bundle unrelated changes.