# Rule: ADR commits

## Commit type

```text
adr(<category>): <short summary>
```

Examples: `adr(workflow):`, `adr(build):`, `adr(layout):`, `adr(docs):`

## Maintenance vs decision commits

| Change | Commit type |
|--------|-------------|
| New decision or superseding ADR | `adr(<category>):` |
| Non-semantic maintenance on Accepted ADR (typos, links) | `docs(adr):` or `fix(adr):` |

Maintenance rules: `rules/08-adr-editing-evolution.md`. Do not use `adr(...)` for typos or link fixes.

## One ADR per commit

Each `adr(...)` commit contains:

- exactly one ADR file
- required `docs/adr/INDEX.md` updates
- supersedes / superseded-by links if applicable
- minimal metadata directly required for that ADR

## Forbidden in ADR commits

- Implementation code changes
- Unrelated documentation updates
- Formatting-only repo-wide changes
- Multiple independent ADRs

## Rationale

Isolated ADR commits make architectural history inspectable in `git log` and reinforce small-step review.