piyaz_create
Create 1-25 tasks in one project, optionally with edges between them, in one atomic call.
Requires project ('HWM' or UUID) and tasks[]; each task needs title (verb+noun, imperative) and description (2-4 sentences; single-sentence flagged). Give each task a key to reference it in edges; edge source/target accept keys, taskRefs, or UUIDs. Idempotent: exact-title matches against existing tasks are skipped and returned as 'deduped' (reusable as edge endpoints), so a restarted decompose run never duplicates a task set; onDuplicate='error' rejects the whole batch instead. Edges that already exist are silently skipped. Include acceptanceCriteria (2-4 binary), tags (three dimensions), category (from piyaz_get project view='meta'), priority, estimate up front, hints flag what's missing. Fails while the project is archived (reopen via piyaz_workspace status='active'). Next: verify wiring with piyaz_map view='neighbors' task='<ref>'.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
edges | object[] | No | Edges wiring the new tasks to each other (by key) and/or to existing tasks (by taskRef or UUID). Existing identical edges are silently skipped. |
onDuplicate | "skip" | "error" | No | skip (default): items whose exact title already exists in the project create nothing and return as 'deduped' (idempotent re-run). error: reject the whole batch before any write. |
project | string | Yes | Project identifier ('HWM') or project UUID. Required. |
tasks | object[] | Yes | 1-25 tasks to create in one atomic call. |
Last updated