# docs
Documentation
Eight documents, generated from the repo at build time. Start with Getting started.
# getting-startedGetting startedFrom a fresh clone to a running RaySpec backend and a real authenticated request — install, mint the boot secrets, author and validate a spec, boot the platform.# conceptsConceptsThe mental model behind RaySpec — what each moving part is and why it exists: the declarative spec, tenancy, stores, agents, tools, capabilities, durable execution.# architectureArchitectureHow RaySpec turns one declarative spec into a running, tenant-isolated AI backend: the layered spine, the three structural guarantees, the security model.# spec-referenceSpec referenceThe complete authoring reference for the RaySpec spec — the one declarative language you write to describe a backend, field by field.# cli-referenceCLI referenceThe RaySpec executables and their commands — doctor, plan, deploy, dev tooling, openapi — plus rayspec-serve, the boot server.# v1-posturev1 postureRaySpec v1 serves a deliberately narrow, closed declarative surface — what v1 is built for (trusted, self-hosted, single-node) and what it is not.# security-policySecurity policyHow to report a security vulnerability in RaySpec privately (security@rayspec.dev) — and the hardening posture of the core.# contributingContributingThe toolchain, the local workflow, the standards a change is held to, and the licensing terms for contributions to RaySpec.