Skip to content
Atelier

Verify Skill

The Verify Skill (atelier-verify) checks that implementations meet their acceptance criteria. It operates in three modes: task for evidence-based verification of a single task, plan for aggregating task results across an entire plan, and manual for fast-path approval without analysis.

When to use

Section titled “When to use”
  • A task implementation is complete and ready for verification (mode=task)
  • All tasks for a plan have been verified and you want an overall status (mode=plan)
  • You want to mark an item as done without detailed verification (mode=manual)

Arguments

Section titled “Arguments”
  • mode — task, plan, or manual (determines the workflow).
  • file — Path to the item being verified. May be a TODO.md#fragment, a task file (.md or .json), or a plan file.
  • plan_path — Path to the parent plan (required for task mode).
  • subtasks — Comma-separated task paths (required for plan mode).
  • task_dir — Directory for creating task files when the input is a TODO.
  • task_verification_dir — Directory where task verification reports are saved.
  • plan_verification_dir — Directory where plan verification reports are saved (plan mode).

Task mode

Section titled “Task mode”

Verifies a single task against its acceptance criteria using evidence from code changes.

  1. Loads context — Reads the plan and task, extracts and numbers the acceptance criteria.
  2. Analyzes git changes — Runs git diff HEAD and inspects changed files for evidence.
  3. Verifies each criterion — For each criterion, searches for evidence in the diff and assigns a status:
    • ✅ Met — Strong evidence, all aspects addressed.
    • ⚠️ Partial — Some evidence, clear gaps.
    • ❌ Not Met — No evidence or contradictory evidence.
  4. Generates a report — Writes a detailed report to {task_verification_dir}/{task-id}.md with per-criterion analysis and file:line references.
  5. Updates the task — Adds an Acceptance Criteria section with checkboxes ([x], [/], [ ]) and links to the report.
  6. Evaluates completion — Offers to mark the task as Done if criteria are met.

Plan mode

Section titled “Plan mode”

Aggregates task verification results into a plan-level report. It does not re-analyze code; it uses the results from task verification.

  1. Loads the plan — Reads the plan and extracts acceptance criteria.
  2. Loads task results — For each task in subtasks, reads the task file and parses acceptance-criteria checkboxes ([x], [/], [ ]).
  3. Aggregates per criterion — Applies the “weakest link” rule: Not Met if any task has [ ], Partial if any has [/], Met if all have [x].
  4. Generates a plan report — Writes a report to {plan_verification_dir}/{plan-id}.md with summary, task table, per-criterion breakdown, and recommendations.
  5. Updates the plan — Adds or updates a “Verification Status” section in the plan with the aggregated status and a link to the full report.
  6. Evaluates completion — Offers to mark the plan as Done if criteria are met.

Manual mode

Section titled “Manual mode”

Fast-path approval without analysis. Does not read the plan, extract acceptance criteria, or analyze code.

  1. Creates a backing task (if file is a TODO fragment) or uses the existing task file.
  2. Writes a verification report to {task_verification_dir}/{task-id}.md noting manual approval.
  3. Marks the item as done.

Invocation

Section titled “Invocation”

From the kanban board, use Verify on a task or plan card. The default prompt templates are:

Task verification: Verify '{{title}}' using /atelier-verify mode=task file={{file}} plan_path={{planPath}} subtasks={{subtasks}} task_dir={{taskDir}} task_verification_dir={{taskVerificationReportDir}}

Plan verification: Verify '{{title}}' using /atelier-verify mode=plan file={{file}} subtasks={{subtasks}} task_verification_dir={{taskVerificationReportDir}} plan_verification_dir={{planVerificationReportDir}}

Manual approval: Mark '{{title}}' as done using /atelier-verify mode=manual file={{file}} task_dir={{taskDir}} task_verification_dir={{taskVerificationReportDir}} plan_verification_dir={{planVerificationReportDir}}

You can also run in Claude Code:

  • /atelier-verify mode=task file=~/.atelier/projects/.../tasks/myapp/1.md plan_path=~/.atelier/projects/.../plans/dark-mode.md task_verification_dir=~/.atelier/projects/.../verification/tasks/
  • /atelier-verify mode=plan file=~/.atelier/projects/.../plans/dark-mode.md subtasks=tasks/1.md,tasks/2.md plan_verification_dir=~/.atelier/projects/.../verification/plans/
  • /atelier-verify mode=manual file=./TODO.md#add-dark-mode task_verification_dir=~/.atelier/projects/.../verification/tasks/