Verifying Completed Work

After Claude finishes implementing a task, you need to verify that the work meets the acceptance criteria. Verification checks the implementation against the plan’s requirements and produces a detailed report. If verification passes, the task moves to Done. If verification fails, Atelier creates a blocking task to address the issues before the original task can be completed. Use this workflow whenever a task reaches the In Review column.

Prerequisites

• At least one task in the In Review column
• Claude Code running and accessible

Steps

1. Open the Atelier kanban board and locate the task you want to verify in the In Review column.

Tasks in this column have been implemented but not yet verified against acceptance criteria.

2. Click on the task card to open the sidebar.

The sidebar displays the task details along with an action button for verification.

3. Click the Verify button in the sidebar.

Atelier opens a new terminal tab and sends a prompt to Claude Code using the atelier-verify skill.

4. Wait for Claude to complete the verification process.

Claude examines the implementation, compares it against the acceptance criteria defined in the parent plan, and generates a verification report. The report is saved to ~/.atelier/review/{task-name}.md.

5. Return to the Atelier kanban board to see the result.

The board updates automatically based on the verification outcome.

If verification passes:

6. The task card moves to the Done column.

The circle icon on the card changes to a checkmark, indicating that the task has been verified and completed successfully.

7. Click on the parent plan card to see updated progress.

The plan’s progress indicator updates to reflect the newly completed task, such as changing from “3/6 tasks” to “4/6 tasks”.

If verification fails:

6. A new blocking task is created automatically.

The atelier-verify skill determines what rework is needed and creates a task describing the required fixes. This new task blocks the original task.

7. The original task moves back to the In Progress column.

It remains blocked until the rework task is completed and verified.

8. Click on the blocking task card to review what needs to be fixed.

The task description explains what failed verification and what changes are required.

9. Implement the blocking task by following the steps in “Implementing a Task”.

Once the rework is complete and verified, the block is removed and the original task can proceed to Done.

Tip

You can view detailed verification results by opening the parent plan and reviewing the acceptance criteria. Each criterion shows whether it passed or failed. Click on any acceptance criterion to jump to the relevant section of the verification report in a new editor tab.

You have now verified a completed task. Repeat this process for each task as it reaches the In Review column. Once all tasks in a plan are verified and done, you can verify the plan itself to confirm that the overall work meets all acceptance criteria.