# 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.
