docs(spec): add agents plan revert and agents plan resume commands #5655

Closed
HAL9000 wants to merge 1 commits from spec/add-plan-revert-resume-commands-5574 into master

1 Commits

Author SHA1 Message Date
HAL9000 5ca81f5539 docs(spec): add agents plan revert and agents plan resume commands
CI / lint (pull_request) Successful in 23s
CI / quality (pull_request) Successful in 42s
CI / typecheck (pull_request) Successful in 1m3s
CI / security (pull_request) Successful in 58s
CI / build (pull_request) Successful in 27s
CI / helm (pull_request) Successful in 26s
CI / push-validation (pull_request) Successful in 16s
CI / e2e_tests (pull_request) Successful in 4m39s
CI / unit_tests (pull_request) Successful in 6m20s
CI / integration_tests (pull_request) Successful in 8m42s
CI / docker (pull_request) Successful in 13s
CI / coverage (pull_request) Successful in 14m17s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 57m35s
Closes #5574

Both commands are fully implemented in plan.py but were absent from the spec:

agents plan revert [--to-phase <PHASE>] [--reason/-r <REASON>] <PLAN_ID>
  - Reverts a plan to a previous phase (default: strategize) for re-planning
  - Recovery path for plans in the constrained terminal state
  - Increments reversion_count; blocked at MAX_REVERSIONS

agents plan resume [--dry-run] <PLAN_ID>
  - Resumes a plan from its last checkpoint
  - --dry-run previews resume point without changing state
  - Only non-terminal plans can be resumed

Added to:
1. Command synopsis (~line 344): two new entries before plan rollback
2. New ##### agents plan revert section with purpose, arguments, behavior, examples
3. New ##### agents plan resume section with purpose, arguments, behavior, examples
2026-04-09 08:08:42 +00:00