CLARITY

Knowledge Architecture + Verification Document
"It gives me clarity over my own health."
Sessions 4–5  ·  AI-Accelerated Entrepreneurship Practicum  ·  Owen School of Management  ·  Spring 2026

Venture Overview

Clarity is a health navigation companion that guides young adults through the complexity of the American healthcare system — entering at the moment of highest confusion: first open enrollment at a new employer.

Problem
Health system complexity + learned helplessness at first independent enrollment
User
Young adults entering the workforce — first job, first time choosing their own plan
Entry Point
Open enrollment window — 2–3 weeks, no extensions, maximum confusion
Product
App-first companion + on-demand human consultant for high-stakes moments
Business Model
B2B2C — employer pays, employee trusts. Structurally independent from employer
Moat
Structural privacy firewall — health data never touches employer systems

Knowledge Graph — 100 Triples

Clarity's intelligence is powered by a 100-triple domain knowledge graph organized into 5 entity clusters plus 15 cross-cluster reasoning chains. The graph is user-centered — every entity exists in relation to one specific person's situation.

👤
User
Triples 1–5
📋
Insurance
Triples 6–25
🏥
Care System
Triples 26–45
💊
Health Events
Triples 46–65
💰
Financial
Triples 66–85
🔗
Cross-Cluster
Triples 86–100

👤 User — Triples 1–5

#Entity ARelationshipEntity B
1UserHASInsurance Plan
2UserEARNSIncome Bracket
3UserLIVES_INLocation
4UserHAS_CONDITIONHealth Status
5UserCAN_AFFORDMonthly Premium

📋 Insurance Plans — Triples 6–25

#Entity ARelationshipEntity B
6Insurance PlanHAS_TYPEHMO
7Insurance PlanHAS_TYPEPPO
8Insurance PlanHAS_TYPEHDHP
9Insurance PlanHAS_COSTMonthly Premium
10Insurance PlanHAS_COSTDeductible
11Insurance PlanHAS_COSTCopay
12Insurance PlanHAS_COSTCoinsurance
13Insurance PlanHAS_LIMITOut-of-Pocket Maximum
14Insurance PlanINCLUDESIn-Network Providers
15Insurance PlanEXCLUDESOut-of-Network Providers
16Insurance PlanREQUIRESPrimary Care Physician
17Insurance PlanCOVERSPreventative Care
18Insurance PlanCOVERSMental Health
19Insurance PlanCOVERSPrescriptions
20Insurance PlanCOVERSEmergency Care
21EmployerCONTRIBUTES_TOMonthly Premium
22EmployerSETSEnrollment Window
23EmployerDEFINESWaiting Period
24HDHPPAIRS_WITHHSA Account
25UserSELECTSInsurance Plan

🏥 Care System — Triples 26–45

#Entity ARelationshipEntity B
26Care SystemHAS_PROVIDERPrimary Care Physician
27Care SystemHAS_PROVIDERSpecialist
28Care SystemHAS_PROVIDERUrgent Care
29Care SystemHAS_PROVIDEREmergency Room
30Care SystemHAS_PROVIDERTelehealth
31Primary Care PhysicianSERVES_ASFirst Point of Contact
32SpecialistREQUIRESReferral (HMO)
33Urgent CareCOSTS_LESS_THANEmergency Room
34TelehealthIS_COVERED_BYMost Modern Plans
35Visit TypeHAS_CATEGORYPreventative
36Visit TypeHAS_CATEGORYAcute
37Preventative VisitIS_FREE_UNDERACA Guidelines
38Acute VisitTRIGGERSCopay
39Emergency Room VisitTRIGGERSDeductible
40ProviderHAS_STATUSIn-Network
41ProviderHAS_STATUSOut-of-Network
42In-Network ProviderCOSTS_LESS_THANOut-of-Network Provider
43HMO PlanREQUIRESReferral for Specialist
44PPO PlanALLOWSDirect Specialist Access
45UserSHOULD_VERIFYNetwork Status Before Visit

💊 Health Events — Triples 46–65

#Entity ARelationshipEntity B
46Health EventHAS_TYPEPreventative
47Health EventHAS_TYPEAcute
48Health EventHAS_TYPEChronic
49Preventative EventPREVENTSAcute Crisis
50Annual PhysicalIS_COVERED_ATZero Cost (ACA)
51Blood PanelDETECTSEarly Risk Indicators
52Early Risk IndicatorTRIGGERSPreventative Action
53Preventative ActionCOSTS_LESS_THANCrisis Treatment
54Acute EventTRIGGERSUnplanned Spending
55Mental Health EpisodeIS_COVERED_BYModern Insurance Plans
56Chronic ConditionREQUIRESOngoing Care Plan
57Chronic ConditionINCREASESAnnual Healthcare Cost
58Life Stage TriggerREQUIRESInsurance Re-evaluation
59New JobIS_ALife Stage Trigger
60Aging Out of Parent PlanIS_ALife Stage Trigger
61Moving to New CityAFFECTSProvider Network Access
62EOB ReceivedREQUIRESPlain Language Translation
63Lab ResultREQUIRESContextual Explanation
64Enrollment WindowHAS_DURATION2–3 Weeks
65UserEXPERIENCESLife Stage Trigger

💰 Financial — Triples 66–85

