How The Machine Works
Here is the lifecycle of a federal law.
A member of Congress introduces a bill. It is assigned a number, referred to a committee, and published on Congress.gov — the government’s official legislative database. The committee may hold hearings, mark up the bill, or let it die quietly. If it advances, it goes to the floor for debate and a vote. If it passes one chamber, it goes to the other. If both chambers pass different versions, a conference committee reconciles them. The final version goes to the President.
That sounds straightforward. It is not.
The Procedural Labyrinth
The real action happens in the procedure. A bill can be “passed” by being attached as an amendment to an unrelated must-pass spending bill. A vote can be “bipartisan” because it was a procedural motion to advance debate, not a vote on the substance. A provision can be “in the law” because it was inserted during conference committee at 2am, after both chambers had voted.
The data is scattered across multiple systems:
- Congress.gov — bill metadata, actions, summaries, and status
- GovInfo (GPO) — the actual text of bills, reports, and the Congressional Record
- House Clerk — House roll call vote records
- Senate.gov — Senate roll call vote records
Each system has its own format, its own search interface, and its own conventions. Connecting a vote to a bill to a provision requires the kind of cross-referencing that congressional staffers, lobbyists, and legislative counsel do professionally.
Congress.gov offers the metadata for free. That is the crack in the wall. The Ledger drives a truck through it.
Why Not Just Ask ChatGPT?
These tools treat you as a consumer of answers. You ask. They deliver. You accept. Sound familiar?
It is the same gatekeeping pattern wearing a friendlier mask. The pundits said: trust us, we interpret the news. The algorithms say: trust us, we summarize the record. In both cases, the evidence is not in your hands. You are still on the outside of the glass, trusting an intermediary to get it right.
The Ledger takes a different position: you should be in dialogue with the legislative record itself. Not receiving a verdict. Not consuming a summary. Sitting at the table, choosing which bills matter, reading what they actually did, and walking away with every claim traced to its source.
The difference between an answer box and a dialogue is the difference between being told what happened and being equipped to read the record yourself.
The Dialogue
Here is how The Ledger works, step by step.
Step 1: You ask a question
Type your question in plain English. Add your decision context — the reason you are asking. “What has Congress done about housing?” is different when the context is “deciding whether to call my representative” versus “writing a policy brief for class.” The context shapes which evidence matters most.
Step 2: AI translates your question into Congress.gov’s language
Your question is sent to Claude, Anthropic’s AI. It does not just pull keywords. It generates multiple search strategies using real legislative terminology — bill types, policy areas, subject terms, sponsor names — the same language a legislative aide would use. These strategies range from broad (casting a wide net across policy areas) to specific (targeting exact bill types and provisions).
You can see every search term it generated, and why. Nothing is hidden.
Step 3: Bills come back in plain language
The search terms query the Congress.gov API — the same data used by the Congressional Research Service and legislative tracking services. Bills return with their titles, sponsors, status, latest actions, and summaries. Then AI translates each bill’s procedural details into plain language — not dumbed down, but made readable.
You see both versions: the plain-language translation and the original official title. You decide which bills to include. This is your curation step. The AI does not decide what is relevant. You do.
Step 4: AI reads and writes your brief
The bills you selected are sent to Claude with strict instructions: separate what the record shows from what can be inferred. Cite every claim with a bill number and action date. Surface contradictions between different bills or versions — do not hide disagreement. State confidence honestly. Name what is unknown. Flag any claim that cannot be traced to a provided record as [UNWITNESSED].
The synthesis streams in real time. You watch it being written. When it is done, you have a brief you can download as a Word document — with every claim linked to its source on Congress.gov.
You came in with a question. You leave with receipts.
The Prompts
Every AI interaction in The Ledger uses a carefully designed prompt. Most AI tools hide their prompts. We show you ours in full, because transparency is not optional when the legislative record is at stake.
Search Query Generation
When you type your question and press search, this prompt converts your plain English into optimized Congress.gov API queries with real legislative terminology and search parameters.
Plain-Language Translation
After finding bills, this prompt translates each bill’s title, status, and actions into language anyone can understand — without losing the substance.
Synthesis
This is the core prompt. It governs how the AI reads the bills and writes your brief. Every rule serves a purpose: separating fact from inference, enforcing citations, surfacing disagreement, preventing hallucination.
Honest Limits
This tool has real limitations. Knowing them makes you a better user.
- Summaries and metadata only. The Ledger reads bill summaries, titles, actions, and status — not the full legislative text. Full bill text can run hundreds of pages. This means specific provisions, section-level language, and amendment details may be missed. If a bill matters to your decision, read the full text on Congress.gov.
- AI can err. Despite strict instructions, Claude may occasionally misinterpret a bill’s status or make an unsupported inference. Every claim includes a bill citation — click it and read the record yourself on Congress.gov. The receipts exist so you can verify.
- Not legal advice. This tool helps you understand what legislation exists and what Congress has done. It does not replace an attorney or a legislative analyst. It gives you better questions to ask your representative, not answers to follow blindly.
- Coverage boundaries. The Congress.gov API has limits. Very new bills may not be indexed yet. Certain historical records may be incomplete. The search stats tell you exactly how many bills were found and how.
- Vote linkage. Connecting roll call votes to specific bills is complex. The Ledger uses the linkages available through Congress.gov and the House/Senate clerk sites, but some votes — especially procedural ones — may not be directly linked to the bill they affected.
Technical Details
Data sources
Congress.gov API (api.data.gov): All bill metadata, actions, summaries, and status are fetched from the Library of Congress’s public API. This is the same data used by the Congressional Research Service, legislative tracking services, and news organizations. Free, public, API key required (also free).
House Clerk & Senate.gov: Roll call vote records are fetched from the Office of the Clerk of the U.S. House of Representatives and the U.S. Senate website. These are the official sources for how each member voted.
AI model
Claude by Anthropic: All AI interactions use Claude, Anthropic’s most capable model. You provide your own API key, which means your data is sent directly from your browser to Anthropic’s servers. Nothing passes through our servers because we do not have servers. This is a static website.
Privacy
Your API keys are stored in your browser’s localStorage. They are never sent anywhere except to their respective APIs (Anthropic for Claude, api.data.gov for Congress.gov). Your questions, bills, and briefs exist only in your browser. When you close the tab, they are gone unless you downloaded them. No tracking. No analytics. No database.
The Lineage
The Ledger inherits from a long tradition of putting knowledge back in common hands.
The United States was founded on the principle that the governed must consent — and consent requires understanding. The Constitution mandates that Congress publish a journal of its proceedings. The Government Printing Office was established in 1861 to make federal documents available to the public. The Congressional Record has been published daily since 1873.
But availability is not the same as accessibility. The record was published in print, then in databases, then on websites — and at each step, the language remained engineered for insiders. The form changed. The gate did not.
When the Freedom of Information Act was passed in 1966, government agencies resisted it for decades. When THOMAS (the precursor to Congress.gov) launched in 1995, it made legislative text searchable for the first time — but only if you knew the search syntax. When data.gov launched in 2009, it made government data machine-readable — but only if you could write the code.
The pattern is always the same. The record exists. The format ensures most people cannot use it. Translators refuse the premise. Eventually, the public record returns to the public.
This tool is one small table flip in that tradition. It does not replace reading. It does not replace thinking. It does not replace civic engagement. It is a translator that sits at the table with you, reads the public record aloud, and makes sure every claim has a receipt.
The tables have turned. Open the ledger.