revise

Roll back a spec to an earlier pipeline phase and mark artifacts stale.

1|Updated May 28, 2026
One-click install
npx skills add https://github.com/amoutiers/maxi-superpowers --skill revise-amoutiers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: revise
Source: https://github.com/amoutiers/maxi-superpowers/tree/main/skills/revise
Command: npx skills add https://github.com/amoutiers/maxi-superpowers --skill revise-amoutiers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rolling back a spec to an earlier pipeline phase when requirements or design change helps keep the project aligned with current goals and prevents downstream drift.

Core Features & Use Cases

  • Selective rollback: Move a spec back to a valid previous status (clarified, planned, tasked, analyzed, or implemented) without breaking downstream artifacts.
  • In-flight spec targeting: Operates on the active spec in flight; if multiple specs exist, prompts for the target slug.
  • Guardrails: Enforces constraints (e.g., cannot roll back from done or cancelled) and records provenance for auditability.

Quick Start

Describe the change that requires revision and run /maxi:revise to roll back to the target status.

Frequently Asked Questions about revise

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

FAQPage Schema
How do I rollback a spec to an earlier pipeline phase when requirements change?

To rollback a spec when requirements change, you describe the design change and trigger the revision command. The system validates that the requested status is allowed and writes the new status to spec.md, marking downstream artifacts as stale.

What happens to downstream artifacts when I reverse a spec transition?

When you reverse a spec transition, downstream artifacts are left on disk but explicitly marked as stale. This prevents downstream drift while keeping previous outputs accessible for reference or deletion.

Can I roll back a spec from any pipeline status?

No, you cannot roll back a spec from done or cancelled statuses. The system enforces guardrails that validate the current state permits a reverse transition to a previous phase like clarified, planned, tasked, analyzed, or implemented.

How do I handle spec rollback when multiple in-flight specs exist?

When multiple in-flight specs exist, the system prompts you to select the target slug. This ensures the rollback operation targets the correct active spec without accidentally modifying unrelated pipeline phases.

Does rolling back a pipeline spec require manual confirmation?

Yes, rolling back a pipeline spec requires manual confirmation. The system prompts for consent before writing the new status to spec.md to ensure the reverse transition is intentional and provenance is recorded for auditability.

Why should I use a guarded rollback process for spec status changes?

A guarded rollback process for spec status changes prevents invalid reverse transitions and records provenance for auditability. It keeps the project aligned with current goals by validating allowed statuses before modifying spec.md.