# ADR skill — architecture decisions (this repo)

Bluehand site architecture is documented under `docs/architecture/`.

## Primary ADR

- **ADR-001:** Hybrid site lanes — knowledge substrate first (`docs/architecture/ADR-001-hybrid-site-lanes.md` in repo; not a public HTML route)

## Rendering lanes (do not mix)

| Lane | Examples |
|------|----------|
| SPA + prerender shell | `/research/`, `/research/:slug/`, `/atlas/` |
| static-external | `/position-papers/*`, `/essays/*` |
| stakeholder | `/cto/`, `/researcher/`, … |
| evidence | `…/evidence/` companion routes |

## Substrate lanes (90-day)

1. Stakeholder landings
2. `registry.public.json`
3. Visual Atlas
4. Evidence publications
5. Agent-readable surfaces (this file set)

## When to write an ADR

- Cross-lane boundary changes
- New canonical discovery surfaces
- Framework migration proposals (default: defer)

Agents: read `AGENTS.md` before deploy or registry edits.