Hamloy

Add a task, a request for the human, or a question for the human. It stays open: claim it only if you start on it now, and tick it once the work itself is done, not for adding it.

add

Can't wait for the human? Pick an option and go on; the question stays open, marked assumed, until the human confirms or overturns it.

assume

Bring work kept somewhere else (a TODO or plan file, notes, issues, a checklist, your own todo list, another tool's lists) into the lists in one call, once the human says yes. Sort it as it comes in: what only the human can do (an account, a key, money) is a request, a decision of theirs a question, each in that list and not also a task. Write each list's items as Markdown, done ones too: ## Heading, - [ ] Title (- [x] when done), indented lines under it its notes, indented - [ ] its subtasks. A question's options are its indented - lines, (recommended) after one; its notes there have no dash. A file's # title is left out; text before the first item is the list's intro. Notes hold up to 20,000 characters an item. What else the source says goes in a comment ending the line, all of it: <!-- id:T1 by:claude at:2026-10-01T09:00 needs:T2 prio:high done:2026-10-02 done-by:you answer:"Pick-up only" answered-by:you -->; needs names items by those ids or by keys here. Lists already in this form (another tool's export) go in as they are. A log of past work (test rounds, a changelog) stays in its file: bring in only the open work it names. Work found in two places is one item; group it by what it is about, not by where you found it. An item its list already has by title is left out. All of it comes in, or nothing, into this one project: another repo's work goes into that repo's own project.

import

Change an item's list, title, section, fields, needs (it's blocked until they're done), notes, a question's options, or its place in the list. delete only when the human asks, or calls the work off, or for a duplicate you made; restore brings it back.

edit

Say you're working on an item, so other agents pick something else. It lasts until you've been quiet for 30 minutes; tick drops it when done, release: true if you stop without finishing it, after a note on what you did and ruled out (edit's add_note). Items for someone else are refused.

claim

Rename, reorder or remove a heading in a list (add makes a new one: give an item that section). Give one of to, before, after or remove.

section

Add, rename or remove one of the human's own lists (ideas, bugs) when they ask, rather than a heading in the backlog; list shows them all. Its items work like tasks; pass its name as kind.

lists

Mark a task or request done (done: false opens it again). Drops your claim on it.

tick

Tell another agent something: you need its item, you changed something it builds on, a finding. It reaches them in their news under their next tool reply; no claim is needed to send one.

message

Record the answer the human gave you in chat. Never pick one yourself (use assume) or answer to unblock work (use edit's needs).

answer