cc-os/plugins/os-shortcuts/invariants.md

os-shortcuts behavioral invariants

Reversion protection for the wrap skill. Any change that breaks one of these is a regression, not a refactor. No automated test suite exists yet (the skill is prompt-only, no scripts) — enforced by review of skills/wrap/SKILL.md against this list.

1. Never auto-invoked. wrap has no hook wiring and runs only when the user explicitly triggers it ("wrap up", "wrap", end-of-session). It must never fire from a SessionStart/SessionEnd/other hook.
2. Never force-pushes or skips hooks. Commits made during wrap follow this repo's standing git-safety rules: never --no-verify, never force-push, new commits rather than amends.
3. Session-close ritual runs in order: review → commit → sweep → handoff. The handoff summary (step 4) is always the final message, and always covers Done / In flight / Next steps — it must not be skipped even when steps 2–3 found nothing to do.
4. No fabricated doc-update conventions. The docs/todo sweep (step 3) only touches files a project's own CLAUDE.md (or discernible existing convention) identifies as a source of truth; if none exists, wrap skips the step and says so rather than inventing structure.