safe-rollback

Identify and revert phase-related commits with dependency-aware rollback planning.

9|1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/calcosmic/Aether --skill safe-rollback-calcosmic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: safe-rollback
Source: https://github.com/calcosmic/Aether/tree/main/.aether/skills-codex/colony/safe-rollback
Command: npx skills add https://github.com/calcosmic/Aether --skill safe-rollback-calcosmic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safe git phase rollback requires dependency-aware planning to avoid downstream failures by consulting a phase manifest and tracking changes across commits.

Core Features & Use Cases

  • Dependency-aware rollback planning that maps commits to phases using the phase manifest
  • Safety checks and impact analysis across downstream phases
  • Branch-based rollback workflow with reverse-chronological reverts
  • Conflict detection, pause for user guidance, and audit-ready rollback logging
  • Manifest update and rollback-log record to preserve history

Quick Start

Run the safe-rollback workflow to revert a phase with dependency-aware checks and an audit trail

Frequently Asked Questions about safe-rollback

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

FAQPage Schema
How do I safely rollback git commits without breaking downstream dependencies?

Safe git rollback requires dependency-aware planning that consults a phase manifest to map commits to phases. This approach analyzes downstream dependencies to determine the safe rollback scope, preventing breakages across phases and plans during reverts.

What is a dependency-aware rollback and when do I need it?

Dependency-aware rollback is a git reversion process that checks downstream impacts before undoing changes. You need it when reverting phase-related commits, as it analyzes downstream dependencies to ensure undoing changes does not cause failures in subsequent phases or dependent plans.

How do I revert a phase commit while maintaining an audit trail?

To revert a phase commit while maintaining an audit trail, use a branch-based rollback workflow that includes conflict detection and rollback logging. This workflow updates the phase manifest and records a rollback log entry to preserve history and satisfy audit requirements.

Does branch-based rollback work with phase manifests for conflict detection?

Yes, branch-based rollback works with phase manifests by analyzing the manifest to map commits to phases. It performs conflict detection during the reversion process, pausing for user guidance when conflicts arise, to ensure safe dependency-aware reverts.

What are the limitations of reverting git commits without dependency analysis?

Reverting git commits without dependency analysis risks downstream breakages across phases and plans. It lacks automated conflict detection and impact analysis, meaning manifest updates and rollback logging must be handled manually to preserve history, increasing the chance of errors.