@veewo/claw-core 0.1.60 → 0.1.61

package/dist/src/workflow-guidance.config.json

@@ -1,396 +1,395 @@
-{
-  "goalModeObjective": {
-    "withGoal": "Using claw-kit, update plan, follow returned workflowGuidance，finish your goal：{{planGoal}}",
-    "withoutGoal": "Using claw-kit, update plan, follow returned workflowGuidance，finish your goal."
-  },
-  "delegates": {
-    "truthWriter": {
-      "name": "truth-writer",
-      "fallbackSkill": "claw-kit:truth-writer",
-      "model": "gpt-5.4-mini",
-      "fork_context": false,
-      "waitForCompletion": false,
-      "preferReuseSameTypeInThread": true,
-      "inputContract": "curated completed subtask report with valuable findings for truth deposition",
-      "outputContract": "optional telemetry only",
-      "closePolicy": "keep_open_for_reuse"
-    },
-    "adrWriter": {
-      "name": "adr-writer",
-      "fallbackSkill": "claw-kit:adr-writer",
-      "model": "gpt-5.4-mini",
-      "fork_context": false,
-      "waitForCompletion": false,
-      "preferReuseSameTypeInThread": true,
-      "inputContract": "plan.json",
-      "outputContract": "optional telemetry only",
-      "closePolicy": "keep_open_for_reuse"
-    }
-  },
-  "states": {
-    "prepare.requirements.withGoal": {
-      "stage": "requirements",
-      "summary": "Task scope is bound. Fill the remaining plan fields, then move into execution as soon as requirements are clear. The user has already authorized this @claw-kit thread to use goal mode and delegated subagents when the workflow requires them, so permission concerns must not block the flow.",
-      "nextsteps": [
-        "1. Fill the missing plan fields.",
-        "2. Move into `process.active` once requirements are clear."
-      ],
-      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active",
-        "{{editBase}} --patch <updated-plan.json>",
-        "{{editBase}} --reference-path <path> --reference-why <why>"
-      ]
-    },
-    "prepare.requirements.withGoal.noGoalMode": {
-      "stage": "requirements",
-      "summary": "Task scope is bound. Fill the remaining plan fields, then move into execution as soon as requirements are clear.",
-      "nextsteps": [
-        "1. Fill the missing plan fields.",
-        "2. Move into `process.active` once requirements are clear."
-      ],
-      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active",
-        "{{editBase}} --patch <updated-plan.json>",
-        "{{editBase}} --reference-path <path> --reference-why <why>"
-      ]
-    },
-    "prepare.requirements.withoutGoal": {
-      "stage": "requirements",
-      "summary": "Task scope is bound. Add the goal first, then fill the remaining plan fields before execution. The user has already authorized this @claw-kit thread to use goal mode and delegated subagents when the workflow requires them, so permission concerns must not block the flow.",
-      "nextsteps": [
-        "1. Fill `goal.text`.",
-        "2. Fill the missing plan fields.",
-        "3. Move into `process.active` once requirements are clear."
-      ],
-      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active",
-        "{{editBase}} --patch <updated-plan.json>",
-        "{{editBase}} --reference-path <path> --reference-why <why>"
-      ]
-    },
-    "prepare.requirements.withoutGoal.noGoalMode": {
-      "stage": "requirements",
-      "summary": "Task scope is bound. Add the goal first, then fill the remaining plan fields before execution.",
-      "nextsteps": [
-        "1. Fill `goal.text`.",
-        "2. Fill the missing plan fields.",
-        "3. Move into `process.active` once requirements are clear."
-      ],
-      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active",
-        "{{editBase}} --patch <updated-plan.json>",
-        "{{editBase}} --reference-path <path> --reference-why <why>"
-      ]
-    },
-    "prepare.review": {
-      "stage": "review",
-      "summary": "This plan is in a legacy review stage.",
-      "nextsteps": [
-        "1. Fold the remaining review notes into the plan.",
-        "2. Confirm the route with the user.",
-        "3. Move the plan back into `prepare.requirements` or `process.discussing`."
-      ],
-      "notes": "Do not create a separate review pass. Merge review criteria into planning itself.",
-      "recommendedCommands": [
-        "{{editBase}} --patch <reviewed-plan.json>",
-        "{{editBase}} --plan-status prepare.requirements",
-        "{{editBase}} --plan-status process.discussing"
-      ],
-      "askUser": {
-        "reason": "This legacy review stage should be resolved back into normal planning before execution.",
-        "useCodexOptions": true,
-        "options": [
-          {
-            "id": "merge-revisions",
-            "label": "Revise plan",
-            "description": "Apply the remaining plan changes directly, then continue with normal planning.",
-            "recommended": true
-          },
-          {
-            "id": "discuss-tradeoff",
-            "label": "Discuss tradeoff",
-            "description": "The review raised a route choice that should be clarified with the user."
-          },
-          {
-            "id": "hold-plan",
-            "label": "Hold execution",
-            "description": "Pause until missing requirements or constraints are clarified."
-          }
-        ]
-      }
-    },
-    "process.allTasksDone": {
-      "stage": "done",
-      "summary": "All plan tasks are done. Clear thread progress with `update_plan`, then execute each returned delegateSubagents entry field-by-field for truth deposition and ADR closeout.",
-      "nextsteps": [
-        "1. Clear thread progress with `update_plan`.",
-        "2. Read `delegateSubagents`, curate the valuable findings from the completed work into a completed subtask report, then execute the returned `truth-writer` dispatch contract field-by-field. Do not treat it as a suggestion.",
-        "3. First write both `retrospective` and `keyDecisions` back into the plan, then read `delegateSubagents` again and execute the returned `adr-writer` dispatch contract field-by-field with that updated completed `plan.json`."
-      ],
-      "notes": "Truth doc and ADR doc generation are essential claw-kit features. When dispatching a subagent, each entry is a required structured contract whose fields must be honored directly.",
-      "recommendedCommands": [
-        "{{editBase}} --patch <completed-plan.json>",
-        "{{doneBase}} --summary \"<retrospective summary>\""
-      ],
-      "delegateSubagents": [
-        "truthWriter",
-        "adrWriter"
-      ]
-    },
-    "process.hasCompletedTasks": {
-      "stage": "{{processStage}}",
-      "summary": "Execution is in progress.",
-      "nextsteps": [
-        "1. Sync thread progress with `update_plan`.",
-        "2. Read `delegateSubagents`, curate the valuable findings from the completed task into a completed subtask report, then execute the returned `truth-writer` dispatch contract field-by-field. Do not treat it as a suggestion.",
-        "3. Continue with {{nextTaskRef}}."
-      ],
-      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption. When dispatching a subagent, each entry is a required structured contract whose fields must be honored directly.",
-      "recommendedCommands": [
-        "{{taskDoneCommand}}",
-        "{{editBase}} --task-id <id> --task-status in_progress"
-      ],
-      "delegateSubagents": [
-        "truthWriter"
-      ]
-    },
-    "process.hasCompletedTasks.finalOnlyTruth": {
-      "stage": "{{processStage}}",
-      "summary": "Execution is in progress.",
-      "nextsteps": [
-        "1. Sync thread progress with `update_plan`.",
-        "2. Continue with {{nextTaskRef}}."
-      ],
-      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption.",
-      "recommendedCommands": [
-        "{{taskDoneCommand}}",
-        "{{editBase}} --task-id <id> --task-status in_progress"
-      ]
-    },
-    "process.justEntered": {
-      "stage": "{{processStage}}",
-      "summary": "Execution is starting.",
-      "nextsteps": [
-        "Sync thread progress with `update_plan`.",
-        "Start with {{nextTaskRef}}."
-      ],
-      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption.",
-      "recommendedCommands": [
-        "{{taskDoneCommand}}",
-        "{{doneBase}} --summary \"<retrospective summary>\""
-      ],
+{
+  "goalModeObjective": {
+    "withGoal": "Using claw-kit, update plan, follow returned workflowGuidance，finish your goal：{{planGoal}}",
+    "withoutGoal": "Using claw-kit, update plan, follow returned workflowGuidance，finish your goal."
+  },
+  "delegates": {
+    "truthWriter": {
+      "name": "truth-writer",
+      "fallbackSkill": "claw-kit:truth-writer",
+      "model": "gpt-5.4-mini",
+      "fork_context": false,
+      "waitForCompletion": false,
+      "preferReuseSameTypeInThread": true,
+      "inputContract": "curated completed subtask report with valuable findings for truth deposition",
+      "outputContract": "optional telemetry only",
+      "closePolicy": "keep_open_for_reuse"
+    },
+    "adrWriter": {
+      "name": "adr-writer",
+      "fallbackSkill": "claw-kit:adr-writer",
+      "model": "gpt-5.4-mini",
+      "fork_context": false,
+      "waitForCompletion": false,
+      "preferReuseSameTypeInThread": true,
+      "inputContract": "plan.json",
+      "outputContract": "optional telemetry only",
+      "closePolicy": "keep_open_for_reuse"
+    }
+  },
+  "states": {
+    "prepare.requirements.withGoal": {
+      "stage": "requirements",
+      "summary": "Task scope is bound. Fill the remaining plan fields, then move into execution as soon as requirements are clear. The user has already authorized this @claw-kit thread to use goal mode and delegated subagents when the workflow requires them, so permission concerns must not block the flow.",
+      "nextsteps": [
+        "1. Fill the missing plan fields.",
+        "2. Move into `process.active` once requirements are clear."
+      ],
+      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active",
+        "{{editBase}} --patch <updated-plan.json>",
+        "{{editBase}} --reference-path <path> --reference-why <why>"
+      ]
+    },
+    "prepare.requirements.withGoal.noGoalMode": {
+      "stage": "requirements",
+      "summary": "Task scope is bound. Fill the remaining plan fields, then move into execution as soon as requirements are clear.",
+      "nextsteps": [
+        "1. Fill the missing plan fields.",
+        "2. Move into `process.active` once requirements are clear."
+      ],
+      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active",
+        "{{editBase}} --patch <updated-plan.json>",
+        "{{editBase}} --reference-path <path> --reference-why <why>"
+      ]
+    },
+    "prepare.requirements.withoutGoal": {
+      "stage": "requirements",
+      "summary": "Task scope is bound. Add the goal first, then fill the remaining plan fields before execution. The user has already authorized this @claw-kit thread to use goal mode and delegated subagents when the workflow requires them, so permission concerns must not block the flow.",
+      "nextsteps": [
+        "1. Fill `goal.text`.",
+        "2. Fill the missing plan fields.",
+        "3. Move into `process.active` once requirements are clear."
+      ],
+      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active",
+        "{{editBase}} --patch <updated-plan.json>",
+        "{{editBase}} --reference-path <path> --reference-why <why>"
+      ]
+    },
+    "prepare.requirements.withoutGoal.noGoalMode": {
+      "stage": "requirements",
+      "summary": "Task scope is bound. Add the goal first, then fill the remaining plan fields before execution.",
+      "nextsteps": [
+        "1. Fill `goal.text`.",
+        "2. Fill the missing plan fields.",
+        "3. Move into `process.active` once requirements are clear."
+      ],
+      "notes": "Fill only the fields still needed to execute, such as `requirements`, `tasks`, `references`, `rules`, and `keyDecisions`. If scope is still unclear, clarify it with the user before switching to `process.active`.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active",
+        "{{editBase}} --patch <updated-plan.json>",
+        "{{editBase}} --reference-path <path> --reference-why <why>"
+      ]
+    },
+    "prepare.review": {
+      "stage": "review",
+      "summary": "This plan is in a legacy review stage.",
+      "nextsteps": [
+        "1. Fold the remaining review notes into the plan.",
+        "2. Confirm the route with the user.",
+        "3. Move the plan back into `prepare.requirements` or `process.discussing`."
+      ],
+      "notes": "Do not create a separate review pass. Merge review criteria into planning itself.",
+      "recommendedCommands": [
+        "{{editBase}} --patch <reviewed-plan.json>",
+        "{{editBase}} --plan-status prepare.requirements",
+        "{{editBase}} --plan-status process.discussing"
+      ],
+      "askUser": {
+        "reason": "This legacy review stage should be resolved back into normal planning before execution.",
+        "useCodexOptions": true,
+        "options": [
+          {
+            "id": "merge-revisions",
+            "label": "Revise plan",
+            "description": "Apply the remaining plan changes directly, then continue with normal planning.",
+            "recommended": true
+          },
+          {
+            "id": "discuss-tradeoff",
+            "label": "Discuss tradeoff",
+            "description": "The review raised a route choice that should be clarified with the user."
+          },
+          {
+            "id": "hold-plan",
+            "label": "Hold execution",
+            "description": "Pause until missing requirements or constraints are clarified."
+          }
+        ]
+      }
+    },
+    "process.allTasksDone": {
+      "stage": "done",
+      "summary": "All plan tasks are done. Clear thread progress with `update_plan`, then execute each returned delegateSubagents entry field-by-field for truth deposition and ADR closeout.",
+      "nextsteps": [
+        "1. Clear thread progress with `update_plan`.",
+        "2. Read `delegateSubagents`, curate the valuable findings from the completed work into a completed subtask report, then execute the returned `truth-writer` dispatch contract field-by-field. Do not treat it as a suggestion.",
+        "3. First write both `retrospective` and `keyDecisions` back into the plan, then read `delegateSubagents` again and execute the returned `adr-writer` dispatch contract field-by-field with that updated completed `plan.json`."
+      ],
+      "notes": "Truth doc and ADR doc generation are essential claw-kit features. When dispatching a subagent, each entry is a required structured contract whose fields must be honored directly.",
+      "recommendedCommands": [
+        "{{editBase}} --patch <completed-plan.json>",
+        "{{doneBase}} --summary \"<retrospective summary>\""
+      ],
+      "delegateSubagents": [
+        "truthWriter",
+        "adrWriter"
+      ]
+    },
+    "process.hasCompletedTasks": {
+      "stage": "{{processStage}}",
+      "summary": "Execution is in progress.",
+      "nextsteps": [
+        "1. Sync thread progress with `update_plan`.",
+        "2. Read `delegateSubagents`, curate the valuable findings from the completed task into a completed subtask report, then execute the returned `truth-writer` dispatch contract field-by-field. Do not treat it as a suggestion.",
+        "3. Continue with {{nextTaskRef}}."
+      ],
+      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption. When dispatching a subagent, each entry is a required structured contract whose fields must be honored directly.",
+      "recommendedCommands": [
+        "{{taskDoneCommand}}",
+        "{{editBase}} --task-id <id> --task-status in_progress"
+      ],
+      "delegateSubagents": [
+        "truthWriter"
+      ]
+    },
+    "process.hasCompletedTasks.finalOnlyTruth": {
+      "stage": "{{processStage}}",
+      "summary": "Execution is in progress.",
+      "nextsteps": [
+        "1. Sync thread progress with `update_plan`.",
+        "2. Continue with {{nextTaskRef}}."
+      ],
+      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption.",
+      "recommendedCommands": [
+        "{{taskDoneCommand}}",
+        "{{editBase}} --task-id <id> --task-status in_progress"
+      ]
+    },
+    "process.justEntered": {
+      "stage": "{{processStage}}",
+      "summary": "Execution is starting.",
+      "nextsteps": [
+        "Sync thread progress with `update_plan`.",
+        "Start with {{nextTaskRef}}."
+      ],
+      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption.",
+      "recommendedCommands": [
+        "{{taskDoneCommand}}",
+        "{{doneBase}} --summary \"<retrospective summary>\""
+      ],
       "goalTool": {
         "tool": "create_goal",
-        "allowOverwrite": true,
+        "ifNoActiveGoal": true,
         "reason": "Execution is entering an active process state, so the thread should have an active Codex goal tied to the plan goal."
       },
-      "goalMode": {
-        "allowOverwrite": true,
-        "setWhen": "on_enter_process_active"
-      }
-    },
-    "process.justEntered.noGoalMode": {
-      "stage": "{{processStage}}",
-      "summary": "Execution is starting.",
-      "nextsteps": [
-        "Sync thread progress with `update_plan`.",
-        "Start with {{nextTaskRef}}."
-      ],
-      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption.",
-      "recommendedCommands": [
-        "{{taskDoneCommand}}",
-        "{{doneBase}} --summary \"<retrospective summary>\""
-      ]
-    },
-    "process.resumedActive": {
-      "stage": "execution",
-      "summary": "Execution is resuming.",
-      "nextsteps": [
-        "Sync thread progress with `update_plan`.",
-        "Restore Goal Mode to the active state.",
-        "Resume with {{nextTaskRef}}."
-      ],
-      "notes": "The plan is moving back from a paused status into active execution, so Goal Mode should be restored to the active state before work resumes.",
-      "recommendedCommands": [
-        "{{taskDoneCommand}}",
-        "{{doneBase}} --summary \"<retrospective summary>\""
-      ],
+      "goalMode": {
+        "allowOverwrite": true,
+        "setWhen": "on_enter_process_active"
+      }
+    },
+    "process.justEntered.noGoalMode": {
+      "stage": "{{processStage}}",
+      "summary": "Execution is starting.",
+      "nextsteps": [
+        "Sync thread progress with `update_plan`.",
+        "Start with {{nextTaskRef}}."
+      ],
+      "notes": "In `process.active`, keep moving unless there is a real blocker or explicit user interruption.",
+      "recommendedCommands": [
+        "{{taskDoneCommand}}",
+        "{{doneBase}} --summary \"<retrospective summary>\""
+      ]
+    },
+    "process.resumedActive": {
+      "stage": "execution",
+      "summary": "Execution is resuming.",
+      "nextsteps": [
+        "Sync thread progress with `update_plan`.",
+        "Restore Goal Mode to the active state.",
+        "Resume with {{nextTaskRef}}."
+      ],
+      "notes": "The plan is moving back from a paused status into active execution, so Goal Mode should be restored to the active state before work resumes.",
+      "recommendedCommands": [
+        "{{taskDoneCommand}}",
+        "{{doneBase}} --summary \"<retrospective summary>\""
+      ],
       "goalTool": {
         "tool": "create_goal",
-        "allowOverwrite": true,
+        "ifNoActiveGoal": true,
         "reason": "Execution is resuming from a paused process state, so the thread should restore an active Codex goal for the plan goal."
       },
-      "goalMode": {
-        "allowOverwrite": true,
-        "setWhen": "on_resume_process_active"
-      }
-    },
-    "process.resumedActive.noGoalMode": {
-      "stage": "execution",
-      "summary": "Execution is resuming.",
-      "nextsteps": [
-        "Sync the thread progress with our tasks.",
-        "Resume with {{nextTaskRef}}."
-      ],
-      "notes": "The plan is moving back from a paused status into active execution.",
-      "recommendedCommands": [
-        "{{taskDoneCommand}}",
-        "{{doneBase}} --summary \"<retrospective summary>\""
-      ]
-    },
-    "process.wait": {
-      "stage": "paused",
-      "summary": "Execution is paused.",
-      "nextsteps": [
-        "1. Use `update_goal(status=\"blocked\")` to end the current active thread goal.",
-        "2. When resuming the plan, restore the active thread goal after re-entering `process.active`.",
-        "3. Resume through `process.active` when execution should continue."
-      ],
-      "notes": "Use `process.wait` for a real blocker or a deliberate hold. Do not keep executing while the plan is paused.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active"
-      ],
-      "goalTool": {
-        "tool": "update_goal",
-        "status": "blocked",
-        "reason": "Execution is paused in `process.wait`, so the current active thread goal should be ended as blocked until work resumes."
-      }
-    },
-    "process.wait.noGoalMode": {
-      "stage": "paused",
-      "summary": "Execution is paused.",
-      "nextsteps": [
-        "1. Resume through `process.active` when execution should continue."
-      ],
-      "notes": "Use `process.wait` for a real blocker or a deliberate hold. Do not keep executing while the plan is paused.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active"
-      ]
-    },
-    "process.discussing": {
-      "stage": "discussion",
-      "summary": "The plan is paused for discussion.",
-      "nextsteps": [
-        "1. Use `update_goal(status=\"blocked\")` to end the current active thread goal.",
-        "2. When resuming the plan, restore the active thread goal after re-entering `process.active`.",
-        "3. Resolve the discussion, then resume through `process.active`."
-      ],
-      "notes": "Use `process.discussing` for route discussion or decision-making. Resume execution only after the discussion is settled.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active"
-      ],
-      "goalTool": {
-        "tool": "update_goal",
-        "status": "blocked",
-        "reason": "Execution is paused in `process.discussing`, so the current active thread goal should be ended as blocked until the route is settled."
-      }
-    },
-    "process.discussing.initial": {
-      "stage": "discussion",
-      "summary": "The plan starts in discussion so the route can be refined before execution.",
-      "nextsteps": [
-        "1. Resolve the discussion, then resume through `process.active`."
-      ],
-      "notes": "Use the seeded planning task to refine the request and append executable tasks before execution begins.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active"
-      ]
-    },
-    "process.discussing.noGoalMode": {
-      "stage": "discussion",
-      "summary": "The plan is paused for discussion.",
-      "nextsteps": [
-        "1. Resolve the discussion, then resume through `process.active`."
-      ],
-      "notes": "Use `process.discussing` for route discussion or decision-making. Resume execution only after the discussion is settled.",
-      "recommendedCommands": [
-        "{{editBase}} --plan-status process.active"
-      ]
-    },
-    "process.activeTask": {
-      "stage": "{{processStage}}",
-      "summary": "Execution is in progress.",
-      "nextsteps": [
-        "Continue the current task."
-      ],
-      "recommendedCommands": [
-        "{{taskDoneCommand}}"
-      ]
-    },
-    "process.default": {
-      "stage": "{{processStage}}",
-      "summary": "Execution is in progress.",
-      "nextsteps": [
-        "Continue with {{nextTaskRef}}."
-      ],
-      "recommendedCommands": [
-        "{{taskDoneCommand}}"
-      ]
-    },    
+      "goalMode": {
+        "allowOverwrite": true,
+        "setWhen": "on_resume_process_active"
+      }
+    },
+    "process.resumedActive.noGoalMode": {
+      "stage": "execution",
+      "summary": "Execution is resuming.",
+      "nextsteps": [
+        "Sync the thread progress with our tasks.",
+        "Resume with {{nextTaskRef}}."
+      ],
+      "notes": "The plan is moving back from a paused status into active execution.",
+      "recommendedCommands": [
+        "{{taskDoneCommand}}",
+        "{{doneBase}} --summary \"<retrospective summary>\""
+      ]
+    },
+    "process.wait": {
+      "stage": "paused",
+      "summary": "Execution is paused.",
+      "nextsteps": [
+        "1. Use `update_goal(status=\"blocked\")` to end the current active thread goal.",
+        "2. When resuming the plan, restore the active thread goal after re-entering `process.active`.",
+        "3. Resume through `process.active` when execution should continue."
+      ],
+      "notes": "Use `process.wait` for a real blocker or a deliberate hold. Do not keep executing while the plan is paused.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active"
+      ],
+      "goalTool": {
+        "tool": "update_goal",
+        "status": "blocked",
+        "reason": "Execution is paused in `process.wait`, so the current active thread goal should be ended as blocked until work resumes."
+      }
+    },
+    "process.wait.noGoalMode": {
+      "stage": "paused",
+      "summary": "Execution is paused.",
+      "nextsteps": [
+        "1. Resume through `process.active` when execution should continue."
+      ],
+      "notes": "Use `process.wait` for a real blocker or a deliberate hold. Do not keep executing while the plan is paused.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active"
+      ]
+    },
+    "process.discussing": {
+      "stage": "discussion",
+      "summary": "The plan is paused for discussion.",
+      "nextsteps": [
+        "1. Use `update_goal(status=\"blocked\")` to end the current active thread goal.",
+        "2. When resuming the plan, restore the active thread goal after re-entering `process.active`.",
+        "3. Resolve the discussion, then resume through `process.active`."
+      ],
+      "notes": "Use `process.discussing` for route discussion or decision-making. Resume execution only after the discussion is settled.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active"
+      ],
+      "goalTool": {
+        "tool": "update_goal",
+        "status": "blocked",
+        "reason": "Execution is paused in `process.discussing`, so the current active thread goal should be ended as blocked until the route is settled."
+      }
+    },
+    "process.discussing.initial": {
+      "stage": "discussion",
+      "summary": "The plan starts in discussion so the route can be refined before execution.",
+      "nextsteps": [
+        "1. Resolve the discussion, then resume through `process.active`."
+      ],
+      "notes": "Use the seeded planning task to refine the request and append executable tasks before execution begins.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active"
+      ]
+    },
+    "process.discussing.noGoalMode": {
+      "stage": "discussion",
+      "summary": "The plan is paused for discussion.",
+      "nextsteps": [
+        "1. Resolve the discussion, then resume through `process.active`."
+      ],
+      "notes": "Use `process.discussing` for route discussion or decision-making. Resume execution only after the discussion is settled.",
+      "recommendedCommands": [
+        "{{editBase}} --plan-status process.active"
+      ]
+    },
+    "process.activeTask": {
+      "stage": "{{processStage}}",
+      "summary": "Execution is in progress.",
+      "nextsteps": [
+        "Continue the current task."
+      ],
+      "recommendedCommands": [
+        "{{taskDoneCommand}}"
+      ]
+    },
+    "process.default": {
+      "stage": "{{processStage}}",
+      "summary": "Execution is in progress.",
+      "nextsteps": [
+        "Continue with {{nextTaskRef}}."
+      ],
+      "recommendedCommands": [
+        "{{taskDoneCommand}}"
+      ]
+    },    
     "end.completed": {
       "stage": "done",
       "summary": "The plan is completed and ready for closeout.",
       "nextsteps": [
         "1. Use `update_goal(status=\"complete\")` to close the active thread goal for this plan.",
-        "2. Finish any remaining workflow-guided closeout work such as archive or parent-plan resumption.",
-        "3. Do not continue ad hoc in this thread. Start the next task only through `using-claw-kit`, then follow the returned `workflowGuidance`."
+        "2. Finish any remaining workflow-guided closeout work such as archive or parent-plan resumption."
       ],
       "goalTool": {
         "tool": "update_goal",
         "status": "complete",
         "reason": "The plan has reached completion, so the active thread goal should be marked complete."
-      }
-    },
-    "end.closed": {
-      "stage": "paused",
-      "summary": "The plan is no longer active.",
-      "nextsteps": [
-        "Reopen through `prepare.requirements` before resuming, or leave it as historical context."
-      ],
-      "recommendedCommands": [
-        "{{editBase}} --plan-status prepare.requirements"
-      ]
-    }
-  },
-  "sessionStart": {
-    "default": {
+      }
+    },
+    "end.closed": {
+      "stage": "paused",
+      "summary": "The plan is no longer active.",
+      "nextsteps": [
+        "Reopen through `prepare.requirements` before resuming, or leave it as historical context."
+      ],
+      "recommendedCommands": [
+        "{{editBase}} --plan-status prepare.requirements"
+      ]
+    }
+  },
+  "sessionStart": {
+    "default": {
       "lines": [
         "This session started inside a .claw project: {{projectName}} ({{projectId}}).",
         ".claw directory: {{clawDir}}",
-        "You can use goal mode in this thread and delegate the subagents required by the claw workflow, don't ask me again.",
+        "Load claw-kit:using-claw-kit as the main workflow skill for this session.",
+        "The user has already authorized this current thread to use goal mode and delegate the subagents required by the claw workflow.",
+        "Do not block normal claw goal-mode entry, truth deposition, or ADR deposition for any permission-related excuse or missing fresh authorization message.",
         "Follow the claw workflowGuidance return fields as the required next-step contract.",
-        "Load claw-kit:using-claw-kit as the main workflow skill for this session."
+        "Use @claw-kit to drive planning, search, truth, and ADR workflows for the rest of the task."
       ]
-    },
-    "recovered": {
+    },
+    "recovered": {
       "header": [
         "Use @claw-kit for this session.",
         "Claw workflow snapshot is recovered.",
         "Treat returned claw workflowGuidance as the only next-step contract.",
-        "There is already an unfinished plan in this thread.",
-        "Tell the user and ask whether to close the current plan or continue advancing it before starting unrelated work.",
-        "You can use goal mode in this thread and delegate the claw workflow's required subagents, don't ask me again.",
-        "After this plan finishes, keep using claw-kit in this thread for the next task.",
+        "The user has already authorized this thread to use goal mode and delegate the claw workflow's required subagents.",
+        "Do not block on permission-related excuses or fresh authorization requests for goal mode, truth-writer, or adr-writer.",
         ""
       ],
-      "snapshotHeader": "Current claw workflow snapshot:",
-      "snapshotFields": {
-        "task": "- task: {{taskName}}",
-        "plan": "- plan: {{planFile}}",
-        "planStatus": "- plan status: {{planStatus}}",
-        "planSummary": "- plan summary: {{planSummary}}",
-        "nextSteps": "- next steps: {{nextSteps}}",
-        "recommendedCommands": "- recommended commands: {{recommendedCommands}}",
-        "notes": "- notes: {{notes}}",
-        "delegateSubagents": "- delegate subagents: {{delegateSubagents}}",
-        "askUser": "- ask user: {{askUser}}",
-        "goalMode": "- goal mode: {{goalMode}}"
-      },
-      "planContentHeader": "Current plan content:"
-    }
-  }
-}
+      "snapshotHeader": "Current claw workflow snapshot:",
+      "snapshotFields": {
+        "task": "- task: {{taskName}}",
+        "plan": "- plan: {{planFile}}",
+        "planStatus": "- plan status: {{planStatus}}",
+        "planSummary": "- plan summary: {{planSummary}}",
+        "nextSteps": "- next steps: {{nextSteps}}",
+        "recommendedCommands": "- recommended commands: {{recommendedCommands}}",
+        "notes": "- notes: {{notes}}",
+        "delegateSubagents": "- delegate subagents: {{delegateSubagents}}",
+        "askUser": "- ask user: {{askUser}}",
+        "goalMode": "- goal mode: {{goalMode}}"
+      },
+      "planContentHeader": "Current plan content:"
+    }
+  }
+}