Architecture · c/o OpenOS engineering
Six modules. One shared spine.
Every module writes to the same provenance log, grades through the same Constitutional Grading Engine, routes through the same attestation gate, and produces action packets using the same delivery layer. You cannot understand any single module without understanding the spine.
The constitutional spine
“Four shared systems”
Every module depends on these. If any one is compromised, the whole platform is compromised. They are intentionally simple, auditable, and enforced at the database level.
Constitutional Grading Engine
A single shared Celery task called by every module. Five checks: enumerated powers, Bill of Rights, individual sovereignty, decentralization (4-question test), due process / takings. Implemented once. Never re-implemented.
Provenance Log
Every SI call, every data ingest, every agent step writes here. If a finding exists, the full evidentiary chain that produced it exists. If it doesn't log, it doesn't ship.
Attestation Gate
No action packet sends without a corresponding attestation record. Enforced at the database constraint level — all three citizen checkboxes must be True. DOJ referrals require a second attestation from a licensed attorney.
Action Packet Layer
Every module produces output through the same delivery pipeline — letters, petitions, IG referrals, DOJ referrals, media briefs. Same templates, same attestation requirements, same tracking.
Data flow
“How the modules connect”
Each module is a door into the system. Once inside, the modules write back to one another — a Navigator case reveals a conflict → written to the Intelligence Layer → raises the actor's score → triggers a scoreboard re-rank → constituent alerts fire. The interconnection is the point.
The constitutional spine
- 01 Grading engine
- 02 Provenance log
- 03 Attestation gate
- 04 Action packets
Six modules / one shared system
- 01Public Intelligence LayerPublic records → actor findings
- 02Bureaucracy NavigatorGrievance → sourced case
- 03Policy PortalProposal → grade and vote
- 04Republic VoteVerified vote → divergence
- 05SI Think TankSource synthesis → citizen vote
- 06Legislative Push EngineQualified proposal → action
- 01 Citizen files a grievance
- 02 Navigator verifies evidence
- 03 Intelligence logs the finding
- 04 Scoreboard and alerts update
Module specifications
“Six doors, one system”
Public Intelligence Layer
Accountability backbone. Feeds every other module.
Ingests: Congress.gov, FEC, OpenSecrets, STOCK Act portals, USASpending, Open States, ProPublica, PACER, agency regulatory filings. Produces: actor scorecards, conflict-of-interest maps, flip-flop trackers, pattern alerts, accountability scores. A clean score on incomplete data is more dangerous than no score at all.
Bureaucracy Navigator
Grievance → Action Packet in four agent steps.
Navigator classifies the issue and maps jurisdiction. Investigator pulls live evidence from public records. Governance Gate checks policy, confidence, and abuse risk (mandatory stop, cannot be bypassed). Analyst + Action Router scores the case and drafts the packet. The decline branch exists for a reason.
Policy Portal
Plain English → Formalized Proposal → Community Vote → Push Engine.
Five SI enhancement jobs on every proposal: Formalization, Constitutional Grading, Counterargument, Impact Scoring, Precedent Check. Dual score display (Community Score + Constitutional Grade) is always separate, never merged. F-graded proposals are NEVER removed. Censoring unconstitutional proposals would itself be a rights violation.
Republic Vote
A parallel citizen vote on every state and federal bill.
Only verified in-state residents count toward consensus. Calculates per-bill divergence (gap between legislator vote and citizen vote), per-state Representation Grade (A-F, rolling 90-day window), and cross-state Unity Index per policy topic. When the Unity Index shows <50% alignment, the Constitution's answer is the Tenth Amendment.
SI Think Tank
Constitution-based synthesis across published solutions.
The Think Tank finds recurring constitutional principles in published VFA SI Solutions, develops broader proposals, links the source work, identifies caveats and implementation paths, and invites citizens to upvote or downvote each published proposal.
Legislative Push Engine
Proposal or finding → real legislative action under citizen attestation.
Five qualifying gates: Constitutional Grade A or B, verified upvote minimum (jurisdiction-scaled), district spread ≥40%, verified account ratio ≥70%, no active manipulation flags. Four delivery channels: Legislator letter, formal petition, ballot initiative, IG referral. The platform is a paralegal, not a lobby.
Accountability tools · planned
“Formal channels, citizen-signed”
We plan to offer citizens tools that use formal, lawful channels when a primary-source record raises a constitutional concern: a public record summary, a voter scorecard, a media brief, an ethics complaint, an inspector-general referral, and a public-records (FOIA) request. These tools are not available yet; their API endpoints return “not implemented”.
The limits are fixed in the design: nothing without a primary source, nothing about family members or private citizens, no calls for resignation, and nothing sent without the citizen’s own attestation. A referral to the Justice Department would additionally require an attorney’s attestation.