create-adrlisted
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.