# Spec Index
Purpose: Provide the entry point for system specifications and contracts.
Audience: Engineers and LLMs reading the canonical system spec.
Scope: Architecture, cache behavior, registry contracts, persistence, and security invariants.
Documentation governance is defined in `docs/governance.md`.
## Spec layout
- `docs/spec/`: Normative specifications for jwks-cache behavior and boundaries.
## How to use this index
- Start with `docs/spec/architecture.md` for system boundaries and design decisions.
- Add new spec links here as they are introduced.
## Reading order
1. `docs/spec/architecture.md`
## Spec list
- `docs/spec/architecture.md`: Architecture decisions, module boundaries, and repository layout.
Operational workflows and debugging runbooks live under `docs/guide/`.