Draft a new Architecture Decision Record in docs/decisions/. Trigger when the user says "write an ADR", "document this decision", "record architecture decision", or "ADR for X".
List files in docs/decisions/adr-*.md. Find the highest 4-digit number and increment by 1.
Current ADRs for reference:
adr-0001 — Agent collaboration modeladr-0002 — LLM provider abstractionadr-0003 — Two-call ATS/CV optimisation isolationadr-0004 — Async vs direct ATS scoringadr-0005 — Skill dedup fuzzy matchingadr-0006 — RLS-first tenant isolationNext number: check the directory to confirm, do not assume it is 0007.
Kebab-case, ≤40 characters, descriptive (e.g. per-user-api-quotas, i18n-library-choice).
Path: docs/decisions/adr-<NNNN>-<slug>.md
# ADR-<NNNN>: <Title>
**Status:** Proposed
**Date:** YYYY-MM-DD
**Deciders:** Architecture (Claude Code)
## Context
2–4 sentences. What situation, constraint, or incident forces this decision?
Name specific files, functions, or prior ADRs where relevant.
## Decision
1. <Concrete, implementable statement of what was decided>
2. <Additional decision points if applicable>
## Alternatives Considered
1. **<Option name>** — <what it is>. Rejected because: <one sentence>.
2. **<Option name>** — <what it is>. Rejected because: <one sentence>.
## Consequences
**Positive:**
- <Benefit>
**Negative / trade-offs:**
- <Cost or constraint introduced>
## Cross-references
- Related ADRs: <!-- list by number and title, or "None" -->
- Related plans: <!-- e.g. plans/p19.md, or "None" -->
- Related specs: <!-- e.g. docs/specs/technical/llm-model-governance.md, or "None" -->
Proposed. Only the human owner changes it to Accepted.**Supersedes:** ADR-XXXX below the Status line, and update the old ADR's Status to Superseded by ADR-<NNNN>.docs/decisions/README.md if it exists.