decisions

Architecture Decision Records

Lightweight, numbered, immutable records of cross-cutting decisions that affect the AzureLocal platform and its consumer repos.

Index

#	Title	Status
0001	Create AzureLocal platform repo	Accepted
0002	Standards as single source of truth	Accepted
0003	MAPROOM framework & IIC canon centralization	Accepted
0004	Testing toolset classification rubric	Accepted
0005	Reusable workflow split between .github and platform	Accepted

When to write an ADR

• Any change to standards/*.mdx beyond typo fixes
• New reusable workflow, new input, or breaking change to an existing one
• Any change to testing/iic-canon/*.json
• New template variant, or breaking change to an existing variant
• Cross-repo architecture decisions that don't fit neatly in any one repo

Format

See template.md. Sections:

1. Context — what problem, what constraints
2. Decision — what we chose
3. Consequences — what changes, what trade-offs, who is affected
4. Status — Proposed, Accepted, Superseded

ADRs are never edited after acceptance — supersede with a new ADR instead.