Completing a Plan

After all tasks within a plan are done, you need to verify the plan itself to confirm that the overall work meets the acceptance criteria. Plan-level verification looks at the big picture rather than individual tasks, ensuring that the combined implementation delivers what was originally intended. Use this workflow when a plan’s progress indicator shows all tasks complete and you’re ready to close out the work.

Prerequisites

• A plan with all tasks in the Done column
• Claude Code running and accessible

Steps

1. Open the Atelier kanban board and locate the plan you want to verify.

When all tasks are complete, the plan card displays a full progress bar and moves to the In Review column. The progress indicator shows something like “6/6 tasks”.

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

The sidebar displays the plan’s title, acceptance criteria, design decisions, and a summary of task completion.

3. Review the acceptance criteria listed in the sidebar.

Each criterion shows its current status based on individual task verifications. This gives you a preview of what plan-level verification will check.

4. 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. For plans, verification checks all acceptance criteria against the combined implementation.

5. Wait for Claude to complete the verification process.

Claude reviews the full scope of work, checking that each acceptance criterion is satisfied by the implemented tasks. The verification report is saved to ~/.atelier/review/{plan-name}.md.

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

If verification passes:

7. The plan card moves to the Done column.

The circle icon changes to a checkmark, indicating that the plan and all its tasks have been verified complete.

8. The corresponding todo item in your TODO.md file is marked as done.

Atelier updates the checkbox from - [ ] to - [x] and appends a reference to the completed plan, such as - [x] Add dark mode support → dark-mode.md.

If verification fails:

7. A new blocking task is created to address the gaps.

The atelier-verify skill identifies which acceptance criteria were not met and creates a task describing the required work.

8. The plan moves back to the In Progress column.

It remains there until the blocking task is completed, verified, and the plan passes verification.

9. Implement and verify the blocking task following the earlier scenarios.

Once the rework passes verification, return to the plan and run verification again.

Tip

You can click on any acceptance criterion in the sidebar to jump directly to that section of the verification report. This helps you understand exactly what was checked and why a criterion passed or failed.

You have now completed a full cycle of work, from capturing an idea as a todo, through planning and task decomposition, implementation, and finally verification. The Done column serves as a record of verified, completed work. You can start a new cycle at any time by adding another todo to your backlog.