Pre-launch·Book releases June 5, 2026·Join the waitlist

Methodology — how the metro stress reading is built

By Ranjan Gupta · YATU framework · Last updated May 25, 2026

Every metro page on this site is anchored in source-verified data, structured by a single diagnostic triad, and labeled with a stress tier that means something specific. This page documents what each piece is and how it's calculated, so you can read the pages with full transparency about their underlying logic.

Stress tiers — what each one means

The four tiers describe the YATU framework's reading of the metro's current institutional condition. They are not credit ratings, not insolvency forecasts, not collapse predictions. They are a structural read of where on the Earth-to-Air trigon transition arc the metro currently sits.

TierMeaningLived experienceExample
Tier 4 · most stressed Structural condition with no operational release valve. Multiple compounding stressors; no policy lever short of structural reconfiguration available. You feel the budget squeeze in daily life — schools, services, taxes, employer health all visibly tightening. Long-term residents have been adjusting expectations for years. Chicago (only Tier 4 metro in the dataset, 2026)
Tier 3 Active institutional contraction visible in K-12, employment, or fiscal layer. Stress is concentrated rather than diffuse. Adjustment is underway but not complete. One or two institutional layers in your daily life are visibly under pressure (your kid's school closing, your employer's layoff round, your city's bond-rating coverage in the news). Houston, Austin, Phoenix, Atlanta, Boston, NYC, Seattle, Miami, Las Vegas, Denver, San Antonio (12 of 20 metros)
Tier 2.5 Mixed signal. Stress markers present but offset by a recent strengthening. Reading is "watch carefully" rather than "act." You hear about both layoffs and good news in the same news cycle. Not sure which way it's going. Nashville (COVID-boom hangover but first S&P upgrade since 1981)
Tier 2 · high end Institutional-specific stress (typically K-12 or outer-suburb housing) within an otherwise functioning regional economy. Stress is real but contained. The closures or layoffs you see in the news affect specific institutions or sub-markets, not the metro as a whole. DFW, Charlotte, SF Bay Area (3 of 20 metros)
Tier 1 · stable No active institutional contraction. Not present in the 2026 dataset. N/A in 2026 reading. None of the 20 metros

Important: None of the 20 metros in the 2026 dataset is at "collapse tier." The YATU framework reads what's happening as correction — institutional forms returning to a scale the new era can sustain — not as failure. The full framework reading is at The Compelled Correction · Institutional Form.

The three-component diagnostic triad

Every metro's K-12-layer stress signal is read through the same three-component diagnostic. Each component alone is a stressor most districts could absorb. The three together produce the fiscal squeeze districts structurally cannot.

Component 1 — Enrollment decline

Below-replacement birth rates. Family formation delayed by housing costs. Migration to lower-cost regions slowing because lower-cost regions are no longer low-cost. None of these is reversible by school policy. Districts are responding to a demographic and economic reality they did not create.

Component 2 — Fixed bonded debt

School districts that grew during 2010-2022 issued bonds at low interest rates with debt-service obligations running 15-40 years forward. The interest payment is the same whether campuses are full or half-empty. As enrollment declines, per-student debt service rises mechanically. This is not a flaw in how any specific district managed itself — it's the structural mismatch between bonds-designed-for-one-demographic-trajectory and the demographic-trajectory now actually in motion.

Component 3 — School-choice expansion channel

Voucher programs (Texas TEFA, Arizona ESA, Georgia Promise, Florida FES, Tennessee ESA, NC Opportunity Scholarship) redirect education funding to follow the student rather than the building. They do not move bonded debt off the district's balance sheet. The combined math — fewer students per district, same bond service, less revenue per remaining student — produces the fiscal squeeze.

The framework reads the school-choice channel as one of the operational mechanisms through which the broader institutional-form contraction is moving faster, not as cause of the contraction. The public-district math would shift even without expanded school choice. Parents who chose alternatives were responding to real and reasonable concerns about educational fit for their specific children. The framework holds both honestly together — the structural mathematics is real AND the parent choice is lawful and often well-considered. This is the framework's Claim 32 anti-exculpation discipline applied at the parent-choice layer.

Source-verification pipeline (three gates)

Every numerical claim that appears on a metro page passes three verification gates before being published. This is the operational discipline that lets you trust the citations.

Gate 1 — URL liveness, source allowlist, date

URL must return 200 (HEAD request). Source domain must be on the allowlist (Tier A = auto-eligible; Tier B = always human-reviewed; Tier C = rejected outright). Article publish-date metadata extracted from <meta property="article:published_time"> must be within the relevant time window.

Gate 2 — Headline-source match + numerical-claim grounding

Article full text is fetched. Haiku model verifies: does the article content directly support the proposed headline? Every numerical claim in the headline must appear in the source article text (verbatim or as recognizable paraphrase). If either check fails, the item is rejected, not published.

Gate 3 — Cross-corroboration for significant items

Items meeting significance triggers — layoffs ≥100 jobs, new closure announcements, credit-rating changes, housing-data revisions >3% MoM, voucher-policy changes, federal-funding actions affecting research universities or healthcare systems — require an independent second source before publishing. If only one source is available, the item goes to human review even when the source is Tier A.

Source tiers — allowlist

Tier A — auto-eligible after probation period

Tier B — always human-reviewed

Tier C — rejected outright (never published)

Data sources used

Every per-metro research file at /data/metroplex/ cites the specific source URL behind each numerical claim. Where data is unverifiable, the file explicitly marks "DATA GAP" rather than guessing.

Update cadence

Audit + accuracy guardrail

Monthly: random sample 20 published items. Manually verify (1) headline accurately reflects source content, (2) all numerical claims are sourced, (3) source is on Tier A or B, (4) framework annotation matches canon. Calculate accuracy rate.

Threshold: if accuracy < 95% in any monthly audit, the daily news task reverts to human-review-for-all until the failure mode is diagnosed and corrected.

Per-item audit trail (archived, never deleted): unique ID, run timestamp, source URL, headline as published, framework annotation as published, Haiku confidence score, gates passed, second-source corroboration result, approval timestamp, any subsequent corrections. This means retrospective review is always possible.

Corrections policy

Found an error? Reach Ranjan directly via either channel:

All corrections are logged + archived for retrospective audit. Correction acknowledgments aimed for within 24 hours during business days; corrections published within 72 hours if substantiated. Persistent errors trigger a public correction note added to the relevant page's footer.

If you're disputing the framework reading rather than the underlying data — that's a different conversation, and the same channels work. The framework operates under nistrai-guṇya middle-position discipline; substantive disagreement is welcome.

What this methodology is not

It is not a forecast that any specific metro will collapse, get worse, or recover. The framework reads structural mechanism, not future timing of specific events.

It is not a credit rating. Moody's, S&P, Fitch, and KBRA assess creditworthiness. The YATU framework reads institutional-form structural alignment with the era-shift. These can correlate but they measure different things.

It is not partisan. The structural condition the framework names operates regardless of which political coalition is in power in any specific metro or state. Texas TEFA, Arizona ESA, Georgia Promise are mechanisms the framework reads structurally, not endorsements or attacks.

It is not advice. The pages document what's happening and what the framework reads as the structural mechanism. They do not tell you whether to move, where to send your kid to school, whether to sell your house, or which job to take. Those are your decisions.

Found an error or have a correction? Reach Ranjan at ranjan.gupta@jyoling.com or @jyolingapp on X · all corrections logged + archived for retrospective audit