22 lines
1.2 KiB
Markdown
22 lines
1.2 KiB
Markdown
# 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.
|