Repository navigation
Review Rules as an Expert
This page walks you through checking one state's rules if you know SNAP, Medicaid, WIC, LIHEAP, or TANF well: caseworkers, agency staff, legal aid staff, and policy researchers. You do not need to write code. Expert review is the most important step before OpenBridge can be used by the public.
Where things stand. All three states (Ohio, Texas, Washington) are
draft. No expert has signed off on any of them. The current numbers are 2024 figures entered by the engineering team for testing, and they must be checked against current agency data.
A "state adapter" is the file that holds one state's rule numbers (see the Glossary). For each state, you check four things (from the sign-off record):
- Income limits, benefit amounts, and Medicaid expansion settings match official sources.
- The cited sources are current and correct.
- The test cases (called "golden fixtures") expect the results a real caseworker would expect, including edge cases.
- The year of the reference data is the right one to use.
- Tell us which state and programs you plan to review, by email (openbridge@starlingtek.com) or on a "New state request or offer" issue (choose "I can review rules as a subject-matter expert").
- Have the official sources ready: the state's policy manuals and income tables, plus federal ones (HHS poverty guidelines, USDA FNS for SNAP and WIC, and Medicaid.gov).
The community rule toolkit shows every value in plain words next to its source, lets you mark each one, and downloads a review report you can send us. It needs no code and no GitHub knowledge. The steps below do the same review straight from the files, if you prefer.
-
Open the state's rule file. On GitHub, open data/states,
then the state's folder (
oh,tx, orwa), thenadapter.json. Shared federal numbers are in data/federal. -
Read the numbers. Names ending in
Pctare a percent of the federal poverty line, so"adultLimitPct": 138means 138% of the poverty line. Names ending inCentsare money in cents, so60000means $600. A value ofnullmeans the test does not apply. -
Compare each value with its source. The
sourceslist near the end of the file names the official source for each value, with a link and a published date. Open the link, find the number, and check that it matches and that the date is current. If a value has no entry insources, note that too. - Spot-check with Show the math. In the app, screen a made-up household in your state. On the results page, select a program's name to open its details, then open Show the math. The table lists each step, the amount, and "Where it comes from". Check the math by hand. A row that says "Source not listed yet" is a value with no citation.
- Try the edges. Screen households right at a limit, just under it, and just over it. Try an older or disabled member, a pregnant member, and children with parents in the same household.
-
Check the test cases. Open the state's
fixturesfolder. Each file is a made-up household and the results it should get. Ask: would a caseworker expect these results? - Record what you find. For each wrong or outdated value, open one rule correction issue. For a missing scenario, record a test case. Send a short summary of your review by email or as a comment on your review issue.
When you are satisfied that the rules, sources, and test cases are right, tell the maintainers you
approve. A maintainer then adds your review to the
sign-off record (reviewer, affiliation, data version,
date, and outcome), and only after that entry is marked Approved can the state be set to
verified. Until then, the app shows a note that the state's rules are still being reviewed.
Only a human subject-matter expert can approve a state. Maintainers, other contributors, and AI tools cannot mark a state verified on their own. Rules also need a new review whenever the yearly federal numbers change (see Yearly data updates).
- Every income limit and amount matches a current official source.
- Every source link works and its published date is correct.
- Values with no source are listed in your notes.
- Show the math agrees with your hand calculation for at least three households.
- Households at, just under, and just over a limit get sensible results.
- Each test case expects the result a caseworker would expect.
- Each problem has its own rule correction issue.
- You told the maintainers whether you approve.
OpenBridge is a prototype. Its rules are drafts that experts have not verified yet, and results are
estimates, not decisions. It is not legal advice. Need help applying for benefits? Call 211 or visit
211.org. This wiki is edited in the wiki/ folder of the repository.
Questions: openbridge@starlingtek.com.
Start here
Use OpenBridge
- Using OpenBridge
- Understanding your results
- Guide for navigators
- Privacy and your data
- Run it on your computer
- Host it for others
- Use it with an AI assistant
Help without code
- Ways to help
- Review rules as an expert
- Record a test case
- Report a rule problem
- Translate OpenBridge
- Test accessibility
- Community rule toolkit
Rules and policy (with code)
- How the rules engine works
- State adapters
- Add or change a rule
- Add a new state
- Golden test cases
- Yearly data updates
Developers