grok_delegate_plan
Plan a coding goal read-only: generate an implementation strategy without write, edit, or shell mutations. Delegates to the Grok CLI and returns a structured verdict for review.
Instructions
Read-only plan variant of grok_delegate (plan_only=true). Does not allow write/edit/shell mutation in the permission profile.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | Coding goal for the executor | |
| lane | Yes | Lane slug or grok/<slug> (not dev/master/main) | |
| model | No | Optional model id | |
| rules | No | Optional extra rules appended to system prompt (bounded) | |
| resume | No | Resume session: true for most recent, or a session UUID string | |
| sandbox | No | Optional sandbox profile override: off|workspace|devbox|read-only|strict (known built-ins only) | |
| base_ref | No | Git base ref (default origin/dev) | origin/dev |
| max_turns | No | Max agent turns (server hard-capped at 60) | |
| plan_only | No | ||
| repo_root | No | Absolute path to a repo root; accepted only if it resolve()s to an entry on GROK_DELEGATE_ALLOWED_ROOTS (or single GROK_DELEGATE_REPO_ROOT pin) | |
| session_id | No | UUID for --session-id (new or forked session name) | |
| json_schema | No | Optional JSON Schema object/string for structured output | |
| fork_session | No | Pass --fork-session (requires resume/continue) | |
| lane_verdict | No | Attach the lane verdict schema (default true). The run ends when the executor emits that object, so on a goal it must read the codebase to start, it emits one describing intent and the lane closes empty. Set false for exploration-heavy goals: the executor then works to natural completion and reports prose in summary instead of a parsed verdict. | |
| lanes_parent | No | Optional parent dir for worktrees; rejected if inside repo_root or outside GROK_DELEGATE_LANES_PARENT when that env is set | |
| no_subagents | No | If true, pass --no-subagents | |
| continue_session | No | Pass --continue (most recent for cwd) | |
| reasoning_effort | No | Optional reasoning effort (low|medium|high|…) | |
| disable_web_search | No | If true, pass --disable-web-search |