create_task
Create a new task and deliver it to the recipient's inbox. Specify sender, recipient, subject, body, and optional priority, thread, references, or risk level.
Instructions
Create a new task and place it in the inbox (v3) or tasks folder (v2).
This is the canonical FCoP v3 spec §8 L1 entry-point for task
creation — functionally identical to :func:write_task but named to
match the spec. In a v3 project the task lands in
_lifecycle/inbox/ so the recipient can claim_task it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sender | Yes | Sender role code (uppercase). | |
| recipient | Yes | Recipient role code (uppercase). May use the slot form ``ROLE.D1`` or ``TEAM`` for broadcast. | |
| subject | Yes | One-line subject for the ``subject:`` frontmatter field. | |
| body | Yes | Task body in Markdown. | |
| priority | No | ``P0`` / ``P1`` / ``P2`` / ``P3`` (or legacy aliases). Default: ``P2``. | P2 |
| thread_key | No | Optional thread identifier. | |
| references | No | Comma-separated task filenames for ``references:`` field. | |
| risk_level | No | ``low`` / ``medium`` / ``high`` / ``irreversible``. Leave empty to accept the default (``medium``). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |