dry-run

Problem: Commands make real changes - creating files, spawning agents, modifying state, executing git operations. Testing commands on production workflows risks unintended modifications.

Solution: Add --dry-run flag that:

1. Executes all read operations (for accurate analysis)
2. Simulates all write operations (shows what would change)
3. Previews agent spawns (shows what Task() calls would occur)
4. Reports state changes (shows YAML mutations)
5. Outputs standardized summary (consistent format across commands)

The result: Safe command testing with full visibility into intended effects.

<quick_start> <flag_detection> Detect --dry-run in command arguments: