gsd-undo

Reverts Git commits for GSe phases or plans using phase manifest dependency checks and confirmation gate.

1|Updated Sep 6, 2015
One-click install
npx skills add https://github.com/deerawan/dotfiles --skill gsd-undo-deerawan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-undo
Source: https://github.com/deerawan/dotfiles/tree/main/claude/skills/gsd-undo
Command: npx skills add https://github.com/deerawan/dotfiles --skill gsd-undo-deerawan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents risky, confusing rollbacks by guiding you to safely revert the right set of Git commits tied to a GSD phase or plan.

Core Features & Use Cases

  • Phase- and plan-aware reverts: Revert all commits for a phase or a specific plan using the phase manifest as the source of truth (with a git log fallback for the phase case).
  • Dependency checks before execution: Validate commit relationships so rollback behavior matches the manifest structure rather than blindly undoing history.
  • Confirmation gate for safety: Requires an explicit “are you sure” step before applying any changes to your repository.

Quick Start

Use gsd-undo to revert all commits for phase 23 after reviewing the proposed changes and confirming the rollback.

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 development phase?

To safely revert git commits for a phase, use a manifest-aware rollback tool that validates commit dependencies before undoing history. This approach relies on the phase manifest to identify the exact commits, ensuring the revert matches the intended structure rather than blindly undoing changes.

What is the best way to undo a full plan range in git after upstream changes fail?

The best way to undo a plan range in git after upstream changes fail is to use a bounded rollback command with a --plan argument. This targets the specific plan range using the phase manifest as the source of truth, preventing unintended history loss.

Does a git revert tool need a confirmation gate before applying changes?

A git revert tool needs a confirmation gate to prevent risky and confusing rollbacks. Requiring an explicit confirmation step before execution ensures you review the proposed changes and validate commit relationships before any modifications are applied to your repository.

How do dependency checks improve git rollback safety?

Dependency checks improve git rollback safety by validating commit relationships before execution. This ensures the rollback behavior matches the manifest structure exactly, preventing the accidental removal of commits that other parts of your project may still depend on.

Can I revert just the most recent interactive selections in git without undoing the whole phase?

You can revert just the most recent interactive selections without undoing a whole phase by using the --last argument. This limits the rollback scope to only the latest set of selections, providing a targeted undo rather than a full phase revert.