wrap

Wrap

Session wrap-up: reflect, clean worktrees, prepare for /clear.

1. Reflect

Invoke /reflect via the Skill tool. Wait for it to complete before proceeding.

Do NOT inline reflect logic — invoke the skill. It handles MEMORY.md, Basic Memory vault, GitHub issues, plan finalization, and .last-reflect-ts.

2. Session Cleanup

After reflect completes, clean up session worktrees:

REPO_ROOT="$(git rev-parse --show-toplevel)"
git -C "$REPO_ROOT" worktree list

For each entry under .worktrees/ (never the main worktree):

REPO_ROOT="$(git rev-parse --show-toplevel)"
BRANCH=$(git -C <worktree-path> rev-parse --abbrev-ref HEAD)
git -C "$REPO_ROOT" branch --merged main | grep -q "$BRANCH" && MERGED=true || MERGED=false

• Merged: git -C "$REPO_ROOT" worktree remove <path> + git -C "$REPO_ROOT" branch -d "$BRANCH"
• Not merged: warn with branch name, do not delete

.branch-context.md: If it exists at "$REPO_ROOT/.branch-context.md" and reflect confirmed learnings were consolidated, delete it. If reflect skipped it or reported no learnings, leave it and warn: ".branch-context.md may contain unreflected learnings."

Report:

Session cleanup:
  Removed: .worktrees/feat-foo (branch feat/foo, merged)
  Kept:    .worktrees/feat-baz (branch feat/baz, NOT merged)
  Cleaned: .branch-context.md (learnings consolidated)

3. Prompt /clear

Session wrapped. Type /clear when ready.

Do NOT invoke /clear — it is a built-in command only the user can type. After /clear, the SessionStart hook injects catchup instructions automatically.

Common Mistakes

Mistake	Fix
Inlining reflect logic	Invoke /reflect via Skill tool
Removing unmerged worktrees	Warn only — never delete unmerged work
Invoking /clear directly	Tell user to type it — /clear is a built-in
Cleaning main worktree	Only clean .worktrees/* entries
Skipping cleanup report	Always report what was cleaned/kept