delimit_agent_dispatch
Record an engineering-task dispatch intent with audit trail. Assign tasks, set constraints, and document context for replay, without running the work.
Instructions
Record an engineering-task dispatch with full audit trail (Pro).
When to use: as the PLANNING + AUDIT surface when the orchestrator decides to delegate parallelizable engineering work to a subagent. Per the operating model (2026-05-01 revision), actual execution is performed by the Agent tool with subagent_type=engineering; this tool records the intent, assignee, constraints, and eventual outcome so the dispatch is replayable from the ledger. When NOT to use: as an autonomous queue processor expecting auto-execution — this records dispatch but does NOT run the work. Real autonomous queue execution is deferred to a future capability (LED-193 daemon) with strict sandboxing + founder- approval semantics. Also do not use for conversational tasks, sub-5-minute work, or work where no function exists yet.
Sibling contrast: delimit_agent_status reads dispatched task state; delimit_agent_handoff transfers a recorded task to a different model; delimit_agent_complete closes the task with results. Compared to delimit_ledger_add, this is the engineering- work surface with assignee, tools_needed, and constraints schema; ledger items are free-form.
Side effects: writes a new task record to disk via
ai.agent_dispatch.dispatch_task (a JSON record in the agent
tasks file plus an audit log entry). String list inputs
(tools_needed, constraints) are coerced from comma strings
to lists. NO subagent is spawned by this call — the caller is
responsible for invoking the Agent tool separately. Gated by
require_premium — unlicensed callers receive a license payload.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Short task title. Required. | |
| description | No | Longer task description. | |
| assignee | No | Target model — "claude", "codex", "gemini", or "any". Default "any". | any |
| priority | No | One of "P0" (immediate), "P1" (default), "P2". | P1 |
| tools_needed | No | Comma-separated MCP tools the work will need. | |
| constraints | No | Comma-separated constraints (e.g. "no force push"). | |
| context | No | Background info to seed the executor. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||