---

name: adr description: Scaffold an architecture decision record in architecture/decisions/ using the repo's governed ID conventions. Use when a decision needs recording or the user says /adr.

/adr — record an architecture decision

1. Read architecture/decisions/README.md for conventions.
2. ID selection (critical): use ADR-KOA-DEV-NNN (next sequential number) for decisions local to this repository — harness, CI, tooling, repo layout. The governed ADR-KOA-NNN range belongs to the Koʻa baseline amendment process and must NOT be minted here.
3. Create architecture/decisions/ADR-KOA-DEV-NNN-<slug>.md:

# ADR-KOA-DEV-NNN — <Title>

**Status:** proposed | accepted
**Date:** <YYYY-MM-DD>
**Deciders:** <who>

## Context
Why this decision is needed; constraints from the governance baseline
(architecture/governance/) that bear on it.

## Decision
The decision, stated actively. Numbered points if there are several.

## Consequences
What becomes easier/harder; follow-ups; what would trigger revisiting.

4. Add a row to the index table in architecture/decisions/README.md.
5. If the decision touches naming, include the cultural-review caveat; if it promotes the placeholder workflow toward a real capability, say so explicitly and reference ADR-KOA-DEV-001.