> ## Documentation Index
> Fetch the complete documentation index at: https://docs.textql.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Healthcare Starter Pack

> A hands-on workshop that takes you from "I have this ontology repo and nothing else" to "I’m asking Ana governed questions about my own claims and clinical data — and the model …

A hands-on workshop that takes you from *"I have this ontology repo and nothing else"* to *"I'm asking Ana governed questions about my own claims and clinical data — and the model grows itself as I work"* — mostly without leaving the Ana chat window.

The **Healthcare & Life Sciences Starter Pack** is a **document of domain expertise** over healthcare data — members, claims, encounters, diagnoses, procedures, drugs, cost, utilization, quality, and risk. It's **just files** (Markdown + `.tql`) in a git repo: [`TextQLLabs/ontology-starter-kits/tree/main/healthcare`](https://github.com/TextQLLabs/ontology-starter-kits/tree/main/healthcare) — **your TextQL team grants access and sets up your own fork** (your adaptations live in your fork; the template stays pristine).

<Warning>
  **This is not a form to fill out** — The starter is a **warm start, not a finished model to deploy**. Treating it as "close enough" and shipping it is the fastest way to build a model nobody trusts. So we begin in Module 0 by naming your **North Star** — what someone does differently on Monday when this works — then let the model **accrete from real questions**: Ana reads what's known, explores only the frontier, answers, and proposes additions back as git commits you review. (The repo's [`NORTH_STAR.md`](https://github.com/TextQLLabs/ontology-starter-kits/blob/main/healthcare/NORTH_STAR.md) is your starting point — and in Module 1, Ana drafts your North Star from your own data.)
</Warning>

## What you'll do

<CardGroup cols={2}>
  <Card title="Set your North Star">Name what the ontology is for — Ana scans your data and drafts it; you confirm.</Card>
  <Card title="Tour the six layers">Entity spine, metrics, terminology, governance, decisions, validation.</Card>
  <Card title="Connect three things">The ontology repo, your warehouse (read-only), your documents.</Card>
  <Card title="Validate against your schema">Ana diffs the model vs. your tables and opens the fix as a PR.</Card>
  <Card title="Light up the terminology">ICD-10 groupers, HCC/RAF, chronic conditions — zero warehouse writes.</Card>
  <Card title="Ask governed questions">Prevalence, PMPM, readmissions, utilization, risk — with the SQL shown.</Card>
  <Card title="Govern & customize">PHI defaults, golden queries, and making the definitions yours.</Card>
</CardGroup>

<Note>
  **What ships in the box** — **Free / public-domain code systems and groupers** (ICD-10-CM/PCS, ICD-9 + GEMs, HCPCS, NDC, RxNorm, MS-DRG/APC, CCSR, CMS-HCC, CCW chronic) are in the repo — yours to keep and extend. Licensed systems (CPT, SNOMED, LOINC) are modeled **structurally**; certified VSAC value sets are **fetched with your own UMLS key**.
</Note>

<Note>
  **No customer data — ever** — The starter is built entirely from public standards (CMS / AHRQ / US Census). Connecting it never uses your data to improve the template; it runs **read-only**, and your adaptations live in **your own repo**, never back in the template.
</Note>

<Accordion title="For facilitators — running this as a guided session">
  **T-minus-1-day pre-flight:** run the workshop's key prompts end-to-end in the session workspace — confirm logins, connectors, and the features this workshop touches are enabled for every attendee; have a fallback demo workspace ready in case a customer connector fails live. **Pacing:** when a long prompt is running (2–4 min), fire it first, then discuss the concept while Ana works — never watch a spinner in silence. If behind schedule, cut sections marked optional, never the checkpoints. **Group sessions:** attendees drive, you narrate; collect every miss or wrong answer in a shared doc — that list is the ontology backlog. With 10+ attendees on one warehouse, stagger the heavy prompts.
</Accordion>

<Note>
  **🤖 Prefer to have Ana run this workshop?** Open a thread with your data connected and paste the prompt below — Ana walks you through it on your own data, one step at a time. You run each prompt; she coaches. *(Air-gapped / VPC tenants where Ana can't reach the web: download [`ana-runner.md`](https://github.com/TextQLLabs/workshops/blob/main/healthcare-starter/ana-runner.md) and paste its module list instead.)*
</Note>

```text Run with Ana theme={null}
Hey Ana — facilitate the "Healthcare Starter" workshop with me in this thread, on the data connected here. Pull the steps from https://textqllabs.github.io/workshops/healthcare-starter/ and run it interactively: look at my data first (2–3 lines), then go ONE module at a time. For each module, give ME the prompt to copy and run as my next message, tell me what to look for, then wait and coach me on my result. Start with what you see, then Module 0.
```

[**▶ Open in Ana — prompt loaded**](https://app.textql.com/chat/new?prefill=Hey%20Ana%20%E2%80%94%20facilitate%20the%20%22Healthcare%20Starter%22%20workshop%20with%20me%20in%20this%20thread%2C%20on%20the%20data%20connected%20here.%20Pull%20the%20steps%20from%20https%3A//textqllabs.github.io/workshops/healthcare-starter/%20and%20run%20it%20interactively%3A%20look%20at%20my%20data%20first%20%282%E2%80%933%20lines%29%2C%20then%20go%20ONE%20module%20at%20a%20time.%20For%20each%20module%2C%20give%20ME%20the%20prompt%20to%20copy%20and%20run%20as%20my%20next%20message%2C%20tell%20me%20what%20to%20look%20for%2C%20then%20wait%20and%20coach%20me%20on%20my%20result.%20Start%20with%20what%20you%20see%2C%20then%20Module%200.)

Ana fetches the steps from the link — no copy/paste of the workshop needed. (Air-gapped / VPC tenants where Ana can't reach the web: paste the module list from this workshop's [ana-runner.md](https://github.com/TextQLLabs/workshops/blob/main/healthcare-starter/ana-runner.md) instead.)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.