Use case library

Every job the OS does.
Not a demo reel — the real surface map.

54 use cases across life-event cascades, resident journeys, staff consoles, fraud→savings integrity, 71 domain verticals, and 9 golden-path personas. Backed by 37 product routes in the surface manifest.

Engine truth

All 12 life-event types come from @govos/life-events — not hand-picked demos.

Product truth

Resident apply/status, staff SLA queues, fraud, savings, rules, privacy — real routes you can open after login.

No more missed pages

Catalog lives in lib/use-case-catalog.ts + lib/public-surface-manifest.ts. Marketing passes must cover the full set.

54

Use cases

12

Life events

5

Narratives

18

Resident flows

9

Staff flows

7

Verticals

9

Personas

71

Domains

Showing 54 of 54

Life-event cascades

12 use cases

Engine workflow

Marriage

3 coordinated domain steps

Coordinates name changes, tax filing status updates, healthcare coverage, and benefits recalculations.

identity-accesstaxhealthcare
Engine workflow

Divorce

3 coordinated domain steps

Coordinates benefit splits, healthcare transitions, tax updates, and custody-related changes.

taxhealthcarebenefits
Live cascade

Military separation

VA, housing, education, healthcare, labor

Honorable discharge triggers coordinated enrollment across VA benefits, housing, GI Bill education, healthcare, and civilian employment.

veteranshousingeducationhealthcarelabor
Live cascade

Start a business

Permitting, tax, labor, SBA, regulatory

Formation cascade: entity registration, tax IDs, employment rules, SBA capital pathways, and ongoing compliance.

permitting-licensingtaxlaborsmall-businessregulatory-compliance
Live cascade

Disaster declaration

Emergency, housing, infrastructure, agriculture

Declaration-driven cascade for evacuation, shelter, FEMA aid, infrastructure triage, and producer recovery.

disaster-recoveryemergency-serviceshousinginfrastructureagriculture
Product surface

Tribal & rural services path

Intergovernmental, IHS-adjacent health, rural development

Persona Aisha: tribal affairs, healthcare access, rural development, and intergovernmental coordination.

tribal-affairshealthcarerural-developmentintergovernmental
Live cascade

Maria loses her job

One event triggers a safety net across 6 programs

I've completed the initial eligibility scan for Maria's household. Based on her employment history, household size (3), and income drop, she qualifies for 6 programs across 4 agenc…

economic-welfarebenefitshealthcareeducationtax+1
Live cascade

The Smiths have a baby

From birth certificate to benefits in one flow

The Smiths only need to confirm a few choices. I registered the birth event once, requested the federal identity record, updated healthcare, recalculated taxes, and opened nutritio…

censushealthcaretaxbenefitschild-welfare+1
Engine workflow

David is injured at work and files for SSDI

David Chen · 8 steps · 6 domains

After a back injury at the warehouse, David can no longer perform his job. GovOS coordinates short-term wage replacement, federal SSDI intake, Medicaid bridge coverage, and housing-cost relief while the SSA processes his claim.

economic-welfarehealthcarehousingtaxlabor+1
Engine workflow

Patricia retires at 66 and consolidates her benefits

Patricia Williams · 8 steps · 6 domains

At full retirement age, Patricia files for Social Security, enrolls in Medicare Parts A and B, drops her marketplace plan, rebalances her household tax withholding, and reviews her Section 8 voucher contribution.

economic-welfarehealthcarehousingtaxveterans+1
Engine workflow

Robert's family files survivor and estate benefits

Robert Garcia (deceased) / Lisa Garcia (survivor) · 8 steps · 8 domains

After Robert dies, his spouse Lisa coordinates death certificate distribution, Social Security survivor benefits, VA burial benefits, dependent Medicaid continuation, the estate filing, and benefit terminations across every agency Robert had touched.

censuseconomic-welfarehealthcareveteranstax+3

Resident product journeys

12 use cases

Product surface

Resident home

What do you need today?

Signed-in home: open applications, services hub, and next actions.

dashboardservices
Product surface

My applications

All in-flight and completed packages

Cross-domain application inventory for the signed-in resident.

applications
Product surface

