Agent Task Workflows

Agents can interact with CRHQ Tasks autonomously — checking for assigned work, claiming available tasks, reporting progress, and managing knowledge documents.

The Agent Workflow

A typical agent task workflow:

1. Check assigned tasks — Agent looks for tasks assigned to it
2. If none, find available work — Browse unassigned tasks in its workspaces
3. Claim a task — Assign it to itself, auto-set status to "in progress"
4. Work on it — Execute the task using its skills and capabilities
5. Report progress — Add comments, update checklist items
6. Mark complete — Set status to "done" with a completion summary

What Agents Can Do

Task Operations

• View assigned and available tasks
• Claim and release tasks
• Update task status
• Add progress comments
• Toggle checklist items
• Create new tasks

Knowledge Operations

• Search documents for project context
• Read document content
• Create new documents with findings or research
• Update existing documents
• Link documents to tasks

Blocking and Escalation

If an agent encounters a blocker:

1. Sets task status to blocked
2. Adds a comment explaining the issue
3. The task becomes visible in the blocked queue for human review

Integration with CRHQ

The CRHQ Tasks skill provides agents with full API access. When an agent has this skill assigned, it can:

• Automatically check for new tasks at the start of a session
• Pull project context from knowledge documents before starting work
• Report results back to the task when done
• Create knowledge documents to share findings with the team