Skip to content
GitHub
US Tax Prep

Rules

Rule-coverage overview for the tax-prep world model. This page mirrors the state of the published world model — it is not the authoritative source.


The world model itself is authoritative. This page exists as a reference summary — what clusters of rules exist, what’s enshrined, what’s still candidate-stage — not as a replacement for the Operations-app view.

  • Canonical rule list: spectral.worlds rule corpus, surfaced through the Operations app.
  • Canonical provenance: the envelope on each rule (see Source materials).
  • This page’s job: give operators and contributors a one-screen overview of coverage — what’s in, what’s out, what’s in-flight. Updated per published version; not per rule edit.

The tax-prep world model has not yet been bootstrapped. Once the first enshrined rules land, the sections below will carry per-problem-space coverage summaries along these lines:

Filing status determination — target: ~20–30 rules

Section titled “Filing status determination — target: ~20–30 rules”
ClusterRule count (target)EnshrinedPrimary source
Single0Pub 501 §“Filing Status — Single”
Married Filing Jointly0Pub 501 §“Married Filing Jointly”
Married Filing Separately0Pub 501 §“Married Filing Separately”
Head of Household0Pub 501 §“Head of Household”
Qualifying Surviving Spouse0Pub 501 §“Qualifying Surviving Spouse”
Considered-unmarried + continuation cases0Pub 501 — multiple

Standard deduction — target: ~25–35 rules

Section titled “Standard deduction — target: ~25–35 rules”
ClusterRule count (target)EnshrinedPrimary source
Base amount per filing status0Pub 501 §“Standard Deduction”
Age ≥ 65 modifier0Pub 501 — Standard Deduction Worksheet
Blindness modifier0Pub 501 — Standard Deduction Worksheet
Dependent-taxpayer limit0Pub 501 §“Standard Deduction for Dependents”
Disqualifying conditions (MFS with itemizing spouse, nonresident alien, dual-status)0Pub 501 + 1040 Instructions

(Numbers fill in as rules enshrine. Bootstrap floor is 50 enshrined rules across the two problem spaces.)


Alpha exercises the full rule-relationship surface (depends-on, conflicts-with, qualifies) across the two alpha problem spaces. Examples the bootstrap is expected to surface:

  • depends-on. Standard-deduction rules depend on a filing-status rule having decided the base amount.
  • conflicts-with. The standard-vs-itemized election is a conflicts-with pair; the MFS-with- itemizing-spouse rule forces the conflict resolution.
  • qualifies. Head-of-household status qualifies the taxpayer for a standard-deduction amount distinct from Single.

These relationships are first-class in the rule model (they move through the Evolution Loop like the rules themselves) — see World Model System — world-model.


Rules carry a provenance tier that reflects the source strength. Alpha-domain rules should overwhelmingly cite Tier-1 IRS publications; Tier-2 (IRS revenue rulings / procedures referenced for narrow fact patterns) is permitted but rare; Tier-3 is not used in this domain for today.

When the world model bootstraps, this section reports the actual tier distribution and flags any rules whose tier drifted due to updated sources.