gsd-undo

Roll back Git commits for GSD phases or plans with dependency checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of safely reverting Git commits for Get Shit Done (GSD) phases or plans, ensuring that the rollback process is secure and maintains code integrity.

Core Features & Use Cases

  • Safe Revert: Roll back commits with dependency checks to prevent unintended code changes.
  • Phase and Plan Rollback: Revert all commits for a specific phase or plan, as defined in the phase manifest.
  • Interactive Selection: Show recent GSD commits for interactive selection if needed.
  • Use Case: If you've made a mistake in a GSD phase or plan, this Skill allows you to revert the changes safely without disrupting the workflow.

Quick Start

Revert the last 5 commits of the current GSD phase with the command: gsd-undo --last 5.

Frequently Asked Questions about gsd-undo

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

FAQPage Schema
How do I safely revert Git commits for a specific project phase?

To safely revert Git commits for a project phase, use a rollback tool with dependency checks and confirmation gates. This ensures phase-specific reverts maintain code integrity and prevent unintended changes by validating dependencies before execution.

What is the best way to roll back multiple Git commits without breaking dependencies?

The best way to roll back multiple Git commits without breaking dependencies is using a rollback mechanism that resolves dependencies via a phase manifest. This approach checks dependencies interactively before reverting, ensuring safe commit rollback across the project.

Do I need a phase manifest to perform a plan-specific commit rollback?

Yes, you need a phase manifest to perform a plan-specific commit rollback. The manifest is explicitly required for dependency resolution, allowing the rollback process to safely identify and revert all commits associated with that specific plan.

How does interactive commit selection work during a Git revert?

Interactive commit selection during a Git revert works by displaying recent commits for user selection. Instead of automatically rolling back, it shows recent project commits, allowing you to interactively choose specific commits to revert safely.

Can I revert the last few commits in my current development phase?

Yes, you can revert the last few commits in your current development phase by specifying the number of commits to undo. This reverts the specified number of recent commits safely with built-in dependency checks and confirmation gates.