diff --git a/docs/specification.md b/docs/specification.md
index 4accaad8b..a94da6383 100644
--- a/docs/specification.md
+++ b/docs/specification.md
@@ -339,7 +339,7 @@ The following standards are integrated into the architecture:
 <span style="color: cyan; font-weight: 600;">agents</span> plan tree [<span style="color: cyan;">--show-superseded</span>] <span style="color: #66cc66;">&lt;PLAN_ID&gt;</span>
 <span style="color: cyan; font-weight: 600;">agents</span> plan explain [<span style="color: cyan;">--show-context</span>] [<span style="color: cyan;">--show-reasoning</span>] <span style="color: #66cc66;">&lt;DECISION_ID&gt;</span>
 <span style="color: cyan; font-weight: 600;">agents</span> plan correct <span style="color: cyan;">--mode</span> (<span style="color: magenta;">revert|append</span>) (<span style="color: magenta;"><span style="color: cyan;">--guidance</span>|<span style="color: yellow;">-g</span></span>) <span style="color: #66cc66;">&lt;GUIDANCE&gt;</span>
-                   [<span style="color: cyan;">--dry-run</span>] [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;DECISION_ID&gt;</span>
+                   [<span style="color: cyan;">--dry-run</span>] [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;PLAN_ID|DECISION_ID&gt;</span>
 <span style="color: cyan; font-weight: 600;">agents</span> plan diff (<span style="color: magenta;"><span style="color: cyan;">--correction</span> <span style="color: #66cc66;">&lt;CORRECTION_ATTEMPT_ID&gt;</span>|<span style="color: #66cc66;">&lt;PLAN_ID&gt;</span></span>)
 <span style="color: cyan; font-weight: 600;">agents</span> plan artifacts <span style="color: #66cc66;">&lt;PLAN_ID&gt;</span>
 <span style="color: cyan; font-weight: 600;">agents</span> plan prompt <span style="color: #66cc66;">&lt;PLAN_ID&gt;</span> <span style="color: #66cc66;">&lt;GUIDANCE&gt;</span>
@@ -14912,14 +14912,14 @@ Including the raw model reasoning with `--show-reasoning`:
 ##### agents plan correct
 
 <div class="highlight"><pre><code><span style="color: cyan; font-weight: 600;">agents</span> plan correct <span style="color: cyan;">--mode</span> (<span style="color: magenta;">revert|append</span>) (<span style="color: magenta;"><span style="color: cyan;">--guidance</span>|<span style="color: yellow;">-g</span></span>) <span style="color: #66cc66;">&lt;GUIDANCE&gt;</span>
-                   [<span style="color: cyan;">--dry-run</span>] [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;DECISION_ID&gt;</span></code></pre></div>
+                   [<span style="color: cyan;">--dry-run</span>] [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;PLAN_ID|DECISION_ID&gt;</span></code></pre></div>
 
 **Purpose**
 Correct a decision either by reverting and re-executing or by appending a fix.
 
 **Arguments**
 
-- `<DECISION_ID>`: Decision ID.
+- `<PLAN_ID|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 directly (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                  │
     │     <span style="opacity: 0.7;">$ agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J</span>              │
     │   → Revert to Strategize phase to adjust the plan                  │
-    │     <span style="opacity: 0.7;">$ agents plan correct --mode revert -g "..." &lt;DECISION_ID&gt;</span>     │
+    │     <span style="opacity: 0.7;">$ agents plan correct --mode revert -g "..." &lt;PLAN_ID|DECISION_ID&gt;</span> │
     ╰────────────────────────────────────────────────────────────────────╯
 
     <span style="color: #66cc66; font-weight: 600;">✓ OK</span>
@@ -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 "..." <DECISION_ID>
+        $ agents plan correct --mode revert -g "..." <PLAN_ID|DECISION_ID>
 
     [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 \"...\" <DECISION_ID>"
+          "cli_command": "agents plan correct --mode revert -g \"...\" <PLAN_ID|DECISION_ID>"
         }
       ]
     }
@@ -18677,11 +18677,11 @@ Plan: 01KH29QDEE6DZTXKWNKCV8VP0F
 All corrections use the same unified command:
 
 <div class="highlight"><pre><code>
-agents plan correct &lt;decision_id&gt; <span style="color: cyan;">--mode</span>=&lt;mode&gt; <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;&lt;corrected decision text&gt;&quot;</span>
+agents plan correct &lt;plan_id|decision_id&gt; <span style="color: cyan;">--mode</span>=&lt;mode&gt; <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;&lt;corrected decision text&gt;&quot;</span>
 </code></pre></div>
 
 **Parameters:**
-* `<decision_id>`: The ULID of the decision to correct
+* `<plan_id|decision_id>`: When a plan ID is provided, the command auto-selects the plan's root decision. Supplying a decision ID targets that specific decision directly.
 * `--mode`: Either `revert` (rollback and re-run) or `append` (add fix at end)
 * `--guidance`: Free-form text specifying what the correct decision should be
 
@@ -18713,6 +18713,10 @@ agents plan correct 01CRZ5QEHMVUX6TTHR81I7HCX <span style="color: cyan;">--mode<
 
 <span style="opacity: 0.7;"># Add a missing invariant to the plan</span>
 agents invariant add <span style="color: cyan;">--plan</span> 01HXM8C2ZK4Q7C2B3F2R4VYV6J <span style="color: #66cc66;">&quot;All database queries must use parameterized statements&quot;</span>
+
+<span style="opacity: 0.7;"># Use a plan ID to correct its root decision</span>
+agents plan correct 01HXM8C2ZK4Q7C2B3F2R4VYV6J <span style="color: cyan;">--mode</span>=revert <span style="opacity: 0.7;">\</span>
+  <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;Re-run the plan with a revised authentication rollout before continuing child workstreams&quot;</span>
 </code></pre></div>
 
 **Note:** CLI commands should not require interactive input. The `--guidance` parameter provides the correction inline.
@@ -19779,7 +19783,7 @@ agents action create <span style="color: cyan;">--config</span> ./actions/code-c
 agents plan use local/code-coverage local/api-service <span style="color: cyan;">--invariant</span> <span style="color: #66cc66;">&quot;Mock all network calls&quot;</span>
 
 <span style="opacity: 0.7;"># Correct an invariant decision (remove or replace via standard correction)</span>
-agents plan correct &lt;DECISION_ID&gt; <span style="color: cyan;">--mode</span>=revert <span style="opacity: 0.7;">\</span>
+agents plan correct &lt;PLAN_ID|DECISION_ID&gt; <span style="color: cyan;">--mode</span>=revert <span style="opacity: 0.7;">\</span>
   <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;Remove this invariant - it does not apply to this module&quot;</span>
 </code></pre></div>
 
@@ -28937,11 +28941,11 @@ agents plan explain &lt;decision_id&gt;
 <span style="opacity: 0.7;"># Shows: question, chosen option, alternatives, rationale, downstream impact</span>
 
 <span style="opacity: 0.7;"># Correct via revert-and-replay</span>
-agents plan correct &lt;decision_id&gt; <span style="color: cyan;">--mode</span>=revert <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;&lt;what the decision should be&gt;&quot;</span>
+agents plan correct &lt;plan_id|decision_id&gt; <span style="color: cyan;">--mode</span>=revert <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;&lt;what the decision should be&gt;&quot;</span>
 <span style="opacity: 0.7;"># Re-executes from that point with the new guidance</span>
 
 <span style="opacity: 0.7;"># Correct via append (add fix at end)  </span>
-agents plan correct &lt;decision_id&gt; <span style="color: cyan;">--mode</span>=append <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;&lt;description of the fix&gt;&quot;</span>
+agents plan correct &lt;plan_id|decision_id&gt; <span style="color: cyan;">--mode</span>=append <span style="color: cyan;">--guidance</span> <span style="color: #66cc66;">&quot;&lt;description of the fix&gt;&quot;</span>
 <span style="opacity: 0.7;"># Creates a new child plan to fix the outcome without rewriting history</span>
 
 <span style="opacity: 0.7;"># Compare old vs new after correction</span>