Conductor Revert
Overview
This skill is a Git-aware assistant. Unlike a standard git revert, it understands the relationship between implementation commits and the Conductor documentation. It ensures that when code is reverted, the corresponding plan.md and tracks.md files are also reset to their previous states.
When to Use
- When a user says "Undo that task," "Revert the last phase," or "I want to delete this track and its changes."
- To cleanly roll back a feature that isn't working as expected.
Workflow
- Target Identification: Interactively help the user select a Track, Phase, or Task to revert. Present a unified hierarchical menu with a max of 4 choices.
- Git Analysis (Reconciliation): Map the logical Conductor item to specific Git commit SHAs. Include the Track Creation commit if an entire track is being reverted. Handle "Ghost" commits if SHAs are missing.
- Plan Presentation: Show the user the exact commits to be reverted and the planned order.
- Safe Execution: Perform the reverts in reverse order, handle conflicts, and manually synchronize the Conductor artifacts to match the reverted code state.
Implementation Details
Refer to the following protocols for detailed procedural instructions:
- Resolution Protocol: references/resolution-protocol.md - How to find Conductor artifacts.
- Revert Protocol: references/revert-protocol.md - The logic for mapping Conductor items to Git history and executing reverts.
Mandatory Constraints
- Double Confirmation: Always confirm the target selection AND the final execution plan before running
git revert. - Reverse Order: Reverts MUST be performed in reverse chronological order.
- Plan Sync: The final step MUST be verifying that
plan.mdortracks.mdreflects the reverted state.