WorldEnergyData Source Readiness
Quick Start
From the worldenergydata repo root, run:
python .claude/skills/worldenergydata-source-readiness/scripts/source_readiness_summary.py
For JSON output:
python .claude/skills/worldenergydata-source-readiness/scripts/source_readiness_summary.py --format json
What To Report
Use this skill to answer, in one pass:
- data group / module name
- catalog status and freshness status
- latest known date
- repo-local data location
- external data location, if metadata records one
- scheduler output location, if configured
- scheduler success manifest timestamp, if present
- dataset count, record count, file count, and data size
- blocker issue or operational gap, when known from current GitHub issue state
- contract freshness/completeness status from
data/source-refresh-acceptance-contract.json, when acceptance decisions are needed
Source Of Truth Order
docs/data/source-refresh-acceptance-criteria.mdanddata/source-refresh-acceptance-contract.jsonfor pass/fail acceptance decisions.data/freshness-scorecard.jsonfor module-level status.data/modules/<module>/_metadata.jsonfor file counts, sizes, external roots, and newest file modified date.data/modules/<module>/manifest.jsonfor successful scheduler refresh timestamp.config/scheduler/scheduler_config.ymlfor scheduler job names and output directories.data/catalog.yamlfor dataset paths and row counts.
If these disagree, state the disagreement instead of collapsing it. In particular, distinguish:
- metadata refresh date: when the module inventory was generated
- newest file modified date: newest known local file timestamp
- scheduler success date: when a scheduler job last completed successfully
- source data vintage: the newest business/date field inside the dataset; do not claim this unless inspected directly
Run the contract validator before using a source summary as acceptance evidence:
python scripts/audit/validate_source_refresh_contract.py
Acceptance Criteria Drafting Pattern
For Tier-A data-source readiness, require each source to expose:
source_data_latest_datelast_successful_refreshdata_locationrecord_countfreshness_statusrefresh_cadenceblocker_issueornone
Treat a source as green only when it has a successful scheduler manifest or another documented refresh proof within its cadence.
Use docs/data/source-refresh-acceptance-criteria.md for the enum meanings, scorecard-to-contract mapping, source-date basis rules, and scheduler manifest rule.
Details
See references/readiness-fields.md for field definitions and interpretation rules.