Engineering documents

These documents are maintained in the source repository and are aimed at people operating or extending the platform:

Document	Contents
`docs/ARCHITECTURE.md`	Control plane, orchestrator and data flow.
`docs/ENTERPRISE_MULTI_TENANCY.md`	The org → project → environment → service model, roles and the gap audit.
`docs/AUTH_RUNBOOK.md`	Session format, GitHub OAuth debugging, key rotation.
`docs/MANAGED_RESOURCES.md`	How managed services are reconciled by the operator.
`docs/AI_AGENT.md`	Agent tool surface and approval protocol.
`docs/GITHUB_APP_SETUP.md`	Creating the GitHub App, permissions and webhook wiring.
`SETUP.md`	Bringing a new cluster up from scratch.

The console links to the sections that matter at the point of use — for example the project Environments tab and the Service accounts page.