gsd-pause-work

Create a .continue-here.md handoff document when pausing work.

Updated Apr 22, 2025
One-click install
npx skills add https://github.com/mcampbellr/.dotfiles --skill gsd-pause-work-mcampbellr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-pause-work
Source: https://github.com/mcampbellr/.dotfiles/tree/main/claude/.claude/skills/gsd-pause-work
Command: npx skills add https://github.com/mcampbellr/.dotfiles --skill gsd-pause-work-mcampbellr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

GSD Pause Work provides a means to efficiently handle and handoff incomplete work mid-task to ensure you can resume seamlessly later on.

Core Features & Use Cases

  • Workflow Context Preservation: Creates a .continue-here.md file to document your current work state for a mid-break pause.
  • Phase Detection: Identifies the current work phase based on recent files.
  • Complete State Capture: Gathering information about work progress, decisions, and blockers.
  • Handoff File Generation: Creates a comprehensive handoff file with all context needed to resume the work.
  • Git Integration: Allows commit as work in progress (WIP).
  • Resume Instructions: Provides simple guidelines for future continuation.

Quick Start

Run gsd-pause-work --report to save the current work context as a handoff file.

Frequently Asked Questions about gsd-pause-work

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save my work context before taking a break from coding?▼

To save your work context before a break, use the `--report` command to generate a `.continue-here.md` handoff file. This captures your current progress, decisions, and blockers, while also committing a work in progress (WIP) save to your Git repository.

What is a context handoff document for resuming incomplete work?▼

A context handoff document is a generated text file that records your current work phase, recent progress, and blockers. It serves as a comprehensive resume guide, allowing you to seamlessly continue coding or drafting documents after a mid-task interruption.

Can I preserve work state in a Git repository without completing the task?▼

Yes, you can preserve work state in a Git repository by creating a work in progress (WIP) commit. This captures your incomplete code changes alongside a generated handoff file, ensuring no work is lost when you pause.

How does phase detection work for document drafting and coding sessions?▼

Phase detection identifies your current work phase by analyzing your recently accessed files. It uses this file history to determine whether you are in a coding or document drafting session, gathering the specific context needed to generate accurate resume instructions.

Do I need Git integration to manage incomplete work states?▼

Yes, Git integration is required to manage incomplete work states effectively. The system relies on Git repositories to save work in progress (WIP) commits and store the `.continue-here.md` handoff file alongside your active project files.

What's the best way to resume a workflow after a mid-task interruption?▼

The best way to resume a workflow after an interruption is by referencing the generated `.continue-here.md` handoff file. This document provides simple guidelines and captured context, allowing you to seamlessly pick up exactly where the previous work phase left off.