| name | kata-pause-work |
| description | Create a context handoff file, pausing work mid-phase, stopping work temporarily, or creating a checkpoint for session resumption. Triggers include "pause work", "stop work", "create handoff", "save progress", and "pause session". |
| metadata | {"version":"1.6.1"} |
Create `.continue-here.md` handoff file to preserve complete work state across sessions.
Enables seamless resumption in fresh session with full context restoration.
@.planning/STATE.md
Find current phase directory using universal discovery:
CURRENT_PHASE=$(grep -oP 'Phase: \K[0-9]+' .planning/STATE.md 2>/dev/null | head -1)
PADDED=$(printf "%02d" "$CURRENT_PHASE" 2>/dev/null || echo "$CURRENT_PHASE")
PHASE_DIR=""
for state in active pending completed; do
PHASE_DIR=$(find .planning/phases/${state} -maxdepth 1 -type d -name "${PADDED}-*" 2>/dev/null | head -1)
[ -z "$PHASE_DIR" ] && PHASE_DIR=$(find .planning/phases/ -maxdepth 1 - d -name 2>/dev/null | -1)
[ -n ] &&
[ -z ];
PHASE_DIR=$(find .planning/phases -maxdepth 1 - d -name 2>/dev/null | -1)
[ -z ] && PHASE_DIR=$(find .planning/phases -maxdepth 1 - d -name 2>/dev/null | -1)
**Collect complete state for handoff:**
**Write handoff to `${PHASE_DIR}/.continue-here.md`:**
**Check planning config:**
```
✓ Handoff created: ${PHASE_DIR}/.continue-here.md