task-notes

A task note is a Joplin to-do holding the true state of one task. Anyone — or any fresh agent — reading only the note must be able to resume the work. The title, body structure, and entry formats are defined in TASK-FORMAT.md.

Creating a task note

1. Get the Agents notebook id from list_notebooks; create it with create_notebook if missing.
2. Search for an existing open note for the same work: semantic_search_notes scoped to the Agents notebook_id with a query describing the task, then confirm any promising match is still open with read_note or search_notes (notebook:Agents type:todo iscompleted:0 <keywords>). If semantic search errors (embeddings not enabled in Joplin's AI settings) or turns up nothing relevant, fall back to plain search_notes with notebook:Agents type:todo iscompleted:0 <keywords>. If one exists, update it per the conventions below instead of creating a duplicate.
3. Allocate the task number. Search notebook:Agents with no iscompleted filter (completed tasks keep their numbers so none is ever reused), read every title's leading [NNNN], take the highest, and add one. Start at [0001] when the notebook has no numbered notes yet.
4. Create the note with create_note: is_todo: true, title and body per TASK-FORMAT.md.

Done when the note exists in Agents as a to-do (it appears under type:todo in search_notes — if not, the is_todo flag was dropped; fix it before proceeding) and you have reported its number, id, and title back to the caller.

Update conventions