aoa-dry-run-first

Enforce a pre-mutation dry-run and explicit confirmation gate for state-changing tasks.

4|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/8Dionysus/aoa-skills --skill aoa-dry-run-first
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aoa-dry-run-first
Source: https://github.com/8Dionysus/aoa-skills/tree/main/.agents/skills/aoa-dry-run-first
Command: npx skills add https://github.com/8Dionysus/aoa-skills --skill aoa-dry-run-first

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill eliminates the risk of accidental mutations by enforcing a pre-mutation dry-run and a visible, explicit confirmation step before any concrete change.

Core Features & Use Cases

  • Enforces a strict two-phase contract: a non-mutating preview path followed by a named mutating action.
  • Provides explicit confirmation gates that require naming the exact mutation and the touched surfaces.
  • Documents inputs, outputs, limitations, and traces techniques for auditability and safe rollbacks.

Quick Start

Invoke aoa-dry-run-first to generate a preview contract, review the plan, and obtain explicit confirmation before applying any mutation.

Frequently Asked Questions about aoa-dry-run-first

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

FAQPage Schema
How do I preview state changes before applying a deployment or migration?

To preview state changes before applying a deployment or migration, enforce a pre-mutation dry-run that generates a non-mutating preview path, allowing you to validate the exact mutation before execution.

What is a dry-run confirmation gate for mutation safety?

A dry-run confirmation gate for mutation safety is a strict two-phase contract requiring a validated preview path followed by an explicit confirmation prompt naming the exact mutation and touched surfaces before any state-changing action is applied.

How do I prevent accidental mutations during infrastructure reconfiguration?

To prevent accidental mutations during infrastructure reconfiguration, require a structured preview contract with documented inputs, outputs, and limitations, followed by a mandatory confirmation gate before the named mutating action executes.

Can I use a dry-run preview pattern for deletion tasks?

Yes, you can use a dry-run preview pattern for deletion tasks by enforcing a formal contract that requires a non-mutating preview step to identify touched surfaces, followed by an explicit confirmation gate before the actual deletion occurs.

What is the best way to ensure safe rollbacks after a state-changing migration?

The best way to ensure safe rollbacks after a state-changing migration is to use a formal dry-run contract that traces techniques and documents limitations during the preview phase, creating an auditable record for safe recovery.

Are there limitations to enforcing a pre-mutation dry-run contract?

Limitations of enforcing a pre-mutation dry-run contract include the requirement to explicitly document inputs, outputs, and traces for auditability, which may add overhead to state-changing tasks like deployment or reconfiguration.