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.