From 3f8754677ed6661e64939a3176bde158f148d312 Mon Sep 17 00:00:00 2001 From: CleverThis Date: Thu, 9 Apr 2026 07:48:04 +0000 Subject: [PATCH] docs(spec): clarify agents plan correct accepts plan ID or decision ID The implementation accepts either a plan ID (auto-selects root decision) or a decision ID (targets specific decision). The spec previously only documented DECISION_ID, which was less ergonomic than the actual behavior. Update synopsis, argument description, and decision tree section to document both forms. Closes #5558. Refs: #5558 --- docs/specification.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/specification.md b/docs/specification.md index 4accaad8b..82954102b 100644 --- a/docs/specification.md +++ b/docs/specification.md @@ -14912,14 +14912,14 @@ Including the raw model reasoning with `--show-reasoning`: ##### agents plan correct 
agents plan correct --mode (revert|append) (--guidance|-g) <GUIDANCE>
-                   [--dry-run] [--yes|-y] <DECISION_ID>
+ [--dry-run] [--yes|-y] <PLAN_ID|DECISION_ID> **Purpose** Correct a decision either by reverting and re-executing or by appending a fix. **Arguments** -- ``: Decision ID. +- ``: The plan or decision to correct. When a plan ID is provided, the root decision of that plan is automatically selected as the correction target. When a decision ID is provided, that specific decision is targeted (backward-compatible behavior). - `--mode revert|append`: Correction mode. - `--guidance/-g TEXT`: Guidance text. - `--dry-run`: Show impact without executing. @@ -15857,7 +15857,7 @@ Show error decisions with recovery hints and retry history for a plan. │ → Check sandbox permissions and retry execution │ │ $ agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J │ │ → Revert to Strategize phase to adjust the plan │ - │ $ agents plan correct --mode revert -g "..." <DECISION_ID> │ + │ $ agents plan correct --mode revert -g "..." <PLAN_ID|DECISION_ID> │ ╰────────────────────────────────────────────────────────────────────╯ ✓ OK @@ -15882,7 +15882,7 @@ Show error decisions with recovery hints and retry history for a plan. → Check sandbox permissions and retry execution $ agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J → Revert to Strategize phase to adjust the plan - $ agents plan correct --mode revert -g "..." + $ agents plan correct --mode revert -g "..." [OK] ``` @@ -15909,7 +15909,7 @@ Show error decisions with recovery hints and retry history for a plan. { "action": "revert", "message": "Revert to Strategize phase to adjust the plan", - "cli_command": "agents plan correct --mode revert -g \"...\" " + "cli_command": "agents plan correct --mode revert -g \"...\" " } ] } @@ -18677,11 +18677,11 @@ Plan: 01KH29QDEE6DZTXKWNKCV8VP0F All corrections use the same unified command: 

-agents plan correct <decision_id> --mode=<mode> --guidance "<corrected decision text>"
+agents plan correct <plan_id_or_decision_id> --mode=<mode> --guidance "<corrected decision text>"
**Parameters:** -* ``: The ULID of the decision to correct +* ``: Either a plan ULID (auto-selects the root decision) or a specific decision ULID. Using a plan ID is the most common usage — the root decision is automatically targeted. Providing a decision ID directly allows targeting any specific decision in the tree (backward-compatible). * `--mode`: Either `revert` (rollback and re-run) or `append` (add fix at end) * `--guidance`: Free-form text specifying what the correct decision should be -- 2.52.0