gsd-undo

Revert GSD phases or plans with manifest-based validation and dependency checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reverting GSD workflows can be risky without guardrails. This Skill standardizes safe undo operations by targeting phase or plan reversions with manifest-based validation and a confirmation gate.

Core Features & Use Cases

  • Phase revert: revert all commits for a given phase using the manifest as the source of truth.
  • Plan revert: revert all commits for a specific plan with fallback to git history when needed.
  • Dependency-aware safety: ensures dependencies are respected before applying reverts and provides an auditable trail.

Quick Start

Activate the gsd-undo workflow by triggering the manifest-driven undo with dependency checks and a confirmation gate.

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

To safely revert git commits for a workflow phase, use a manifest-driven undo process that validates dependencies and requires a confirmation gate before rolling back. This ensures the phase reversion is controlled and auditable.

What is the best way to undo an entire plan in git without breaking dependencies?

Undoing an entire plan in git without breaking dependencies requires a dependency-aware revert mechanism that checks the phase manifest and falls back to git history, providing a safe and auditable rollback trail.

How does a manifest-based git revert work for controlled rollbacks?

A manifest-based git revert works by using the phase manifest as the source of truth to identify commits, checking dependencies, and applying a confirmation gate to ensure a safe, auditable rollback.

Can I undo git changes if the original phase manifest is missing?

Yes, you can undo git changes if the phase manifest is missing by using the plan revert mode, which falls back to standard git history to identify and roll back the necessary commits safely.

When should I use a dependency-aware revert instead of standard git revert?

You should use a dependency-aware revert instead of standard git revert when working within structured workflows where phases and plans must be undone in a controlled, auditable manner without violating dependency relationships.

Does the git revert process require manual confirmation before applying changes?

Yes, the git revert process requires a manual confirmation gate before applying any changes, ensuring that the manifest-based scope validation and dependency checks are reviewed for a safe rollback.