add-new-state

Add a New State (steps 1-4)

Covers the manual prep before the full mise run setup-state run. Full reference: DEVELOPMENT.md → "Adding a new state". This skill only does steps 1-4; stop after the dry-run and hand back to the user for step 5 onward (they'll want to review results before the full run, county-conversion decisions, PMTile regen, etc.).

Ask the user for the two-letter state code and full name if not given (e.g. va / Virginia).

Step 1 — Register the state

Read scripts/jurisdictions/config.py fully first. Determine pull_from_census:

• ["places"] only — states where county subdivisions have no functioning government (statistical/MCD-less states). Most states default here.
• ["places", "county_subdivisions"] — states with legally functioning MCDs (New England, NY, NJ, PA, MI, WI, MN, etc. — towns/townships that are themselves the unit of government, sometimes without a coextensive incorporated place).

If unsure which applies, say so and ask, or reason from Census Bureau MCD classification — don't guess silently.

Add the config block (match existing indentation/style exactly, including any quirks like extra leading spaces already present in neighboring entries). There is no import to add — states are pure data now:

"<state>": {
    "fips": "<fips>",
    "name": "<State Name>",
    "pull_from_census": [...],
    "local_wiki": {},          # filled in by step 2
    "validation_sources": ["google"],
},

FIPS codes: look up the standard 2-digit state FIPS if not already known — don't guess.

Step 2 — Fit local_wiki to the list page

There is no per-state scraper. scripts/jurisdictions/scrapers/municipalities.py handles every state; local_wiki supplies only that state's deviations from the defaults. Read municipalities.py before doing anything here — it is ~60 lines and is the whole contract.

key	default	set it when
table_index	0	the municipality table isn't the page's first wikitable
rows_to_skip	1	the header spans two rows (usually land area splitting into sq mi / km²)
entry_column	0	the place name isn't the first column
title	List_of_municipalities_in_<State_Name>	that title is a disambiguation page (Georgia: the country vs the U.S. state)
parser	"table"	"bullet_list" — the page has no wikitable, just per-letter div.div-col > ul > li bullets (North Carolina)