alphaswarm-docs
The canonical AlphaSwarm documentation site. Docusaurus + Diátaxis structure, deployed to Cloudflare Pages. Survives cluster outages — the docs domain is intentionally provisioned outside the cluster so incident-time runbooks stay reachable.
Identity
| Field | Value |
|---|---|
| Service id | alphaswarm-docs |
| Role | docs |
| Package | alphaswarm_docs/ |
| Hosted on | Cloudflare Pages |
| Public URL | https://docs.alpha-swarm.ai |
Deployment surface
| Surface | Where |
|---|---|
| Terraform module | alphaswarm_platform/terraform/modules/cloudflare_pages_docs/ |
| Spec | alphaswarm_platform/configs/terraform/stacks/docs-edge.yaml |
| Build | pnpm build in alphaswarm_docs/ — Cloudflare Pages picks up the GitHub branch |
Agent surface
The site exposes structured endpoints for AI/MCP consumers:
/llms.txtand/llms-full.txt— convention-compliant index of the docs corpus./mcp— MCP server publishing the docs as searchable tool calls./openapi.json— OpenAPI surface for the MCP server.
Dependencies
Upstream: GitHub repo for build trigger; Cloudflare for edge hosting; OPA bundle (downloaded at deploy) for redaction policy on docs links to internal runbooks.
Downstream: browsers, AI agents, search crawlers.
Operations
- Deploy: every PR landing on
mainredeploys via Cloudflare Pages CI. Branch previews under*.alphaswarm-docs.pages.dev. - Custom domain:
docs.alpha-swarm.aimapped via thecloudflare_pages_docsTerraform module; certificate via Cloudflare's edge SSL. - Out-of-cluster: intentionally — docs live whatever the cluster is doing.
See also
alphaswarm-website.md— public marketing sibling atalpha-swarm.ai.alphaswarm-docs-archive.md— sunset API epochs atarchive.alpha-swarm.ai.alphaswarm-docs-status.md— incident status page.