|
|
Voice to Congress |
Voice to Congress — Draft v0.1
MIL-HDBK-520A-Style Requirements Specification
Issue Code: GOVERNMENT_SPENDING
Status: Initial Draft for Review
Date: 2026-04-27
Voice to Congress — Draft v0.1 MIL-HDBK-520A-Style Requirements Specification Issue Code: GOVERNMENT_SPENDING Status: Initial Draft for Review Date: 2026-04-27
| Version | Date | Description |
|---|---|---|
| v0.1 | 2026-04-27 | Initial Government Spending Requirements Specification. Corrects prior “Immigration†typo references to Government Spending. Establishes citizen requirements, system requirements, metrics requirements, legislative evaluation rules, verification methods, and traceability model. |
This specification defines citizen-centered requirements for evaluating United States federal government spending, congressional fiscal performance, and member-level legislative activity. The purpose is to connect:
This document is intended to support the Voice to Congress Government Spending Metrics Dashboard and Government Spending Congressional Report Card.
The current Government Spending Report Card can identify and score congressional activity. However, activity alone does not prove the country is moving toward citizen requirements. Members may sponsor, cosponsor, advance, or vote on many measures while the national spending system continues to fail on debt, deficits, waste, fiscal transparency, late budgets, poor program evaluation, and weak public value.
The requirements framework must prevent the system from rewarding motion in the wrong direction.
The Government Spending evaluation system shall trace every score from citizen needs to measurable outcomes:
Citizen Requirement
— Government Spending System Requirement
— Metric Requirement
— Data Source
— Legislative Evaluation Rule
— Member Score Impact
— Public Report Card Display
| User | Need |
|---|---|
| Citizens | Understand whether government spending is responsible, transparent, effective, and sustainable. |
| Voters | Compare congressional activity against objective citizen requirements. |
| Congress | Understand what fiscal performance citizens require and what legislation aligns with those requirements. |
| Analysts | Maintain objective metrics, data sources, scoring logic, and audit trails. |
| Website Administrators | Refresh data, publish metrics, review exceptions, and maintain report card dashboards. |
The following documents and sources inform this requirements framework:
| Term | Definition |
|---|---|
| Government Spending | Federal outlays, obligations, grants, contracts, loans, subsidies, tax expenditures where relevant, debt service, and budget authority. |
| Citizen Requirement | A required outcome or constraint citizens reasonably need from the government spending system. |
| System Requirement | A verifiable requirement the spending system must satisfy to meet citizen needs. |
| Metric Requirement | A measurable indicator used to verify whether a system requirement is being met. |
| Legislative Alignment | The degree to which a bill, amendment, resolution, vote, or oversight action supports or opposes the requirements in this specification. |
| Public Value | Measurable benefit delivered to citizens, communities, national security, economic resilience, or public welfare relative to cost. |
| Fiscal Sustainability | The ability of government to finance current and future obligations without undermining economic stability, public trust, essential services, or future generations. |
| Spending Efficiency | The degree to which spending produces intended outcomes with minimal waste, duplication, fraud, or unnecessary administrative burden. |
| Provisional Score | A score based on available evidence that remains subject to revision because some required data, votes, outcomes, or methodology decisions are pending. |
Citizens require government spending that is:
The present problem is not only that government spends too much or too little. The deeper problem is that spending is often disconnected from clear citizen requirements, measurable outcomes, disciplined tradeoffs, long-term sustainability, and transparent accountability.
There is no single perfect international ranking for “best government spending.†Best practice must be inferred from multiple dimensions: budget transparency, public participation, legislative oversight, audit oversight, fiscal sustainability, government effectiveness, anti-corruption controls, spending reviews, and performance budgeting.
| Country / Group | Relevant Strength | Practice to Study |
|---|---|---|
| New Zealand | Very high budget transparency and strong public finance framework | Transparent budget documents, fiscal responsibility reporting, long-term fiscal statements, public value framing. |
| Sweden | High budget transparency, strong fiscal discipline traditions | Multi-year budget framework, expenditure ceilings, fiscal policy council oversight. |
| Norway | Strong public finance management, sovereign wealth discipline, transparency | Long-term stewardship of public resources, fiscal rules, transparency. |
| Denmark | Strong governance, low corruption, high public trust | Public-sector integrity, digital services, transparent administration. |
| Finland | Strong governance, accountability, and public trust | Evidence-based policy and administrative transparency. |
| Singapore | High government effectiveness and strong execution capacity | Performance orientation, long-term planning, disciplined public administration. |
| Estonia | Digital government and transparency | Digital public services, open data, efficient administration. |
| Canada | Public accounts, budget reporting, parliamentary budget officer | Legislative budget analysis, federal fiscal reporting. |
| Australia | Parliamentary budget office and budget transparency | Fiscal projections, independent costing, program evaluation. |
| Netherlands | Budget discipline and evaluation culture | Spending reviews, fiscal frameworks, program evaluation. |
| Germany | Budget transparency and fiscal rules | Debt brake concept, medium-term planning, fiscal discipline. |
| South Africa | Strong budget transparency relative to many countries | Open budget documentation and public fiscal disclosure practices. |
The United States Government Spending system should adopt or strengthen the following best practices:
| ID | Requirement |
|---|---|
| GSP-SYS-FS-001 | The government spending system shall measure annual deficit as a percentage of GDP and report whether the deficit is improving, worsening, or stable. |
| GSP-SYS-FS-002 | The system shall measure federal debt held by the public as a percentage of GDP and assess whether current legislation stabilizes or worsens the long-term debt path. |
| GSP-SYS-FS-003 | The system shall measure net interest cost as a percentage of federal revenue and outlays. |
| GSP-SYS-FS-004 | The system shall identify legislation that materially increases unfunded obligations without credible offsets or measurable public value. |
| GSP-SYS-FS-005 | The system shall require long-term fiscal impact review for legislation with significant 10-year or 30-year cost implications. |
| GSP-SYS-FS-006 | The system shall distinguish responsible investment from reckless deficit expansion by requiring expected public value, lifecycle cost, and accountability controls. |
| ID | Requirement |
|---|---|
| GSP-SYS-BD-001 | The system shall measure whether Congress adopts a budget resolution on time. |
| GSP-SYS-BD-002 | The system shall measure whether appropriations are enacted before the fiscal year begins. |
| GSP-SYS-BD-003 | The system shall measure reliance on continuing resolutions. |
| GSP-SYS-BD-004 | The system shall measure federal shutdown days and shutdown-risk events. |
| GSP-SYS-BD-005 | The system shall identify budget gimmicks, hidden costs, unrealistic assumptions, emergency-designation abuse, or timing shifts that obscure true fiscal impact. |
| GSP-SYS-BD-006 | The system shall give positive legislative alignment credit to bills that improve budget timeliness, transparency, and fiscal planning. |
| ID | Requirement |
|---|---|
| GSP-SYS-SE-001 | The system shall measure improper payments by agency and program. |
| GSP-SYS-SE-002 | The system shall measure progress on reducing improper payments over time. |
| GSP-SYS-SE-003 | The system shall identify GAO duplication, overlap, fragmentation, and high-risk findings relevant to spending efficiency. |
| GSP-SYS-SE-004 | The system shall track whether Congress supports implementation of GAO and Inspector General recommendations. |
| GSP-SYS-SE-005 | The system shall identify legislation that consolidates duplicative programs, strengthens procurement controls, or improves payment integrity. |
| GSP-SYS-SE-006 | The system shall penalize legislation that creates programs without evaluation, auditability, or performance reporting. |
| ID | Requirement |
|---|---|
| GSP-SYS-TA-001 | The system shall require federal budget and spending data to be public, searchable, downloadable, and machine-readable. |
| GSP-SYS-TA-002 | The system shall measure budget transparency using externally recognized transparency indicators where available. |
| GSP-SYS-TA-003 | The system shall track availability and quality of plain-English citizen budget summaries. |
| GSP-SYS-TA-004 | The system shall link spending decisions to sponsors, cosponsors, roll-call votes, cost estimates, beneficiaries, agencies, programs, and outcomes where feasible. |
| GSP-SYS-TA-005 | The system shall give positive alignment credit to legislation strengthening open data, audit rights, Inspector General independence, and public reporting. |
| GSP-SYS-TA-006 | The system shall assign negative alignment to actions that reduce transparency, weaken audit institutions, hide riders, or restrict lawful oversight. |
| ID | Requirement |
|---|---|
| GSP-SYS-PV-001 | The system shall require major spending programs to identify expected outcomes before funding. |
| GSP-SYS-PV-002 | The system shall measure whether programs report outcomes after funding. |
| GSP-SYS-PV-003 | The system shall measure whether programs have independent evaluation plans. |
| GSP-SYS-PV-004 | The system shall identify programs continued despite repeated evidence of poor performance. |
| GSP-SYS-PV-005 | The system shall distinguish high-value public investment from low-value spending. |
| GSP-SYS-PV-006 | The system shall credit legislation that funds measurable outcomes and corrective action. |
| ID | Requirement |
|---|---|
| GSP-SYS-ES-001 | The system shall assess whether fiscal reforms protect essential services, including national defense, public safety, health, infrastructure, education, courts, and benefits administration. |
| GSP-SYS-ES-002 | The system shall flag across-the-board cuts that do not evaluate service impact, risk, or public value. |
| GSP-SYS-ES-003 | The system shall measure whether reforms reduce waste without damaging essential capacity. |
| GSP-SYS-ES-004 | The system shall require legislation to disclose tradeoffs between savings, service quality, backlog, risk, and long-term cost. |
| ID | Requirement |
|---|---|
| GSP-SYS-IF-001 | The system shall measure long-term fiscal burden placed on future taxpayers. |
| GSP-SYS-IF-002 | The system shall track trust fund solvency, long-term obligations, and fiscal gap estimates where available. |
| GSP-SYS-IF-003 | The system shall flag legislation that shifts costs outside the budget window without disclosure. |
| GSP-SYS-IF-004 | The system shall credit legislation that improves long-term solvency without unjustly harming vulnerable populations or essential services. |
| Domain | Weight | Purpose |
|---|---|---|
| Fiscal Sustainability | 20% | Measures debt, deficits, interest, long-term obligations, and fiscal risk. |
| Budget Discipline | 20% | Measures timely budgets, appropriations, shutdown risk, and budget process integrity. |
| Spending Efficiency | 20% | Measures waste, duplication, improper payments, procurement efficiency, and program correction. |
| Transparency and Auditability | 20% | Measures open data, traceability, audit strength, public reporting, and citizen visibility. |
| Public Value and Investment Quality | 15% | Measures outcomes, cost-benefit, investment return, and program effectiveness. |
| Citizen Participation and Accountability | 5% | Measures public participation, plain-English budget accessibility, and public feedback loops. |
| ID | Metric Requirement | Data Source | Desired Direction |
|---|---|---|---|
| GSP-MET-FS-001 | The system shall measure annual federal deficit as a percentage of GDP. | CBO, Treasury, OMB, BEA | Lower / sustainable |
| GSP-MET-FS-002 | The system shall measure debt held by the public as a percentage of GDP. | CBO, Treasury, OMB | Stabilize then reduce |
| GSP-MET-FS-003 | The system shall measure net interest as a percentage of federal revenue. | Treasury, CBO, OMB | Lower / controlled |
| GSP-MET-FS-004 | The system shall measure projected 10-year cumulative deficit. | CBO baseline | Lower / credible |
| GSP-MET-FS-005 | The system shall measure long-term fiscal gap or long-term debt projection. | CBO long-term outlook | Lower / sustainable |
| GSP-MET-BD-001 | The system shall measure whether a budget resolution is adopted on time. | Congressional records | Yes |
| GSP-MET-BD-002 | The system shall measure appropriations enacted by fiscal year start. | Congressional records | Higher / complete |
| GSP-MET-BD-003 | The system shall measure number and duration of continuing resolutions. | Congressional records | Lower |
| GSP-MET-BD-004 | The system shall measure shutdown days. | OMB, CRS, Congressional records | Zero |
| GSP-MET-BD-005 | The system shall measure emergency spending outside normal process. | CBO, OMB, legislation | Transparent / justified |
| GSP-MET-SE-001 | The system shall measure improper payments by total dollars and rate. | OMB PaymentAccuracy.gov / agency reports | Lower |
| GSP-MET-SE-002 | The system shall measure GAO high-risk areas related to federal spending. | GAO High Risk List | Lower / resolved |
| GSP-MET-SE-003 | The system shall measure GAO duplication and cost-saving recommendations implemented. | GAO reports | Higher implementation |
| GSP-MET-SE-004 | The system shall measure Inspector General recommendations implemented. | IG semiannual reports | Higher |
| GSP-MET-SE-005 | The system shall measure procurement competition rate. | USAspending.gov / FPDS | Higher competition |
| GSP-MET-TA-001 | The system shall measure budget transparency using Open Budget Survey or equivalent indicators. | IBP Open Budget Survey | Higher |
| GSP-MET-TA-002 | The system shall measure USAspending data completeness and timeliness. | USAspending.gov | Higher |
| GSP-MET-TA-003 | The system shall measure whether plain-English budget summaries are available. | OMB, agency budget justifications | Yes / better quality |
| GSP-MET-TA-004 | The system shall measure whether major spending bills have public cost estimates before final vote. | CBO, Congress.gov | Higher |
| GSP-MET-PV-001 | The system shall measure percentage of major spending programs with defined outcome metrics. | Agency performance plans | Higher |
| GSP-MET-PV-002 | The system shall measure percentage of programs independently evaluated within a defined cycle. | OMB, agency evaluations | Higher |
| GSP-MET-PV-003 | The system shall measure spending tied to evidence tiers or performance results. | OMB, agency evidence plans | Higher |
| GSP-MET-PV-004 | The system shall measure investment backlog and lifecycle cost where relevant. | Agency reports, CBO, GAO | Lower backlog |
| GSP-MET-CA-001 | The system shall measure citizen participation mechanisms in federal budgeting. | IBP/Open Budget, agency consultation records | Higher |
| GSP-MET-CA-002 | The system shall measure public comment response and public budget usability. | Agency records, OMB, website review | Higher |
| Classification | Definition | Score Treatment |
|---|---|---|
| Primary | Directly affects spending, deficit, debt, appropriations, budget process, audit, procurement, waste, improper payments, transparency, or public value. | Full scoring eligibility. |
| Secondary | Procedural, rules-based, mixed, or indirectly related to Government Spending. | Reduced weight. |
| Exclude | Administrative, personnel, ceremonial, unrelated, or misleading keyword match. | No score; audit trail only. |
| Review | Insufficient confidence; requires human review. | No score until resolved. |
| Alignment | Meaning | Score Treatment |
|---|---|---|
| Supports Requirements | Advances one or more Government Spending requirements. | Positive score. |
| Opposes Requirements | Worsens one or more requirements or undermines controls. | Negative score. |
| Mixed | Contains both supportive and harmful elements. | Split, reduced, or review score. |
| Neutral / Procedural | Does not substantively support or oppose requirements. | Zero score. |
| Review | Requires policy/methodology review. | Zero until resolved. |
| Method | Description |
|---|---|
| Inspection | Review documents, data files, exported JSON, and public page output. |
| Analysis | Compute metric values, trend changes, domain scores, and member scores. |
| Demonstration | Run ETL commands and confirm output files are produced. |
| Test | Execute automated tests against scoring rules, data joins, and edge cases. |
| Audit | Manually review classifications, votes, alignments, exclusions, and public display. |
| Requirement Group | Verification Method | Evidence |
|---|---|---|
| Fiscal Sustainability | Analysis | CBO, Treasury, OMB metrics. |
| Budget Discipline | Analysis / Inspection | Budget resolution, appropriations, CR, shutdown data. |
| Spending Efficiency | Analysis / Audit | GAO, OMB, IG, improper payment data. |
| Transparency | Inspection / Analysis | Open Budget, USAspending, budget documents. |
| Public Value | Analysis / Audit | Agency performance and evaluation data. |
| Legislative Alignment | Audit / Test | Bill classification, roll-call mapping, cost estimates. |
| Member Scores | Test / Audit | Score CSV, JSON, leaderboard, audit exports. |
The Government Spending Metrics grade shall measure whether the national system is meeting citizen requirements. It shall not be based on member activity alone.
The system grade shall include:
The member score shall measure contribution toward requirements, not simply activity volume.
Proposed formula:
Member Requirement Score = Activity × Alignment × Progress × Evidence Quality × Outcome Connection
Where:
| Factor | Meaning |
|---|---|
| Activity | Sponsorship, cosponsorship, votes, oversight, amendments. |
| Alignment | Supports or opposes requirements. |
| Progress | Legislative stage and seriousness. |
| Evidence Quality | Cost estimate, audit support, measurable controls, credible implementation. |
| Outcome Connection | Link to measurable improvement in system metrics. |
The public website shall not use the same label for:
The website shall clearly distinguish these displays to prevent the false impression that highly active members prove the system is performing well.
Final thresholds require calibration. Initial concepts:
| Grade | System-Level Meaning |
|---|---|
| A | Sustainable fiscal path, timely budgets, high transparency, low waste, strong audit implementation, measurable public value. |
| B | Generally responsible with some weaknesses or lagging outcomes. |
| C | Mixed performance; some requirements met, several weak or deteriorating. |
| D | Serious deficiencies in sustainability, process, waste, transparency, or outcomes. |
| F | Systemic failure: unsustainable fiscal path, weak budget discipline, significant waste or opacity, poor outcome connection, or repeated failure to meet core requirements. |
Bill — Requirement — Metric — Member Action — Score Impact
CREATE TABLE requirement_master (
requirement_id TEXT PRIMARY KEY,
issue_code TEXT NOT NULL,
requirement_type TEXT NOT NULL,
domain TEXT NOT NULL,
requirement_text TEXT NOT NULL,
rationale TEXT,
verification_method TEXT,
data_source TEXT,
desired_direction TEXT,
status TEXT DEFAULT 'DRAFT'
);
CREATE TABLE bill_requirement_alignment (
bill_id TEXT NOT NULL,
requirement_id TEXT NOT NULL,
alignment TEXT NOT NULL,
confidence TEXT NOT NULL,
score_weight REAL DEFAULT 1.0,
rationale TEXT,
reviewer TEXT,
review_date TEXT,
PRIMARY KEY (bill_id, requirement_id)
);
CREATE TABLE vote_requirement_alignment (
chamber TEXT NOT NULL,
congress INTEGER NOT NULL,
roll_call_number TEXT NOT NULL,
requirement_id TEXT NOT NULL,
alignment TEXT NOT NULL,
vote_weight REAL DEFAULT 0,
rationale TEXT,
reviewer TEXT,
review_date TEXT,
PRIMARY KEY (chamber, congress, roll_call_number, requirement_id)
);
This specification changes the Government Spending Report Card from an activity tracker into a requirements-driven accountability system.
The core principle is:
Do not reward effort unless the effort moves the system toward citizen requirements.
A member can be active and still move the system in the wrong direction. A spending bill can be fiscally responsible or fiscally harmful depending on transparency, offsets, long-term effects, public value, auditability, and service impacts. The final scoring model must therefore evaluate activity, alignment, progress, evidence quality, and outcomes together.