# Create Adr

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

- Skill: `eminboydak/create-adr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add eminboydak/create-adr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eminboydak/create-adr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: eminboydak (https://skillmd.com/u/eminboydak)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/eminboydak/create-adr

---


# 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.