Task Create¶

Create a native task and optionally provision a projection-free Co-work knowledge document. GTD vocabulary is optional; agent-driven creators should set creation_provenance and appropriate user_involvement.

Skill name: task_create

Category: tasks

Mutates state (retry policy: verify_first)

Parameters¶

Name	Type	Required	Description
`client_mutation_id`	`str`	No	Optional stable idempotency key. The gateway pins one before dispatch when omitted.
`contract`	`str`	No	Contract slug this task serves
`creation_effort`	`str`	No	'sparse'
`creation_provenance`	`str`	No	'manual' (default)
`deadline_date`	`str`	No	ISO date YYYY-MM-DD when has_deadline=True.
`definition_of_done`	`str`	No	closing signal for the task.
`density`	`str`	No	'sparse' (default)
`dependency_hint`	`str`	No	free-text hint about the dependency (e.g. 'needs Ben’s review').
`due_date`	`str`	No	Due date as YYYY-MM-DD
`has_deadline`	`bool`	No	True when deadline_date is set; signal for deadline-aware resurfacing.
`has_dependency`	`bool`	No	True when this task is blocked on someone or something.
`initial_note`	`str`	No	Initial task-note content. Requires requested_note_role='working_document/v1'; an empty note is allowed.
`next_action_text`	`str`	No	specific physical action for developed tasks (e.g. 'Set up weekly cron job').
`outcome_text`	`str`	No	desired end-state for developed tasks (e.g. 'ETF tracking habit running').
`project`	`str`	No	Legacy scalar project slug or alias resolved to a registry reference; never creates a namespace. Prefer project_ids for multiple projects.
`project_ids`	`list[int]`	No	Zero or more stable registry project IDs. Independent of namespace tags; a shared task may serve several projects.
`requested_note_role`	`str`	No	Set to 'working_document/v1' to explicitly create a linked provenance-aware Co-work task note.
`requested_truth_policy_resolution`	`str`	No	For an explicitly requested task note, 'disabled' (default) or 'enabled'. Enabling adds Truth tools but runs no analysis.
`summary`	`str`	No	Optional scalar task summary. This does not create a Co-work document.
`tags`	`list[str]`	No	Structured namespace tags without a leading '#'.
`task_kind`	`str`	No	'task' (default)
`task_text`	`str`	Yes	Short single-line task description (NO newlines — will be rejected)
`urgency`	`str`	No	Urgency: low, medium (default), high
`user_involvement`	`str`	No	'low'

Details¶

The creating agent session is recorded automatically as created_by_session; it is not a caller parameter. The result includes the native task ID, task and collection revisions, a durable mutation receipt, and Co-work document metadata only when requested_note_role explicitly provisions a note. summary remains a scalar task field. It never returns a Markdown task line or note path. Replaying the same client_mutation_id after response loss returns the original semantic result.