#Entity ARelationshipEntity B
66Financial DocumentHAS_TYPEEOB
67Financial DocumentHAS_TYPEMedical Bill
68EOBIS_NOTMedical Bill
69EOBSHOWSWhat Insurance Paid
70Medical BillSHOWSPatient Responsibility
71Itemized BillCONTAINSCPT Codes
72CPT CodeREQUIRESPlain Language Translation
73Surprise BillVIOLATESNo Surprises Act (2022)
74Patient ResponsibilityEQUALSBill Minus Insurance Payment
75UserHAS_RIGHTRequest Itemized Bill
76HospitalOFFERSFinancial Assistance Program
77Financial AssistanceIS_UNKNOWN_TOMost Patients
78HSAREQUIRESHDHP Enrollment
79HSAPROVIDESTriple Tax Advantage
80FSAHAS_RULEUse It or Lose It
81Medical DebtCAN_AFFECTCredit Score
82Payment PlanIS_AVAILABLE_ATMost Hospitals
83Payment PlanIS_UNKNOWN_TOMost Patients
84UserSHOULD_NEGOTIATEMedical Bill
85ClarityTRANSLATESFinancial Document → Plain Language

🔗 Cross-Cluster Reasoning — Triples 86–100

#Entity ARelationshipEntity B
86User (healthy, low income)SHOULD_SELECTHDHP + HSA
87User (chronic condition)SHOULD_SELECTPPO
88User (new city)MUST_REVERIFYIn-Network Providers
89Life Stage TriggerINITIATESFull Plan Re-evaluation
90Preventative VisitREDUCESLong-Term Financial Risk
91Unmet DeductibleAFFECTSCost of Acute Visit
92HSA BalanceOFFSETSOut-of-Pocket Cost
93Out-of-Network VisitGENERATESSurprise Bill Risk
94Surprise BillTRIGGERSNo Surprises Act Protection
95Mental Health VisitIS_COVERED_EQUALLYPhysical Health Visit
96Annual PhysicalPREVENTSUndetected Chronic Condition
97Undetected Chronic ConditionINCREASESMedical Debt Risk
98EmployerFUNDSClarity Access
99ClarityBUILDSUser Health Literacy Over Time
100Health Literate UserCOSTS_LESS_THANUninformed User (to employer)
Health Literate User COSTS_LESS_THAN Uninformed User
Triple 100 — The Business Case in One Line

Entity Linking — Ontology Grounding

Entity linking proves that Clarity's knowledge graph is grounded in real-world standards — not invented terminology. Each key entity is mapped to an authoritative ontology, making the graph interoperable, verifiable, and trustworthy.

Why This Matters for Clarity
Clarity's AI doesn't invent health information — it traverses grounded triples.
Every entity links to a federal standard, clinical ontology, or legal framework.
This is what makes Clarity's guidance trustworthy — not just plausible.

AI Reliability Analysis

Where will Clarity's AI get things wrong — and what happens when it does? This analysis maps the highest-risk failure modes, their triggers, and the mitigation architecture built into Clarity's design.

Failure ModeHow It HappensSeverityMitigation
Plan Recommendation Error AI recommends HDHP to user with undiagnosed chronic condition — based on incomplete health history Critical Human consultant escalation for any recommendation involving chronic risk; disclaimer on all plan suggestions
Network Status Hallucination AI states a provider is in-network based on stale training data — user gets surprise bill Critical Real-time FHIR network API lookup required; no static assertions about network status
CPT Code Mistranslation AI translates CPT code incorrectly — user believes they were billed for wrong procedure High CPT translations sourced from AMA database, not LLM generation; human review for disputed bills
State-Specific Rule Errors AI applies federal ACA rules without accounting for state-level variation in Medicaid, mandates, or plan types High User.location entity used to route to state-specific rule layer; 50-state regulatory index required
Financial Assistance Gaps AI fails to surface hospital charity care programs because they are not in training data High RAG pipeline with live hospital financial assistance database; not LLM parametric knowledge
Confident Hedging on Legal Rights AI softens user's legal rights (No Surprises Act, itemized bill right) to avoid sounding prescriptive High Legal rights stored as hard assertions in KG — not LLM-generated; output templated not generated
Deductible Math Errors AI miscalculates remaining deductible, OOP max, or HSA contribution limit High Financial calculations handled by deterministic code, not LLM; LLM only provides explanation layer
Emotional Tone Mismatch AI delivers bad news (high bill, denied claim) with incorrect emotional register — too clinical or too casual Medium Tone calibration layer in prompt architecture; human consultant available for high-stress moments
Clarity's AI Safety Architecture — Three Layers
Layer 1 — Grounded KG: All factual assertions sourced from ontology-linked triples, not LLM parametric memory
Layer 2 — Deterministic Logic: Financial calculations, legal rights, network status = code, not generation
Layer 3 — Human Escalation: Any recommendation involving chronic conditions, disputed bills, or denied claims → human consultant
The rule: AI explains. Humans decide.
Clarity never tells you what to do — it gives you what you need to choose.
AI Reliability Principle — Clarity v1.0

What We Don't Know — Risk Analysis

The knowledge graph and AI architecture are strong. These are the open questions that still need answers before Clarity ships.

#Open QuestionImpactMitigation Path
1Will young adults trust an employer-funded health app with their personal data?Core trust architecture assumptionStructural privacy firewall; independent data store; explicit user consent flow
2Does giving personalized plan recommendations trigger insurance advisor licensing?Legal/regulatory exposureLegal review; "guidance not advice" framing; human consultant as licensed layer
3How do we handle 50-state insurance regulation variation at scale?Knowledge graph completenessState-specific regulatory layer; location-aware routing in KG
4What happens when Clarity's recommendation conflicts with the employer's cheapest plan?Structural independence testFiduciary-like duty to user written into employer contract language
5Can we source and scale high-quality on-demand health consultants?Human layer quality + liabilityCredentialing framework; scope of practice guidelines; malpractice clarity