"It gives me clarity over my own health."
Clarity's intelligence is built on a 100-triple knowledge graph organized into 5 domain clusters plus cross-cluster reasoning chains. The graph enables personalized, contextual guidance — not generic health information.
Every entity in the graph exists in relation to the user. Insurance plans only matter relative to a specific user's age, health status, income, and risk profile. This cluster defines who Clarity serves.
| # | Entity A | Relationship | Entity B |
|---|---|---|---|
| 1 | User | HAS | Insurance Plan |
| 2 | User | EARNS | Income Bracket |
| 3 | User | LIVES_IN | Location |
| 4 | User | HAS_CONDITION | Health Status |
| 5 | User | CAN_AFFORD | Monthly Premium |
This cluster maps the full complexity of insurance plan selection — the exact moment Clarity enters a user's life. HMO vs PPO vs HDHP, cost structures, networks, and employer context are all modeled here.
| # | Entity A | Relationship | Entity B |
|---|---|---|---|
| 6 | Insurance Plan | HAS_TYPE | HMO |
| 7 | Insurance Plan | HAS_TYPE | PPO |
| 8 | Insurance Plan | HAS_TYPE | HDHP |
| 9 | Insurance Plan | HAS_COST | Monthly Premium |
| 10 | Insurance Plan | HAS_COST | Deductible |
| 11 | Insurance Plan | HAS_COST | Copay |
| 12 | Insurance Plan | HAS_COST | Coinsurance |
| 13 | Insurance Plan | HAS_LIMIT | Out-of-Pocket Maximum |
| 14 | Insurance Plan | INCLUDES | In-Network Providers |
| 15 | Insurance Plan | EXCLUDES | Out-of-Network Providers |
| 16 | Insurance Plan | REQUIRES | Primary Care Physician |
| 17 | Insurance Plan | COVERS | Preventative Care |
| 18 | Insurance Plan | COVERS | Mental Health |
| 19 | Insurance Plan | COVERS | Prescriptions |
| 20 | Insurance Plan | COVERS | Emergency Care |
| 21 | Employer | CONTRIBUTES_TO | Monthly Premium |
| 22 | Employer | SETS | Enrollment Window |
| 23 | Employer | DEFINES | Waiting Period |
| 24 | HDHP | PAIRS_WITH | HSA Account |
| 25 | User | SELECTS | Insurance Plan |
After enrollment comes navigation. This cluster maps provider types, visit types, network status, and cost-at-point-of-care — enabling Clarity to guide users before they make expensive mistakes.
| # | Entity A | Relationship | Entity B |
|---|---|---|---|
| 26 | Care System | HAS_PROVIDER | Primary Care Physician |
| 27 | Care System | HAS_PROVIDER | Specialist |
| 28 | Care System | HAS_PROVIDER | Urgent Care |
| 29 | Care System | HAS_PROVIDER | Emergency Room |
| 30 | Care System | HAS_PROVIDER | Telehealth |
| 31 | Primary Care Physician | SERVES_AS | First Point of Contact |
| 32 | Specialist | REQUIRES | Referral (HMO) |
| 33 | Urgent Care | COSTS_LESS_THAN | Emergency Room |
| 34 | Telehealth | IS_COVERED_BY | Most Modern Plans |
| 35 | Visit Type | HAS_CATEGORY | Preventative |
| 36 | Visit Type | HAS_CATEGORY | Acute |
| 37 | Preventative Visit | IS_FREE_UNDER | ACA Guidelines |
| 38 | Acute Visit | TRIGGERS | Copay |
| 39 | Emergency Room Visit | TRIGGERS | Deductible |
| 40 | Provider | HAS_STATUS | In-Network |
| 41 | Provider | HAS_STATUS | Out-of-Network |
| 42 | In-Network Provider | COSTS_LESS_THAN | Out-of-Network Provider |
| 43 | HMO Plan | REQUIRES | Referral for Specialist |
| 44 | PPO Plan | ALLOWS | Direct Specialist Access |
| 45 | User | SHOULD_VERIFY | Network Status Before Visit |
Clarity doesn't wait for crisis. This cluster maps preventative events, acute events, life stage triggers, and data events — enabling proactive intervention at the right moment.
| # | Entity A | Relationship | Entity B |
|---|---|---|---|
| 46 | Health Event | HAS_TYPE | Preventative |
| 47 | Health Event | HAS_TYPE | Acute |
| 48 | Health Event | HAS_TYPE | Chronic |
| 49 | Preventative Event | PREVENTS | Acute Crisis |
| 50 | Annual Physical | IS_COVERED_AT | Zero Cost (ACA) |
| 51 | Blood Panel | DETECTS | Early Risk Indicators |
| 52 | Early Risk Indicator | TRIGGERS | Preventative Action |
| 53 | Preventative Action | COSTS_LESS_THAN | Crisis Treatment |
| 54 | Acute Event | TRIGGERS | Unplanned Spending |
| 55 | Mental Health Episode | IS_COVERED_BY | Modern Insurance Plans |
| 56 | Chronic Condition | REQUIRES | Ongoing Care Plan |
| 57 | Chronic Condition | INCREASES | Annual Healthcare Cost |
| 58 | Life Stage Trigger | REQUIRES | Insurance Re-evaluation |
| 59 | New Job | IS_A | Life Stage Trigger |
| 60 | Aging Out of Parent Plan | IS_A | Life Stage Trigger |
| 61 | Moving to New City | AFFECTS | Provider Network Access |
| 62 | EOB Received | REQUIRES | Plain Language Translation |
| 63 | Lab Result | REQUIRES | Contextual Explanation |
| 64 | Enrollment Window | HAS_DURATION | 2–3 Weeks |
| 65 | User | EXPERIENCES | Life Stage Trigger |
The financial layer is where the system most deliberately confuses people. Bills designed to obscure. EOBs that look like bills but aren't. Clarity's job here is radical transparency — translating every financial document into plain language.
| # | Entity A | Relationship | Entity B |
|---|---|---|---|
| 66 | Financial Document | HAS_TYPE | EOB |
| 67 | Financial Document | HAS_TYPE | Medical Bill |
| 68 | EOB | IS_NOT | Medical Bill |
| 69 | EOB | SHOWS | What Insurance Paid |
| 70 | Medical Bill | SHOWS | Patient Responsibility |
| 71 | Itemized Bill | CONTAINS | CPT Codes |
| 72 | CPT Code | REQUIRES | Plain Language Translation |
| 73 | Surprise Bill | VIOLATES | No Surprises Act (2022) |
| 74 | Patient Responsibility | EQUALS | Bill Minus Insurance Payment |
| 75 | User | HAS_RIGHT | Request Itemized Bill |
| 76 | Hospital | OFFERS | Financial Assistance Program |
| 77 | Financial Assistance | IS_UNKNOWN_TO | Most Patients |
| 78 | HSA | REQUIRES | HDHP Enrollment |
| 79 | HSA | PROVIDES | Triple Tax Advantage |
| 80 | FSA | HAS_RULE | Use It or Lose It |
| 81 | Medical Debt | CAN_AFFECT | Credit Score |
| 82 | Payment Plan | IS_AVAILABLE_AT | Most Hospitals |
| 83 | Payment Plan | IS_UNKNOWN_TO | Most Patients |
| 84 | User | SHOULD_NEGOTIATE | Medical Bill |
| 85 | Clarity | TRANSLATES | Financial Document → Plain Language |
These 15 triples are what transform Clarity from an information tool into a personalized reasoning engine. Each triple connects two or more clusters — producing insights no single cluster can generate alone.
| # | Entity A | Relationship | Entity B |
|---|---|---|---|
| 86 | User (healthy, low income) | SHOULD_SELECT | HDHP + HSA |
| 87 | User (chronic condition) | SHOULD_SELECT | PPO |
| 88 | User (new city) | MUST_REVERIFY | In-Network Providers |
| 89 | Life Stage Trigger | INITIATES | Full Plan Re-evaluation |
| 90 | Preventative Visit | REDUCES | Long-Term Financial Risk |
| 91 | Unmet Deductible | AFFECTS | Cost of Acute Visit |
| 92 | HSA Balance | OFFSETS | Out-of-Pocket Cost |
| 93 | Out-of-Network Visit | GENERATES | Surprise Bill Risk |
| 94 | Surprise Bill | TRIGGERS | No Surprises Act Protection |
| 95 | Mental Health Visit | IS_COVERED_EQUALLY | Physical Health Visit |
| 96 | Annual Physical | PREVENTS | Undetected Chronic Condition |
| 97 | Undetected Chronic Condition | INCREASES | Medical Debt Risk |
| 98 | Employer | FUNDS | Clarity Access |
| 99 | Clarity | BUILDS | User Health Literacy Over Time |
| 100 | Health Literate User | COSTS_LESS_THAN | Uninformed User (to employer) |
The knowledge graph is only as reliable as its assumptions. These are the open questions that could change the architecture, the business model, or the product strategy.
| # | Risk / Unknown | Impact | Mitigation |
|---|---|---|---|
| 1 | Will young adults trust an employer-funded health app with their data? | Core trust architecture assumption | Structural privacy design; legal firewall from employer |
| 2 | Does the employer actually care about benefits utilization — or just cost? | B2B2C sales motion | Unit economics proof: lower claims = lower premiums |
| 3 | Can AI reliably translate health/financial documents without error? | Product reliability + liability | Human consultant layer for high-stakes moments |
| 4 | How do we handle state-by-state insurance variation? | Knowledge graph scalability | Location entity in User cluster; state-specific ontology layer |
| 5 | What happens when Clarity's recommendation conflicts with the employer's cheapest plan? | Structural independence test | Fiduciary-like contractual duty to user; explicit in contract language |