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

# ADR-NNNN: <title>

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

ID: ADR-NNNN
Title: <title>
Status: Proposed
Date: YYYY-MM-DD
Owner: <owner>
Scope: repository
Category: <category>
Tags: <comma-separated tags>
Applies when: <trigger>
Adoptable: false
Variant: Guide
Canonical variant: Long
Supersedes: none
Superseded by: none
Guide verified: YYYY-MM-DD
Gist: <one-sentence outcome>

Target-repository adoption note: allocate the target's native ID, owner, status, scope, category, tags, and links. Remove provider-only `Adoptable` metadata and `AC-ADR` identity unless the target convention defines equivalent fields; keep provider provenance in the mapping or this non-normative Guide. Provider acceptance never makes this target ADR accepted.

Variants: [Short](NNNN-slug.short.md) · [Long, canonical](NNNN-slug.long.md) · **Guide**

## Use this guide when

- <implementation trigger>

## Procedure

1. <inspect>
2. <apply>
3. <validate>

## Current options

- <version-sensitive implementation option and selection condition>

## Validation

```bash
<focused command>
```

## Sources

- <official primary source, verified YYYY-MM-DD>