rollback-changes

Rollback failed workflow phases by restoring files and reversing commands from changes logs.

243|40|Updated Nov 11, 2025
One-click install
npx skills add https://github.com/maslennikov-ig/claude-code-orchestrator-kit --skill rollback-changes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rollback-changes
Source: https://github.com/maslennikov-ig/claude-code-orchestrator-kit/tree/main/.claude/skills/rollback-changes
Command: npx skills add https://github.com/maslennikov-ig/claude-code-orchestrator-kit --skill rollback-changes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reverts modifications from a failed workflow phase using a changes log and backups.

Core Features & Use Cases

  • Backup-driven rollback: Restores modified files from backups and deletes created files.
  • Command reversal: Reverts specific commands and, if possible, undoes git commits.
  • Audit trail: Generates a rollback report with actions taken and any warnings.

Quick Start

Roll back a failed security remediation phase using the changes log.

Frequently Asked Questions about rollback-changes

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

FAQPage Schema
How do I rollback changes from a failed workflow phase?

Rollback changes by providing a changes log JSON file with phase details, file modifications, and git commits. The Skill restores modified files from backups, deletes created files, reverts commands, and undoes git commits, then generates an audit report of actions taken.

What information do I need in a changes log to rollback?

A changes log requires phase name, timestamp, files_modified, files_created, commands_executed, and git_commits. Optional fields include artifacts, plan_files, and metadata. The Skill validates the JSON structure before proceeding with restoration.

Can I rollback git commits as part of the restoration process?

Yes, rollback automatically reverts git commits recorded in the changes log. If commit reversal is possible, it executes the undo; otherwise, it flags limitations in the rollback report for manual review.

What happens to files created during a failed phase when I rollback?

Files created during the failed phase are deleted during rollback. Modified files are restored from backups. The Skill generates a detailed report showing all restoration actions and any warnings encountered.

Does rollback work for security patches, bug fixes, and refactoring phases?

Yes, rollback applies across bug fixes, security patches, refactoring, and other workflow stages. It uses the same changes log structure and restoration logic regardless of phase type or complexity.

What should I do if rollback encounters errors or warnings?

The Skill requests confirmation before executing restoration steps and generates an audit trail report documenting all actions, warnings, and any limitations. Review the report to assess manual intervention needs.