Tasks and the review gate

What it does

• The Work screen holds the Kanban board: Pending → Assigned → In progress → In review → Awaiting approval → Done. Cards show priority, assignee, idle time and the test badge.
• The task detail holds the goal, acceptance criteria (checked or not), cost, notes and the agent’s report.
• The review gate: when a task is in review, Review diff…, Request changes… and Approve… appear on top. For medium and large work, approval needs a review independent of the agent that did the work, and evidence per criterion.
• Review diff shows the task’s commits, changed files and a line-by-line diff; the Acceptance criteria tab shows evidence per criterion. Verify runs the project’s verification command and writes the result to the badge.

Step by step

1. In Work, press + Task: a title and measurable acceptance criteria.
2. Assign it to an agent and press Start Session in the detail.
3. When the task moves to In review, open it and press Review diff….
4. Go through the changed files and the Acceptance criteria tab; re-run tests with Verify if needed.
5. Decide: Approve… or Request changes… with a reason; the agent goes back to work with it.

Related hx commands

# a task with acceptance criteria
hx new task "Date filter for the calendar" --assignee web-engineer --accept "No overflow at 375 px"

# the agent hands the work over for review
hx task review TASK-012 --report <report> --agent web-engineer

# runs the verification command and writes the badge
hx task verify TASK-012

# approval with evidence (reviewer)
hx task approve TASK-012 --agent qa --evidence "npm run e2e: 42/42"

Frequently asked questions