# 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/`.
