Ready Practice — Company Handbook
This is the operating system for the company: how the product works, how the code is built, how we run operations, what we charge, how we grow, how we speak, and what we learn from clinics. One place, written for humans.
- Handbook (you are here,
/handbook) — internal. For the team. - Product Docs — customer-facing onboarding for clinicians.
Both are generated from the same repository. The deep engineering docs under
Canonical Reference are synced verbatim from docs/claude/
and the repo root — edit the source, not the copy. See How this is maintained.
What Ready Practice is
Ready Practice (internal name Basis) is a production, multi-tenant healthcare operations platform serving hundreds of clinics and tens of thousands of patients. It gives a clinic everything to run: scheduling, memberships, client management, labs, insurance/RCM billing, payments, a white-label mobile app + client web portal, and Atlas — the AI copilot, clinical assistant, consumer Health Assistant, and autonomous COO/operator.
| Surface | Public name | Stack | Who uses it |
|---|---|---|---|
| Basis Flow Web | Ready Practice Platform | Next.js | Clinic staff |
| Basis Hybrid | Ready Practice App | Flutter | Patients (white-labeled per clinic) |
| Basis Web | Client Portal | Next.js | Patients (web) |
| basis-functions | — | Python Cloud Functions | Shared backend |
Handbook map
| Section | What's in it |
|---|---|
| How we work | Worktrees, the task board, ship pipeline, autonomy loop |
| Knowledge Base vision | Where docs + retrieval + Atlas are heading (the thesis behind this site) |
| Product | Features, the four surfaces, capability map |
| Engineering | Architecture, backend, Firestore, deploy, the non-negotiable rules |
| Operations | The agent fleet, monitoring, runbooks, incidents |
| Atlas & AI | The AI system: copilot, consumer, operator, model tiers |
| Growth & GTM | The growth engine, content loop, go-to-market principles |
| Business & Numbers | Pricing, margins, ARR targets, unit economics |
| Brand & Voice | Identity, naming, how Atlas and the company speak |
| Security & Compliance | HIPAA, PHI handling, SOC2, Trust Center |
| Client Learnings | What individual clinics teach us |
Every section states what is real and sourced and flags what is a gap (⚠️). We do not paper over missing content with plausible-sounding filler — a fabricated page reads as "done" when it isn't, and that is how fake features are born. If a section is thin, it says so and links the work that would fill it.