create_task
Create a new task in the event-sourced task graph for multi-agent orchestration. Add work items before assigning them to agents.
Instructions
Create a new task in the event-sourced task graph for multi-agent orchestration.
Use this to add work items before assigning them to agents. For updating an existing
task's priority, use change_task_priority instead. This appends a TASK_CREATED event
to the append-only SQLite event log with stable UUIDv7 ordering.
Side effects: Creates a TASK_CREATED event in the project's event log. Triggers an automatic snapshot when the event threshold is reached. Does NOT assign the task.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | Required task objective (1-3 sentences recommended). Should describe what needs to be accomplished, not how. | |
| kind | No | Task category (default "implementation"). Common values: "implementation", "review", "testing", "research", "design". | implementation |
| task_id | No | Optional explicit task ID; if omitted, a stable UUIDv7 is auto-generated. | |
| priority | No | Importance level from 1 (low) to 5 (critical); higher priority tasks are scheduled first by the deterministic scheduler. Default 3. | |
| related_files | No | Optional list of file paths this task touches; helps agents provide relevant context and reduces hallucination risk. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||