verification-before-completion

Audits task diffs against acceptance criteria using a fresh-context verifier.

27|6|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/heimeshoff/Agentheim --skill verification-before-completion-heimeshoff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/heimeshoff/Agentheim/tree/main/skills/verification-before-completion
Command: npx skills add https://github.com/heimeshoff/Agentheim --skill verification-before-completion-heimeshoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents premature commits by introducing a verifier with a fresh context to audit the diff against the task's acceptance criteria, ensuring correctness and guarding against scope drift before the code is committed.

Core Features & Use Cases

  • Spawns the verifier with absolute paths to the task file, the BC README, and the diff to enable isolated inspection.
  • Verifies acceptance criteria coverage, test results, and scope boundaries to reduce regressions and misaligned changes.
  • Enforces disciplined review by validating ADR decisions and invariants, and by restricting exposure to the worker's reasoning trail.
  • Produces deterministic verdicts (PASS, FAIL with re-dispatch, or SKIP) to guide the commit workflow and subsequent tasks.

Quick Start

Run the verifier against the current task after a worker reports SUCCESS to ensure the diff meets acceptance criteria.

Frequently Asked Questions about verification-before-completion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify code changes against acceptance criteria before committing?

Verify code changes against acceptance criteria by spawning a fresh-context verifier to audit the task diff. This isolated inspection validates test coverage, scope boundaries, and language alignment without exposure to the worker's internal reasoning.

What is a fresh-eyes QA gate for code review?

A fresh-eyes QA gate audits a worker's completed diff using a verifier with no prior context, ensuring acceptance criteria are met before committing. It prevents premature commits by validating scope and test results independently of the original worker's reasoning.

How do I prevent scope drift when reviewing task diffs?

Prevent scope drift by running a fresh-context verifier that compares the task diff against acceptance criteria. This diff audit validates scope boundaries, checks test coverage, and enforces ADR decisions before the code is committed.

Can I validate ADR-driven decisions and invariants during automated code review?

Yes, you can validate ADR-driven decisions and invariants during code review by spawning a verifier with fresh context. The verifier enforces disciplined review by checking the diff against the BC README and task acceptance criteria.

What verdicts does an automated diff audit produce for a commit workflow?

An automated diff audit produces deterministic verdicts of PASS, FAIL with re-dispatch, or SKIP. These verdicts guide the commit workflow and subsequent tasks by confirming whether the task diff meets acceptance criteria.

When should I not use a fresh-context verifier for code review?

You should not use a fresh-context verifier when you lack access to the task file, the BC README, or the diff. The verifier requires these absolute paths to enable isolated inspection and cannot function without them.