docs: update harrier README to government forms (was stale insurance content from pre-rename)

This commit is contained in:
pyr0ball 2026-05-11 06:26:50 -07:00
parent 6a08b27e14
commit 409a2bbad9

View file

@ -1,4 +1,4 @@
# Harrier — Insurance Navigation # Harrier — Government Forms & Benefits Navigation
> *Part of the Circuit Forge LLC "AI for the tasks you hate most" suite.* > *Part of the Circuit Forge LLC "AI for the tasks you hate most" suite.*
@ -6,33 +6,33 @@
## What it does ## What it does
Harrier handles the full insurance fight: prior authorization tracking, claim dispute drafting, EOB (Explanation of Benefits) reconciliation, internal and external appeal letters, and state insurance commissioner complaints. Harrier guides you through government forms and benefit applications — translating bureaucratic requirements into plain language, pre-filling what it can, and tracking deadlines so nothing lapses. Covers benefits, FAFSA, immigration paperwork, and permit processes.
The harrier is low, fast, and persistent — exactly what fighting a denied claim requires. The harrier is low, fast, and persistent — exactly what navigating government systems requires.
## Why it's hard ## Why it's hard
Insurance disputes are engineered to be abandoned: Government forms are designed for compliance, not usability:
- Prior auth processes have no standard timeline or format across insurers - Applications are long, interdependent, and punish small errors with delays or denials
- EOBs are intentionally opaque — reconciling them against bills requires expertise - Eligibility rules vary by state, household composition, income, and program
- Appeal deadlines are short (3060 days internal, 4 months external) - Deadlines are strict and consequences of missing them are severe
- The regulatory landscape is complex: state insurance codes, ACA requirements, ERISA for employer plans - Immigration forms carry legal risk if misunderstood or incorrectly filed
## Core pipeline ## Core pipeline
``` ```
Log claim / denial / prior auth request Identify the form or benefit needed
→ AI analyzes EOB + denial reason → Drafts appeal with clinical rationale → AI explains eligibility requirements in plain language → Gather required documents
Human review + attach supporting docs → Submit appeal Pre-fill draft with AI assistance → Human review + submit
→ Track deadline + escalation windows → External appeal / commissioner complaint if needed → Track status + follow-up deadlines → Draft appeals if denied
``` ```
## Key differentiators vs. Peregrine ## Coverage areas
- Medical + insurance jargon parsing (CPT codes, ICD codes, denial reason codes) - **Benefits:** SSI, SNAP, Medicaid, housing assistance, TANF
- Regulatory citation engine: state insurance code, ACA provisions, ERISA - **Education:** FAFSA, state grants, dependency edge cases
- External appeal automation: state IDRE (Independent Dispute Resolution Entity) filing - **Immigration:** I-130, I-485, N-400, DACA renewal, travel documents
- EOB reconciliation: match line items against Explanation of Benefits - **Permits & licenses:** by jurisdiction (building, business, professional)
## Product code (license key) ## Product code (license key)
@ -41,7 +41,7 @@ Log claim / denial / prior auth request
## Tech notes ## Tech notes
- Shared `circuitforge-core` scaffold - Shared `circuitforge-core` scaffold
- PDF parsing (pdfplumber) for EOBs and denial letters - PDF parsing (pdfplumber) for government form templates
- CPT/ICD code lookup: CMS public datasets - Eligibility rule engine: structured YAML by program + jurisdiction
- State insurance department contact directory (structured YAML) - State agency contact directory
- Vision module: scan paper EOBs and denial letters via moondream2 / Claude vision - Vision module: scan mailed notices via moondream2 / Claude vision