open-wine-map

Drive open-wine-map's ruff error count to zero WITHOUT changing behaviour. Use when executing Phase 1 of the improvements plan, or whenever `uv run ruff check scripts/ tests/` reports errors. Covers the safe procedure for each rule class present in this repo (F401, F541, F601, E741, E702, E731, F841, E402), with a mandatory special procedure for F601 duplicate keys in scripts/_lib/grape_lexicon.py — those are DATA, not style, and blind deletion can silently change grape-synonym folding.

Move-only refactor procedure for carving functions out of scripts/04_build_maps.py into scripts/_lib/ modules without changing any build output. Use when executing Phase 6 of the improvements plan ("extract augmenters", "modularize stage 04") or any time a function must move out of 04_build_maps.py / map_template.py. The danger this skill defends against: stage 04 failures are often SILENT (a country or feature just disappears from the map), so verification relies on the golden-output comparator, not on "it didn't crash".

Scaffold + wire the national-spec augmentation layer for an open-wine-map country whose wines are content-stubs (no fetchable EU-OJ single document). Generates the stage 01c fetch script, the _lib/<cc>/specifikacija.py parser, and the stage 02f extractor by copying the closest sibling country, then applies the six stage-04 wiring hooks + the 02d terroir-source fallback at their known anchors, and runs a wiring-lint so a forgotten hook fails loudly (a missing hook silently hides the country from the map). Use when adding a national / regulator product-specification fallback for a country that already has stages 00–03 + stub records — e.g. "add the national-spec layer for Slovakia", "wire SK/HU/CZ national specs into stage 04", or after /research-gaps national-spec resolves a per-wine spec source.

Fill gaps in open-wine-map curation data — missing Wikipedia tooltip cards, unresolved VIVC slugs, wines or AOCs with no source document — by detecting the gap, generating a self-contained web-research prompt, dispatching it to research agents (WebSearch + WebFetch) inside Claude Code, and staging the findings for review before they land in an overrides file. A Claude browser-extension prompt is emitted only for the subset of sources an agent cannot reach (WAF-blocked EUR-Lex, JavaScript-only search UIs). Use when an audit reports `missing` / `error` records, `vivc_id: null` entries, stub wines, or AOC cahier stubs — or when the user asks to research, look up, or fill missing curation data.