Report a life event

Trigger cross-program eligibility refresh

Citizen form that fires the cascade coordinator across subscribed domains.

life-eventcascade
Product surface

Household balance sheet

Income, benefits, and net position

Household economics view powered by the household model.

economicshousehold
Product surface

Benefit cliff analysis

What happens if income rises

Income-floor / cliff visualization so residents see tradeoffs before earnings change.

cliffeligibility
Product surface

Benefit gap finder

Programs you may qualify for but are not enrolled in

Cross-program gap analysis from evaluate-all style screening.

eligibilitygaps
Product surface

Document wallet

Upload and reuse evidence across programs

Citizen document store for multi-program applications.

documentsevidence
Product surface

Cascade result viewer

Live multi-domain engine output

Inspect a completed life-event cascade and net household impact.

cascadelife-event

Staff product journeys

6 use cases

Product surface

Case queue with SLA

Urgency sort, overdue chips, human review

Adjudication queue with aging, priority, and case detail drill-down.

casesSLAreview
Product surface

Rules & policy console

Register, test, approve domain rules

Rules DSL registration and simulation for agency administrators.

rulespolicy
Product surface

Analytics

Throughput, denial rates, domain health

Aggregate operational metrics across domains.

analytics
Product surface

Platform health

Service readiness and connectors

Runtime health of engines, domains, and gateway connectors.

healthops
Product surface

Notifications

Operator alerts and citizen outreach

Outbound and in-app notification streams for case work.

notifications

Integrity & mission loop

4 use cases

Product surface

Fraud & waste signals

Detection → review → recovery

Signal board for identity, eligibility, and payment integrity cases.

fraudwaste
Product surface

Audit ledger

Hash-chained operator actions

Immutable audit trail for regulators and internal compliance.

auditcompliance

Domain verticals

7 use cases

Catalog entry

Economic & social welfare

6 domains

Safety-net income, child welfare, and household support. Includes Economic Welfare, Housing, Child Welfare, Disability Services, +2 more.

economic-welfarehousingchild-welfaredisability-servicesaging-services+1

Platform access

4 use cases

Catalog entry

Domain catalog

71 machine-readable government products

Branch-organized catalog with programs, statutes, and role entry.

domainscatalog
Product surface

Platform AI

Eligibility, programs, domains — live or offline

Conversational entry into the OS with domain-aware guidance.

aichat
Product surface

Platform access

Personas, Login.gov, domain roles

Resident and staff personas plus per-domain role entry.

authpersonas
Product surface

Multi-tenant SaaS control

Tenants, members, records, applications

Agency/tenant administration surface for multi-jurisdiction deployments.

saastenants

Personas & golden paths

9 use cases

Product surface

Jane Smith

Citizen — job loss

Maria Santos story: layoff triggers unemployment, SNAP, healthcare, tax, and childcare across agencies.

benefitstaxhealthcare
Product surface

Marcus Johnson

Veteran — transition

Army veteran separating to civilian life: VA benefits, housing, education, healthcare, and labor.

veteranshousingeducation
Product surface

Priya Shah

Small business owner

Starts a business: SBA, permitting, tax, labor, regulatory compliance, and procurement access.

small-businesstaxpermitting
Product surface

Elena Vargas

Senior — retirement

Retiring federal contractor path: Social Security, Medicare/aging services, tax adjustments.

social-securityaging-serviceshealthcare
Product surface

James Okonkwo

Disaster survivor

Coastal storm survivor: FEMA disaster recovery, housing, emergency services, and agriculture aid.

disaster-recoveryhousingemergency-services
Product surface

Aisha Begay

Tribal community member

Navigates tribal affairs, IHS-adjacent health, rural development, and intergovernmental services.

tribal-affairshealthcarerural-development
Product surface

Officer Davis

Case Worker

Frontline case worker: benefits, tax, fraud queue, and cross-domain human review.

casesfraud
Product surface

Director Chen

Administrator

Agency administrator: policy, rules approval, analytics, and pilot readiness.

rulesanalyticshealth

Pick a use case. Enter the product.

Cascades prove coordination. Product routes prove craft. Integrity proves the mission.