Intent
Let operators inspect what will change before execution.
When to use
- Changes are destructive or high risk.
- Large syncs need preview.
- Stakeholders want to review planned actions.
Core mechanics
- Generate an action plan without applying changes.
- Report counts and sample records.
- Require explicit apply to proceed.
Implementation checklist
- Implement a simulation path for each action.
- Output a detailed plan with counts.
- Highlight risky or destructive steps.
- Document differences between dry-run and apply.
- Store the plan for review.
Failure modes and mitigations
- Drift between dry-run and apply -> recompute before execution.
- False confidence -> document limitations and assumptions.
- Incomplete preview -> ensure all actions are listed.
Observability and validation
- Planned vs applied counts.
- Review notes and approvals.
Artifacts
- Dry-run report.
- Action plan export.