| name | rollback-rca |
| description | Stop ineffective iteration loops and choose a controlled recovery path after repeated gate failures. |
Rollback & RCA Skill
Purpose
Stop ineffective iteration loops and choose a controlled recovery path after repeated gate failures.
Use when
- An issue fails completion gate 3 consecutive times
Procedure
- Stop work on the issue immediately.
- Run root cause analysis:
- Architecture mismatch?
- Dependency/environment problem?
- Scope too broad?
- Present options via the runtime's designated question tool (e.g.,
ask_user, #askQuestion), which is MANDATORY:
- Rescope (split into smaller sub-issues)
- Rollback (revert to last known good commit)
- Redesign (change architecture)
- Execute selected path and document rationale in session log.
Related Skills
completion-gate — this skill triggers when the gate fails 3 times consecutively
session-logging — document the rollback rationale and recovery path in the session journal
Rollback Rules
- Keep history clean and revertible.
- Roll back only to the last commit that passed gate.
- Record rollback cause and follow-up plan.
Done Criteria
- Issue has an approved recovery path and documented rationale.
Anti-patterns
- Blindly retrying same failing strategy
- Silent rollback without traceability
- Continuing without user alignment