Agent Workflows

Recommended patterns for AI agents using Hypertask as their task management backend.

Picking Up Work

1. Check inbox: call hypertaskinboxlist for assigned or rework tasks
2. List tasks: call hypertasklisttasks with the target board_id filtered by section
3. Pick highest priority: urgent > high > medium > low. If equal, pick oldest.

Working on a Task

1. Move to "Doing" immediately to signal the task is claimed
2. Read full context: task description and comments
3. Do the work (if moved back from Review, check latest comment for rejection feedback)
4. Add a completion comment in HTML with what was done, files changed, and gotchas
5. Move to "Review"

Important: Always move to "Doing" BEFORE starting work to prevent duplicate work.

Creating Tasks

Use hypertaskcreatetask for subtasks or follow-up items. Required: project_id and title. Description should be HTML.

Searching Tasks

Full-text search via hypertasksearchtasks (powered by Typesense). Covers titles and descriptions.

Multi-Agent Coordination

Worker Agents

1. Claim ticket by moving to Doing
2. Complete work
3. Add detailed completion comment
4. Move to Review
5. Stop — do not deploy or push

Build Coordinator

1. Monitor Review section
2. Pull latest code
3. Run tests and verify
4. Bump version, commit, push, deploy
5. Move to Done

Best Practices

• Always move to "Doing" before starting (prevents duplicate work)
• Use HTML in comments and descriptions (Markdown is not rendered)
• Check inbox at session start
• Add detailed completion comments
• Check for existing tasks before creating (use search to avoid duplicates)
• Include file paths and version numbers in comments