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
• Atelier extension with the Verify Skill installed
• Claude Code installed

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

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

3. Review the acceptance criteria listed in the spec editor.

   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 spec editor.

   Atelier opens a new terminal tab and sends a prompt to Claude Code using the 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 the path configured by the plan verification file pattern.

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

   The board updates automatically based on the verification outcome.

If verification passes:

1. The plan card moves to the Done column.

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

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

   Atelier updates the checkbox from - [ ] to - [x] and keeps the todo as a markdown link to the plan file:

   TODO.md

   - [x] [Set up CI pipeline](~/.claude/plans/ci-pipeline.md)
   - [ ] Fix mobile layout issues

If verification fails:

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

   The Verify Skill identifies which acceptance criteria were not met and creates a task describing the required work.

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

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

3. Implement and verify the blocking task following the task verification workflow.

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

Tip

You can click on the link beside any acceptance criterion in the spec editor to jump directly to that section of the verification report. Open the report (saved to the path configured by the plan verification file pattern) and Command+Click (Ctrl+Click on Windows and Linux) a criterion link to jump to that section.

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.