Review changes against SPEC.md and docs/decisions/. Capture architectural decisions as ADRs, update SPEC.md if invariants changed. Run before pushing.
Review the current branch's changes against the project's correctness envelope and decision records. Propose updates if needed, skip if nothing changed.
Before pushing to a PR branch. Part of the pre-push workflow in AGENTS.md:
mise run check — must pass/spec-sync — this skill/context-engineering update — if AGENTS.md affected/docs-workflow update — if docs/ affectedgit diff origin/main...HEAD --name-only
git diff origin/main...HEAD --stat
If no changes, report "nothing to sync" and exit.
SPEC.md — current invariants, requirements, interfacesdocs/decisions/ — existing ADRs (if directory exists)For each significant change, ask:
Skip trivial changes: formatting, typo fixes, test-only changes, dependency bumps without behavioral impact.
ADRs: One ADR per branch summarizing key decisions. Follow the schema:
---