pauselisted

# /pause — Session Pause Save-state operation. Commits any in-progress work and records session context so the next session can resume cleanly. ## Invocation ``` /pds:pause # Auto-generate note from recent git log /pds:pause "finished auth, next: tests" # Explicit note about where you left off ``` ## Protocol ### 1. Check Working Tree ```bash git status --short ``` ### 2. Commit Uncommitted Changes (if any) If there are uncommitted changes (staged or unstaged): ```bash git add <relevant files> # Be deliberate — not -A git commit -m "wip: pausing session $(date -u +%Y-%m-%dT%H:%M:%SZ)" ``` If the working tree is clean, skip — do not create an empty commit. ### 3. Save State to `.claude/swarm/pause.json` Write the following JSON: ```json { "timestamp": "<ISO 8601>", "branch": "<current branch>", "phase": "<contents of .claude/swarm/phase, or 'none'>", "tier": "<contents of .claude/swarm/tier, or 'none'>", "uncommitted_files": <count before commit, 0 if clean>, "note": "<user-provided string, or summary from recent git log>" } ``` Read `.claude/swarm/phase` and `.claude/swarm/tier` if they exist; use `"none"` if missing. For auto-generated notes, use: `git log --oneline -3` — summarize what was recently worked on. ### 4. Check for Active Swarm Agents If `.claude/swarm/phase` exists and is not empty, print: ``` Note: a swarm may be active. Consider shutting down agents before closing the session. ``` Do not force-stop