---
title: Atlas Commons — Provenance & Agent Citation
version: 1
license: CC0-1.0
---

# Atlas Commons — Provenance & Agent Citation

Atlas Commons is built to be cited and checked, not believed. Every figure is a research object that names its source, labels how sure it is, and is served in machine formats you can fetch directly. You do not take the page's word — you re-fetch the named public source and verify. This page is how.

## Agent-native formats

- **Operative.** Every entity is projected, from one definition, to: .jsonld — the canonical research object — schema.org-typed, with each claim's warrant, source, and the structured tables in hasPart.; .json — the same research object as plain JSON, for agents that don't want JSON-LD framing.; .md — the claims with their warrants and sources, plus the tables — for an LLM reading context.; .toml — the same, as TOML, with the structured tables as arrays of typed rows.; .context.md — a condensed, citation-first brief that points back to the full .jsonld.

## Format coverage (honest rollout)

- **Operative.** The flagship analytical pages and the per-state risk profiles carry all five formats, projected from one definition by the @f3/atlas-research-objects framework — so the page and every format are the same research object and can never drift.
- **Partial.** The long-tail entity routes (individual facilities, companies, dockets, counties) currently carry .jsonld and .md; the full five-format projection is being migrated across them route-family by route-family. Every route already carries at least the .jsonld research object and the .md.

## How to cite a figure

- **Operative.** Carry: the claim @id (the stable identifier of the specific figure within the research object (the object's @id + a claim fragment).); the warrant (its four-status label — RECORDED / MODELED / DERIVED / INTERPRETATION — so the reader knows what KIND of figure it is.); the named source (the public authority and dataset the figure resolves to (e.g. FEMA National Risk Index), with its URL.); the re-fetch (the source URL you (or your reader) can pull to reproduce or challenge the figure — Atlas Commons is the index, the authority is the source.); the dataset version (the research object's version / the source release the figure was taken from, so a later change is detectable.). Example: FEMA models Florida's expected annual loss from natural hazards at $8.79B/yr (MODELED; FEMA National Risk Index, hazards.fema.gov/nri/). — Atlas Commons, /property/states/fl.jsonld

## The provenance lineage

- **Operative.** The public source: A named, authoritative public dataset (FEMA NRI, NOAA Storm Events, CMS, OpenFEMA, the federal courts, …). Atlas Commons never invents a figure; a language model is never the source.
- **Operative.** The medallion gold: The source is ingested and aggregated into a content-hashed gold table with a recorded generation time — the reproducible transformation between the raw source and the published figure.
- **Operative.** The research object: Each consequential figure becomes a four-status claim — what occurred, what's supported, what's adjudged, what's operative — carrying its source, its warrant, and a falsifier that says how it could be shown wrong.
- **Operative.** The projection: One definition is projected to every machine format (and the human page). The formats are pure projections of the same object, so they cannot disagree — fix the claim, fix every format.

## What is guaranteed — and what is not

- **Operative.** Guaranteed: Every consequential figure resolves to a named public source you can re-fetch — never to a language model and never to an unnamed origin.
- **Operative.** Guaranteed: Every figure carries a visible four-status warrant; a modeled expectation is never dressed as a recorded fact.
- **Operative.** Guaranteed: The page, the .jsonld, and the other machine formats are projections of one definition — they carry the same figures, by construction.
- **Operative.** Guaranteed: Corrections are logged publicly; what was wrong, and the live corrected surface, are on the record.
- **Operative.** Limit: Atlas Commons cites the source RELEASE it ingested (with a generation time and content hash) — it is not a live pass-through. The upstream source can change after that release; re-fetch the source for the current value.
- **Operative.** Limit: Atlas Commons does not vouch for the source's own accuracy. It faithfully indexes and labels what the authority published; if the authority is wrong, the citation lets you challenge the authority, not the index.
- **Operative.** Limit: Derived figures (rankings, ratios, per-capita rates) are the atlas's own transparent calculations over the recorded source — labeled DERIVED, with the method stated, not an authority's verdict.

---

Every statement above is a claim carrying a four-status warrant (Operative / Partial / Committed / Principle / Derived) — a commitment is not dressed as an operative fact. Structured: `https://agenticu.ryanjhunter.workers.dev/provenance.jsonld`
