| SYSTEM.md | the whole system: repos, hosts, apps, market protocol, guests, identity, ssh gateway, atirc, tenant clusters, records policy, deploy |
| QUICKSTART.md | index of the two quickstarts; examples in ../examples/infra |
| quickstart-local.md | own market network: clone -> dev up -> kubectl apply Infra / EphemeralInfra: VM, tenant k8s, Deno sandbox, agent VM up to the mint |
| quickstart-prod.md | prod bidders: vouches, browser page kubectl, CLI per contract, atirc agent join, prod gateway clusters, the long-lived requester (run requester, install requester, --with-gateway tenant clusters; plan 0039) |
| protocol/README.md | the atproto protocol: every lexicon (NSID families), how and when each is used, the end-to-end sequence sign-in -> trust -> RFP -> guest -> agent -> release |
| KCP.md | how every app uses kcp: profiles, slots/front/kine, workspaces, exports, bindings, component runtime, controllers, full API catalog, schema revisions, apigen |
| ARCHITECTURE.md | decisions, measurements, invariants. open a section by heading; do not read end to end |