# Architecture Decision Records

> Durable decision records for important docs-system and plugin-architecture choices.

---

## Index

| ADR | Status | Notes |
|-----|--------|-------|
| [2026-05-08-docs-system.md](2026-05-08-docs-system.md) | Accepted | Docs System Upgrade: reader model, taxonomy, start-here navigation, glossary, compatibility matrix, and docs verification layer |

## Format

Each ADR should answer:

1. What problem are we solving?
2. What decision did we make?
3. What alternatives did we reject?
4. What are the consequences?

Keep ADRs short, dated, and specific.