Documentation Index
Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt
Use this file to discover all available pages before exploring further.
Architecture Decision Records
Architecture Decision Records (ADRs) capture the load-bearing decisions that shape Orbit’s architecture, billing posture, workflow, and compliance stance. Each ADR is short and factual; full operational context lives in the.serena/memories/ memos referenced at the end of each record.
The set exists because prior agent sessions repeatedly re-proposed reverting decisions that were already locked. Future agents (and humans) read this directory before proposing architectural change.
Status legend
- CURRENT — the decision is in force.
- SUPERSEDED-BY-ADR-XXX — replaced by a newer ADR.
- DEPRECATED — no longer in force; retained for audit trail.
Records
| ADR | Title | Status |
|---|---|---|
| 001 | Anthropic-only LLM stack with OpenAI carve-outs | CURRENT |
| 002 | Devotel softswitch is the sole outbound voice and SMS egress | CURRENT |
| 003 | Self-hosted orbit-media SFU replaces LiveKit Cloud | CURRENT |
| 004 | Pay-as-you-go end-to-end — no tiers, no subscriptions | CURRENT |
| 005 | BYO embedded-signup channels — no Orbit-side billing | CURRENT |
| 006 | Push (FCM) and Web Chat are always-free platform infrastructure | CURRENT |
| 007 | Single production environment — no dev / staging split | CURRENT |
| 008 | Direct-to-main workflow — no long-lived branches | CURRENT |
| 009 | Owner mode — Claude is technical owner; Erol is decision-maker | CURRENT |
| 010 | E911 block and disclaim — no PSAP routing pre-launch | CURRENT |
| 011 | Compliance gates default OFF; US TCPA voice is the only federal hard guard | CURRENT |
| 012 | Single Sentry project for all services | CURRENT |
| 013 | Design register — Modal / Resend / Stripe / Linear / Vercel | CURRENT |
| 014 | Playwright banned for routine UI verification | CURRENT |
| 015 | Migration prefix discipline — five grandfathered collisions | CURRENT |
Authoring guidance
When adding a new ADR:- Pick the next available NNN.
- Keep the body under ~200 words per the 2026 minimal-and-precise norm.
- Use the section structure: Context / Decision / Reason / Consequences / Source memos.
- Cross-link the relevant invariant numbers and Serena memos rather than duplicating their contents.
- If the new ADR supersedes an older one, update the older ADR’s status and add a
SUPERSEDED-BY-ADR-XXXline.
git log and is permanently navigable in the rendered docs site.