skills/architecture-compass/assets/adr-index-template.md

# Architecture Decision Records

> Derived, non-normative asset. The applicable canonical Long ADRs prevail if this template conflicts or drifts.

Accepted ADRs are binding until superseded. Normal prose links point to Short and include Long and Guide companions.

When adopting a provider decision, allocate repository-native identity and status. Remove provider-only `Adoptable` metadata and provider IDs from native fields unless this repository explicitly supports them; preserve provenance in the mapping or non-normative Guide instead.

## Active ADRs

### <category>

| ID       | Status   | Decision           | Short                       | Long                                 | Guide                       |
| -------- | -------- | ------------------ | --------------------------- | ------------------------------------ | --------------------------- |
| ADR-0001 | Accepted | <one-line outcome> | [Short](0001-slug.short.md) | [Long, canonical](0001-slug.long.md) | [Guide](0001-slug.guide.md) |

## Superseded decisions

| ID  | Superseded by | Short | Long | Guide |
| --- | ------------- | ----- | ---- | ----- |
|     |               |       |      |       |

## Agent rule

Discover applicable ADRs, read Short first, use Long as authority, load Guide for mechanics, and stop before implementing a semantic conflict.