gsd-undo

Revert GSD phase or plan commits with dependency checks and confirmation.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-undo-poom5741
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-undo
Source: https://github.com/Poom5741/eggo-world-pb/tree/main/.qwen/skills/gsd-undo
Command: npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-undo-poom5741

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rewriting history after a GSD phase or plan can introduce inconsistencies and break dependencies. This Skill provides a safe, dependency-aware revert path that respects the phase manifest.

Core Features & Use Cases

  • Dependency-aware revert: ensure phase or plan rollbacks respect manifest dependencies.
  • Safe confirmation gate: requires explicit confirmation before executing destructive reverts.
  • Targeted rollback: revert recent commits for a phase or an entire plan without touching unrelated work.

Use Case: Imagine a product development cycle where a phase produced breaking changes; you need to revert only that phase's commits without discarding other work in parallel features.

Quick Start

Specify the target using --last N, --phase NN, or --plan NN-MM and confirm to perform a safe revert.

Frequently Asked Questions about gsd-undo

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

FAQPage Schema
How do I revert git commits for a specific development phase without breaking dependencies?

To revert git commits safely without breaking dependencies, you need a dependency-aware revert process that checks a phase manifest. This approach validates dependencies before rolling back targeted phase commits while leaving unrelated parallel work untouched.

What is the safest way to undo a plan commit in a phased git workflow?

Undoing a plan commit in a phased git workflow requires a safe confirmation gate that prevents destructive reverts. The process checks the phase manifest and requires explicit confirmation before selectively rolling back the targeted plan changes.

Can I roll back the last N commits in git without discarding unrelated work?

Yes, you can roll back the last N commits without discarding unrelated work by using a targeted rollback mechanism. This dependency-aware revert path respects the phase manifest to ensure only the specified recent commits are reverted.

Do I need a phase manifest to perform a dependency-aware git revert?

Yes, a phase manifest is required to perform a dependency-aware git revert. The manifest provides the necessary dependency mapping to ensure phase or plan rollbacks execute safely without introducing inconsistencies in the git history.

Why does rewriting git history after a development phase introduce inconsistencies?

Rewriting git history after a development phase introduces inconsistencies because standard reverts ignore manifest dependencies. A safe revert path checks these dependencies and applies a confirmation gate to prevent breaking related work during the rollback.

What are the limitations of using a targeted revert for git phase rollbacks?

The limitation of a targeted git phase revert is that it strictly requires a phase manifest to function. Without this manifest, the dependency-aware revert cannot validate whether rolling back specific plan commits will break the broader development workflow.