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