llms.txt@scaffold/acme_root git:20261014.fec008fA

Immutable. This exact content never changes and is served at /api/v1/blob/2f6399c593e7c135.

# Acme

> The domain-agnostic core of a multi-tenant system, in the shape of the Software Design and Architecture Guidelines: one object model at the center, one infrastructure toolkit beside it, the processes around them, and the apps and clients at the edge. A product renames it and builds its domain on top.

This file is the knowledge map. Each section lists the documents one
audience is served; a document not listed under an audience is not
served to it. Exposure is by listing, never by folder.

## System developers

- [README](README.md): what Acme is, the quick start, set up and check, deploy and operate, and the layout
- [Architecture](specs/architecture.md): the guideline's pin, the substitutions, and the deviations, each linking its decision record under docs/adr/
- [Decisions](docs/adr/README.md): how a decision is recorded and numbered, and how a copy extends one the scaffold gave
- [What Acme is made of](om/README.md): the nouns and how they relate, for a reader with no code
- [Tenancy](om/src/acme/om/tenancy/README.md): orgs, identities, users, memberships, invitations, auth sessions, API keys, socket tickets, the operator plane, and deletion
- [Change events](om/src/acme/om/change_events/README.md): the org's stream, its gapless sequence above a floor, and audit entries
- [Outbox rows](om/src/acme/om/outbox/README.md): the note written beside every change, and its relay
- [Idempotency records](om/src/acme/om/idempotency/README.md): the outcome of a request that may arrive twice
- [Work items](om/src/acme/om/work/README.md): background jobs, the claim, the lease, and the dead letter
- [Orchestrations](om/src/acme/om/orchestrations/README.md): long-running records, a step at a time, that park or fail
- [Leases](om/src/acme/om/leases/README.md): a leasable resource one holder uses at a time, its lease under a fencing token, and the wait line in front of it
- [Files](om/src/acme/om/media/README.md): files as references, the bounded upload straight to the store, and the sweep
- [Infrastructure](infra/README.md): the capabilities the system asks for, what each promises, and which twin runs where
- [Integrations](integrations/README.md): the outside providers, their twins, the absent provider, and the webhook check
- [The API process](services/api/README.md): where each namespace's routes are, the gateway's guarantees, the subcommands
- [The maintenance worker](workers/maintenance/README.md): the work queue's loop, the provider deliveries, and the sweep
- [Deployment](deployment/README.md): what runs where, locally and in the cloud, and the branch convention
- [The local stack](deployment/local/README.md): every URL and port, one service at a time
- [Terraform](deployment/terraform/modules/README.md): the roots, the modules, the state, and the credentials
- [Cloud cost](deployment/cloud/README.md): the sizes, each environment's size, and the budgets
- [Operations](ops/README.md): roles, profiles, credentials, signals, the ops binary, the skills, the audits
- [Audit tools](ops/audit/README.md): what the audit skills run
- [Stress tests](ops/stress/README.md): what a good one is and the scenario file
- [Runbooks](docs/runbooks/README.md): one file per operational procedure
- [The portal](apps/portal/README.md): the browser app shell
- [The company site](apps/site/README.md): the static page and where it is served
- [The command line](apps/cli/README.md): the terminal client and its exit codes
- [The TypeScript client](clients/typescript/README.md): the one client every browser app imports
- [The Python client](clients/python/README.md): the one client every Python caller goes through
<!-- A copy adds its entries below this line. -->

## System operators

- [Operations](ops/README.md): roles, profiles, credentials, signals, the ops binary, the skills, the audits, what an operator never does
- [Audit tools](ops/audit/README.md): what the audit skills run
- [Stress tests](ops/stress/README.md): what a good one is and the scenario file
- [Runbooks](docs/runbooks/README.md): one file per operational procedure
- [Deploy runbook](docs/runbooks/deploy.md): creating an environment, cutting a release, approving a plan, rolling back
- [Operate runbook](docs/runbooks/operate.md): reading an environment under the investigate profile
- [Operator runbook](docs/runbooks/operator.md): the grant, the second factor, and the operator token
- [Scale runbook](docs/runbooks/scale.md): the one variable that turns autoscaling on
- [Restore runbook](docs/runbooks/restore.md): what is backed up, and a restore to a new instance
- [Support runbook](docs/runbooks/support.md): how a support investigation runs
- [Tenant isolation runbook](docs/runbooks/tenant-isolation.md): the cross-tenant cases and what they catch
- [WorkOS runbook](docs/runbooks/providers/workos.md): the identity provider for a newcomer: its environments, the application and its key, the redirects, the webhook, the bootstrap, and rotation
- [LaunchDarkly runbook](docs/runbooks/providers/launchdarkly.md): the flag provider: how a rule reaches an org or a person, the SDK key, the switch from none, and what breaks
- [Deployment](deployment/README.md): what runs where, locally and in the cloud, and the branch convention
<!-- A copy adds its entries below this line. -->

## Tenant users and admins

- [What Acme is made of](om/README.md): the nouns and how they relate, for a reader with no code
- [Tenancy](om/src/acme/om/tenancy/README.md): orgs, people, roles, invitations, single sign-on, credentials, deleting a team org you own, and deleting your account
- [Files](om/src/acme/om/media/README.md): the files an org keeps, their bounds, and the storage used
- [Change events](om/src/acme/om/change_events/README.md): the org's diary
- [The command line](apps/cli/README.md): the terminal client and its exit codes
<!-- A copy adds its entries below this line. -->