gsd-resume-work

Restore project session context from STATE.md and checkpoint files.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-resume-work-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-resume-work
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-resume-work
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-resume-work-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Projects are frequently interrupted and contributors lose critical in-memory context, checkpoints, and the precise next action to continue work; this Skill restores that context so work can continue without manual reconstruction. It addresses missing or outdated STATE.md files by attempting safe reconstruction, detects checkpoint markers (.continue-here), and flags incomplete work patterns like PLAN entries without SUMMARY so nothing is accidentally skipped.

Core Features & Use Cases

  • STATE.md loading & reconstruction: Load an existing STATE.md or rebuild a best-effort project state when it is absent.
  • Checkpoint detection: Find .continue-here files and visualize where previous sessions paused.
  • Incomplete-work detection: Identify PLAN entries without SUMMARY and surface incomplete tasks for review.
  • Context-aware routing: Inspect CONTEXT.md and route to planning, discussion, or direct execution as appropriate.
  • Session continuity: Update session state and offer the next actionable command to resume work seamlessly.
  • Use Case: A developer returns to a paused feature branch; the Skill reconstructs the session state, highlights the last checkpoint, and proposes the next task to execute.

Quick Start

Use the gsd-resume-work skill to load or reconstruct STATE.md, detect checkpoints, present the current status, and propose the next actionable step for the project session.

Frequently Asked Questions about gsd-resume-work

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

FAQPage Schema
How do I restore project session context after an interruption?

To restore project session context, this Skill loads existing STATE.md or reconstructs a best-effort state, detects .continue-here checkpoint files, and identifies incomplete PLAN entries without SUMMARY markers to resume unfinished work seamlessly.

What happens if my STATE.md file is missing or outdated?

If STATE.md is missing or outdated, the Skill attempts safe reconstruction to rebuild a best-effort project state, ensuring no incomplete tasks or checkpoints are accidentally skipped during session restoration.

How do I detect incomplete work patterns in my local repository?

Detecting incomplete work patterns involves scanning local repository workflows for PLAN entries without SUMMARY markers and .continue-here checkpoint files, surfacing unfinished tasks for review before continuing project execution.

Do I need specific file permissions to execute session state restoration?

Yes, session state restoration requires read and write access to project files and permission to execute the resume-project workflow at ~/.claude/get-shit-done/workflows/resume-project.md to reconstruct state and route next actions.

Can I route to planning or discussion based on project context?

Yes, context-aware routing inspects CONTEXT.md to determine whether to route to planning, discussion, or direct execution based on the current project session state and detected checkpoint markers.

What's the best way to resume a paused feature branch without manual reconstruction?

The best way to resume a paused feature branch is using checkpoint detection and state reconstruction to highlight the last .continue-here checkpoint, update session state, and propose the next actionable command to execute.