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 acceptance criteria in the task’s description and produces a detailed report. If verification passes, the task moves to Done. If verification fails, work with Claude Code to address the issues, then run verification again. Use this workflow whenever a task reaches the In Review column.

Prerequisites

• At least one task in the In Review column
• Atelier extension with the Verify Skill installed
• Claude Code installed

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 it in the spec editor.

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

3. Click the Verify button in the spec editor.

   Atelier opens a new terminal tab and sends a prompt to Claude Code using the Verify Skill.

4. Wait for Claude to complete the verification process.

   Claude examines the implementation, compares it against the acceptance criteria in the task’s description, and generates a verification report. The report is saved to the path configured by the task verification file pattern.

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

   The board updates automatically based on the verification outcome.

If verification passes:

1. The task card moves to the Done column.

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

2. 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:

1. Review the verification report to see which acceptance criteria were not met.

   The report is saved to the path configured by the task verification file pattern. Each criterion shows whether it passed or failed and why.

2. Work with Claude Code to address the failures.

   Use the verification report and the task’s acceptance criteria to guide Claude (e.g. in a new conversation or by re-running the Implement skill). You can also update the task description if the acceptance criteria need to be corrected. The task remains in the In Review column until verification passes.

3. Run verification again once you have made the changes.

   Click the Verify button again. When verification passes, the task moves to Done.

Tip

After verification, links to the relevant sections of the verification report are added to the task description alongside each acceptance criterion. Open the task file and Command+Click (Ctrl+Click on Windows and Linux) a link to open the report in a new editor tab and jump to that section.

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.