review-checklist
Review a change against this project's blocking gates and quality bar — government sources, SEED_VERSION bump, deno check, translation provenance (machine-draft flags), KPI defensibility. Use before o
SKILL.md.claude/skills/review-checklist/SKILL.md
GitHubReview checklist
The project-specific review standard. The full rubric lives in
docs/code-review-guidelines.md;
this skill is the actionable pass. (For generic diff review use the built-in
/code-review; this one adds the kerala-gov-mission-control rules.)
Run the gates first
deno task check # fmt --check + lint + type-check (blocking)
deno task check:sources # government-source policy (blocking)
deno task check:ml # foreign-script glyphs in data/ (blocking, in CI)
deno task test # unit tests (lib/) (blocking, in CI)
All must be green. These are the same gates the pre-commit hook and CI run.
Blockers — fail the review if any are true
- A published figure (KPI / GO / Status Paper) cites a non-government
source, or is missing
sourceUrl. →docs/data/source-policy.md - A
data/*.tsfixture changed butSEED_VERSIONindata/db.tswas not bumped. -
deno task checkfails (type error / lint / formatting drift). - An LLM-drafted
*Mlstring lackstranslationStatus: "machine-draft"on its record. Machine translation is allowed only as a flagged draft (spec Rule 2.4); unflagged machine Malayalam is a blocker. (Missing entirely is OK withdataStatus: "tbd".) - A new KPI is missing a defensibility field (
ownerDeptId,target, ≥1 external comparator,meta.definition+definitionMl,source,sourceUrl,ownerdesignation,lastRefreshedwith+05:30).
Quality — request changes
- EN field added without a
*Mlcounterpart — human-verified or flaggedmachine-draft(/bilingual-audit). - New island where a server component would do.
- Reinvents an existing type/helper/CSS token instead of reusing it.
- A visual without visible provenance (source + retrieval/refresh date).
- Conflicting official figures picked silently instead of disambiguated in
meta.definition.
Escalate to an agent
kpi-data-reviewer— for anydata/kpis.tschange.governance-data-reviewer— forunverified/tbdDepartment/Minister/ Secretary records.
Report findings as file:line — issue (severity), or "No blocking issues."