> ## 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.

# Insurance 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 policy, premium, and claims data — and th…

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 policy, premium, and claims data — and the model grows itself as I work"* — mostly without leaving the Ana chat window.

The **P\&C Insurance Starter Pack** is a **document of domain expertise** over carrier data — policyholders, policies, coverage, premium (written vs. earned), claims, claim transactions, reserves, loss and combined ratios, frequency, severity, retention, and production. It's **just files** (Markdown + `.tql`) in a git repo: [`TextQLLabs/ontology-starter-kits/tree/main/insurance`](https://github.com/TextQLLabs/ontology-starter-kits/tree/main/insurance) — **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 by naming your **North Star** — what someone does differently on Monday when this works — and in **Module 1** Ana looks at your actual data and drafts it with you. 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/insurance/NORTH_STAR.md) is your starting point.)
</Warning>

## What you'll do

<CardGroup cols={2}>
  <Card title="Set your North Star">Name what the ontology is for — what someone does differently on Monday morning.</Card>
  <Card title="Tour the six layers">Entity spine, metrics, classification, governance, decisions, validation.</Card>
  <Card title="Define your North Star">Ana reads your data, runs the scoping conversation, and drafts north\_star.md with you.</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 settles the policy/coverage/claim/transaction grain — then opens the fix as a PR.</Card>
  <Card title="Light up the classification">NAIC line-of-business and peril/cause-of-loss rollups — zero warehouse writes.</Card>
  <Card title="Ask governed questions">Loss ratio, combined ratio, frequency, severity, reserves, retention — with the SQL shown.</Card>
  <Card title="Govern & customize">Fair-pricing & PII defaults, golden values, and making the definitions yours.</Card>
</CardGroup>

<Note>
  **What ships in the box** — **Free / public-domain classification** (the NAIC line-of-business taxonomy, a peril/cause-of-loss grouping with a catastrophe flag, FIPS/ISO 3166 geography) is in the repo — yours to keep and extend. Licensed systems (ISO peril and rating-territory codes, PCS catastrophe codes) are modeled **structurally**; their data is **sourced from your own licensed feed** and joined by code. See [`LICENSING.md`](https://github.com/TextQLLabs/ontology-starter-kits/blob/main/insurance/LICENSING.md).
</Note>

<Note>
  **No customer data — ever** — The starter is built entirely from public standards (NAIC / ACORD / FIBO / FIPS) and a generic reference model. 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/insurance-starter/ana-runner.md) and paste its module list instead.)*
</Note>

```text Run with Ana theme={null}
Hey Ana — facilitate the "P&C Insurance Starter" workshop with me in this thread, on the data connected here. Pull the steps from https://textqllabs.github.io/workshops/insurance-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%22P%26C%20Insurance%20Starter%22%20workshop%20with%20me%20in%20this%20thread%2C%20on%20the%20data%20connected%20here.%20Pull%20the%20steps%20from%20https%3A//textqllabs.github.io/workshops/insurance-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/insurance-starter/ana-runner.md) instead.)
