rollback

Plans a safe reversal of a completed Blueprint feature using its archived spec and git commit.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/LeroyAdonis/kitfix-2.0 --skill rollback-leroyadonis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rollback
Source: https://github.com/LeroyAdonis/kitfix-2.0/tree/main/.agents/skills/rollback
Command: npx skills add https://github.com/LeroyAdonis/kitfix-2.0 --skill rollback-leroyadonis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Removing a completed feature from a codebase is risky: later commits may depend on it, history can be lost, and ad-hoc reverts often break unrelated work. This Skill plans a guarded rollback by locating the exact feature commit, reviewing later changes for dependency risk, and writing a reviewable rollback spec before any code changes. ## Core Features & Use Cases - Exact Commit Resolution: Matches a build-plan number, feature name, or archive path to the squashed git commit that introduced the feature, refusing ambiguous or merge-commit targets. - Later-Change Risk Review: Inspects every commit after the target touching the same product paths and classifies the rollback as no overlap, compatible, dependency risk, or blocked. - Guarded Rollback Spec: Writes a Type: Rollback spec to blueprint/context/current-feature.md with protected paths, verification commands, and observable removal criteria, then stops for human review before /implement applies changes. - Use Case: After shipping a PDF export feature that corrupts files, run /rollback 4 to generate a reviewed plan that reverses only that feature's product diff while preserving Blueprint history and later compatible work. ## Quick Start Ask the assistant to roll back a completed feature by name or build-plan number, for example: run /rollback 4 because the new export flow is corrupting files.

Frequently Asked Questions about rollback

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

FAQPage Schema
How do I safely remove a completed feature from my codebase?▼

Run /rollback with the feature's build-plan number, name, or archive path. The skill locates the exact introducing commit, reviews later commits for dependency risk, and writes a rollback spec for your review before /implement applies any code change.

Does the rollback skill delete git history or feature archives?▼

No. The skill preserves all Blueprint history, including the original feature archive and later plan changes. It never uses git reset --hard, force-push, or history rewriting; it only plans a reverse diff of product paths.

What happens if later commits depend on the feature I want to roll back?▼

The skill classifies the situation as dependency risk or blocked and stops rather than guessing. It explains the concrete later commit and contract involved, then asks you to choose a narrower remediation or explicitly plan dependent rollbacks.

Why does rollback refuse to run with a dirty working tree?▼

A dirty tree or non-main branch makes it impossible to guarantee the reverse patch applies cleanly and only to the target's product paths. The preflight check stops and asks you to clean up first; it never stashes or discards changes itself.

Can rollback revert multiple features at once?▼

No. The skill handles exactly one completed feature per rollback and never cascades into reverting later features silently. Each reversal goes through the same /implement, /check, and /complete review gates.