create_subgoal_task
Create a subgoal in a goal session and launch its associated task atomically, with dependencies on accepted subgoals.
Instructions
v0.8.0: Create a subgoal within a Goal Session and immediately launch an associated task. Atomically: addSubgoal → create_task → linkTask → mark subgoal running. The subgoal depends_on other subgoals (by id) which must be accepted before suggest_next_subgoal returns it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | Task goal when template is supplied. | |
| agent | No | Agent name. | |
| scope | No | Allowed file/directory scope. | |
| goal_id | Yes | Goal ID to add the subgoal to. | |
| plan_id | No | Plan ID from save_plan. One of plan_id/inline_plan/template+goal is required. | |
| template | No | Built-in task template. Use with goal. | |
| forbidden | No | Forbidden file/directory paths. | |
| repo_path | Yes | Repository path inside workspaceRoot. | |
| depends_on | No | Subgoal IDs this subgoal depends on. Dependencies must be accepted before this subgoal is suggested. | |
| plan_title | No | Optional title for inline_plan. | |
| inline_plan | No | Inline Markdown plan. | |
| test_command | No | Verification command. | |
| verification | No | Acceptance verification commands. | |
| done_evidence | No | Required done evidence files. | |
| subgoal_title | Yes | Title of the new subgoal. | |
| requested_model | No | Optional model override for the explicitly selected Agent. | |
| timeout_seconds | No | Task timeout in seconds. | |
| verify_commands | No | Additional verification commands. | |
| isolate_worktree | No | v1.0.0: If true (default), create the task in an isolated git worktree under _workspacetrees/. Set false to run in the main workspace (v0.8.0 behavior) |