Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions skills/pause-work/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,10 +37,10 @@ routing:
Capture ephemeral session reasoning into durable artifacts so the next session can resume without wasting time on context reconstruction. `task_plan.md` records WHAT tasks exist; this skill captures WHY the current session chose a particular approach, what it rejected, and what it planned to do next.

Two output files serve different audiences because each addresses a distinct use case:
- `HANDOFF.json` — machine-readable, consumed by `/resume` for automated state reconstruction. Must always be produced to enable `/resume` routing.
- `HANDOFF.json` — machine-readable, consumed by `/resume-work` for automated state reconstruction. Must always be produced to enable `/resume-work` routing.
- `.continue-here.md` — human-readable, for users who want to understand session state without starting a new session. Must always be produced to support human-only resumption paths.

Skipping either file breaks half the use case: without the JSON, `/resume` cannot detect handoff state automatically; without the markdown, users cannot quickly grok where things stand.
Skipping either file breaks half the use case: without the JSON, `/resume-work` cannot detect handoff state automatically; without the markdown, users cannot quickly grok where things stand.

## Instructions

Expand All @@ -59,7 +59,7 @@ Find the git root directory:
git rev-parse --show-toplevel
```

All subsequent paths and file writes target this root, not the current working directory because writing to the project root ensures `/resume` can find the files reliably across different shell invocation contexts.
All subsequent paths and file writes target this root, not the current working directory because writing to the project root ensures `/resume-work` can find the files reliably across different shell invocation contexts.

**Step 3: Collect git state**

Expand Down Expand Up @@ -197,7 +197,7 @@ Write to `{project_root}/HANDOFF.json` with UTC ISO 8601 timestamps for unambigu

**Step 2: Write .continue-here.md**

Write to `{project_root}/.continue-here.md` because humans need prose-form state before committing to `/resume`:
Write to `{project_root}/.continue-here.md` because humans need prose-form state before committing to `/resume-work`:

```markdown
# Continue Here
Expand Down Expand Up @@ -273,7 +273,7 @@ Display the handoff summary:

Next action: <brief next_action summary>

Resume with: /resume
Resume with: /resume-work
===================================================================
```

Expand All @@ -288,7 +288,7 @@ Display the handoff summary:
**Solution**: If the session genuinely did no work, there is nothing to hand off. Inform the user: "No work detected to hand off. If you made changes that aren't committed or tracked, describe what you were working on and I'll create the handoff manually."

### Error: HANDOFF.json Already Exists
**Cause**: A previous `/pause` created handoff files that were not yet consumed by `/resume`
**Cause**: A previous `/pause` created handoff files that were not yet consumed by `/resume-work`
**Solution**: Warn the user that stale handoff files exist. Offer to overwrite (default) or append. Overwriting is almost always correct — stale handoffs from abandoned sessions should not block new ones.

## References
Expand Down
6 changes: 3 additions & 3 deletions skills/resume-work/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,11 +33,11 @@ routing:
category: process
---

# /resume - Session State Restoration
# /resume-work - Session State Restoration

## Overview

This skill reconstructs session state from handoff artifacts so work can continue without wasting time re-reading files and re-discovering decisions. It is the consumer half of the pause/resume pair — `/pause` creates the artifacts, `/resume` consumes them.
This skill reconstructs session state from handoff artifacts so work can continue without wasting time re-reading files and re-discovering decisions. It is the consumer half of the pause/resume pair — `/pause-work` creates the artifacts, `/resume-work` consumes them.

The priority cascade exists because handoff quality varies:
1. **HANDOFF.json** — Best case. Machine-readable, structured, created by explicit `/pause`. Contains reasoning context.
Expand Down Expand Up @@ -200,7 +200,7 @@ If user discards, fall to next priority level in cascade.

### Phase 4: EXECUTE

**Goal**: Route to the next action and clean up handoff files (they are ephemeral session artifacts, not persistent state, so keeping them risks future `/resume` calls loading outdated context).
**Goal**: Route to the next action and clean up handoff files (they are ephemeral session artifacts, not persistent state, so keeping them risks future `/resume-work` calls loading outdated context).

**Step 1: Execute next action**

Expand Down
Loading