A precision-health intake engine, built end to end
Reveal Health — The Nervous System Questionnaire
Turns a patient's own answers and lab work into a plain-English picture of how their body is actually running — so 'something is wrong with me' becomes 'here's the part that needs help.'
The problem
Patients dread intake. You fill out the clipboard, hand it over, and hope the time you just spent adds up to something — you never really know where the data goes or what it's for. And what comes back is a label, not an understanding. Two people arrive with the same wound: the adult who's been told their whole life they're lazy, and the parent fighting to prove their kid isn't a behavior problem. A box of checkboxes gives them a category that lands as judgment. They leave knowing what they're called, not what's happening inside them. And for the clinic, every intake is hours of manual work that teaches the patient nothing before they even walk in.
The approach
Use AI only where it's genuinely better — and keep it out of every place a health decision can't afford a guess.
The clinical scoring is plain, auditable code — no model deciding anything that matters. The AI is fenced to the two jobs it's actually best at: reading a real, messy lab report, and turning cold clinical facts into language a person can feel. A human confirms every number before it counts. In health, knowing where to keep the model out is the whole game.
What I built
- A humane intake — 52 questions in plain, human language, no jargon and no checkboxes that feel like a test, with the tone set by whether an adult or a parent is answering.
- A lab reader — the patient uploads their actual lab PDF, and the AI pulls every marker, maps each to a plain-English name and an optimal range, ready for the person to confirm.
- A report that mirrors the body back — an archetype, a body map, and the top overloads, written so a person sees themselves in their own data instead of a diagnosis they can't parse.
- A clinician's page — the same data, print-ready, so the provider reviews the whole picture in a few minutes instead of the full manual workup.
- A health journey over time — every intake and lab result tracked visit over visit, so the patient can see the positive changes as they happen.
What it proves
AI only where it earns its place
The clinical scoring — archetypes, bottlenecks, biomarker ranges — is plain, auditable code with no model in the loop. Knowing where not to let a model improvise is the architecture decision most teams get wrong.
It reads real, messy lab reports
The vision model reads a patient's actual lab PDF and returns structured numbers — and recognizes which markers are missing. It's built to return 'not found' rather than guess a value.
The person stays in charge
Every extracted number lands in an editable table to confirm before anything is committed. The AI accelerates the work; the human keeps authority. That's the only trust model that belongs near health data.
It never guesses about your health
If labs are missing, the system shows an honest 'Visibility Gap' instead of inventing a story. The rule, written into the system: don't guess the value — note the absence.
Why this is rare
The hard part isn't adding AI — it's knowing where to keep it out. Most consultants would wrap a chatbot around a health intake and call it innovation. In a clinical setting, that's how you get confident, wrong answers. I built the opposite: AI fenced to what it's genuinely good at, plain auditable code for every decision that matters, and a human in command.
Under the hood
Core & AI
- Claude (vision + reasoning)
- Multi-model orchestration
- Deterministic scoring engines
Application
- Next.js 16
- TypeScript (strict)
- Server Actions
State & Verification
- Persisted state
- Versioned migrations
- CLI test scripts