Medical Protocol

Turns AI coding agents into clinical software engineers.

A workflow system that gives Claude Code the domain knowledge, verification tools, and privacy guardrails to build medical software correctly.

The Problem

AI generates medical calculators but can't verify clinical math.

Edge cases fail silently. A Winters formula off by 0.3 won't throw an error — but it changes the clinical decision. LLMs don't know what they don't know.

How It Works

Three steps.

1

Install

Paste the protocol URL into Claude Code. It fetches workflows, skills, and CLI tools automatically.

2

Describe

Tell the agent what you need in clinical language. “I need an acid-base interpreter with compensation checks.”

3

Verify

The agent cross-checks every calculation against the medprotocol CLI — 1,198 test assertions run at build time.

Domain Skills

14 clinical workflows.

Each skill encodes domain-specific knowledge — formulas, edge cases, clinical thresholds, and UI patterns.

🫁Acid-Base
💧Fluids & Electrolytes
🫘Nephrology / CKD
❤️Cardiology
🦠Sepsis
🩸Hematology
💊Pharmacology
🧪Laboratory
🫀Hemodynamics
🧠Neurology
🍽️Nutrition
🏥ICU Scoring
📋Clinical Records
📊Vital Signs

CLI Verification

The agent doesn't trust itself. It verifies.

9 clinical calculators with deterministic outputs. The agent runs medprotocol CLI, compares against the UI, and flags discrepancies.

Agent builds UI
Browser render
CLI cross-check
npx medprotocol
Result
✓ Match

Test Coverage

1,198
test assertions across 22 suites

Every formula edge case. Every compensation threshold. Every unit conversion. Validated at build time before any component ships.

Architecture

Built for privacy and correctness.

🔒

Privacy Hooks

Pre-tool hooks block patient data from leaving the machine. Zero external API calls with PHI.

Build-time Validation

TypeScript strict mode + CLI tests run before deploy. Runtime errors caught before they reach patients.

📦

npx Install Model

Components installed via CLI — no manual wiring. Dependency graph resolved automatically.

🛡️

TypeScript Strict

Full strict mode across all components. No implicit any, no unchecked nulls.

Who It's For

Medical professionals who want software that works.

Intensivists building bedside toolsNephrologists tracking CKD progressionResidents learning clinical decision-makingAny clinician tired of unreliable calculators
View on GitHub →