revert

The revert skill is a sophisticated safe rollback agent designed to maintain project integrity during complex development workflows. Unlike standard git revert operations that function on a commit-by-commit basis, this skill understands the logical structure of a project managed by metadata.json and plan.md. It allows developers to undo entire tracks, specific phases, or individual tasks by identifying all associated commits, tracking file changes, and performing automated state validation to ensure the codebase remains consistent after the reversal. This tool is intended for software engineers and leads who need to maintain clean git history while managing multi-stage development tasks.

• Logical grouping of commits linked to specific tasks, phases, or tracks.

• Mandatory multi-phase revert workflow including impact analysis and user confirmation gates.

• Automatic state synchronization between the git repository, metadata.json, and the project plan.md file.

• Safe-by-default execution creating revert commits instead of destructive force-pushes, preserving project auditability.

• Post-revert validation including project quality checks and consistency reporting.

• Input: User request specifying the scope of reversal (track, phase, or task).

• Operation: Analyzes history, lists affected files/commits, requests explicit user approval, executes reversal, and updates project documentation.

• Constraints: Requires strict adherence to a 5-phase task lifecycle; always mandates preview before action; requires manual confirmation for high-risk operations.

• Best for: Recovering from failed feature implementations, reverting experimental work, or cleaning up stale tasks in structured engineering environments.