-
Inspect the current diff first.
Use git status --short and git diff --name-only.
-
Read the validation matrix before running commands.
@references/validation-matrix.md
-
Choose the smallest useful set of validations that matches the touched files.
-
Never use npm run lint as a read-only validation step.
It runs Prettier write mode in this repository.
-
Prefer the constrained-environment Jest commands when needed.
Use env JEST_USE_WATCHMAN=0 npm test -- --runInBand --watchman=false.
-
Run python3 scripts/check_content_contract.py for article changes.
-
Run npx tsc --noEmit --pretty false for TypeScript, route, component, or library changes.
-
Run npm run build for page, layout, config, or global styling changes when it is worth the extra cost.
If it fails because of Google font fetching, report that as an environment limitation unless there is evidence of a code regression.
-
Report exactly what ran, what passed, what failed, and what was skipped.