verification-gate

Compare code changes against story.md and design.md contracts before git commit.

13|2|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/quan2005/journal-claw --skill verification-gate-quan2005
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-gate
Source: https://github.com/quan2005/journal-claw/tree/main/.agents/skills/verification-gate
Command: npx skills add https://github.com/quan2005/journal-claw --skill verification-gate-quan2005

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill prevents developers from declaring work finished or committing code before the implementation has been independently checked against the approved requirement contract. It addresses the common failure mode where code is technically correct and tests pass, but the delivered behavior still misses acceptance criteria, exceeds scope, or diverges from the intended design.

Core Features & Use Cases

  • Independent acceptance review: Requires a separate subAgent to verify implementation against story.md and, when present, design.md rather than relying on the implementer's self-assessment.
  • Dual-contract validation: Checks both user intent and implementation plan using six criteria covering completeness, correctness, redundancy, bias, scope creep, and missing in-scope functionality.
  • Commit-time quality gate: Supports a git commit workflow by prompting verification whenever related approved stories have not yet been marked verified.
  • Traceable verification reports: Produces round-based verify-report files that preserve evidence, failures, user-decision items, and remediation history.
  • Use case: When a feature branch appears complete, use this Skill to review the actual diff against the approved story and design, generate a verification report, and only then mark the story as verified before committing.

Quick Start

Use the verification-gate skill to review my current feature changes against the related approved story and generate a verification report before I commit.

Frequently Asked Questions about verification-gate

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

FAQPage Schema
How do I block unverified code changes from being committed to git?

To block unverified code changes before a git commit, you can apply a commit-time quality gate that checks feature diffs against approved requirement contracts and only allows completion after independent acceptance review passes.

What is independent acceptance review for software development workflows?

Independent acceptance review is a verification process where an isolated subAgent evaluates completed code changes against approved story and design contracts, ensuring implementation satisfies user intent rather than relying on the implementer's self-assessment.

How do I validate feature diffs against approved requirements before completion?

You validate feature diffs by comparing implementation against story.md and design.md files using six acceptance criteria covering completeness, correctness, redundancy, bias, scope creep, and missing in-scope functionality.

Does story review work with both staged and unstaged git changes?

Yes, story review applies to both staged and unstaged git changes, evaluating the actual feature diff against approved stories to generate a verification report before updating the story status to verified.

How do I generate traceable verification reports for acceptance testing?

You generate traceable verification reports by running an isolated subAgent that preserves round-based evidence, failures, user-decision items, and remediation history into verify-report files during the acceptance testing process.

When should I not use a commit-time quality gate for requirements validation?

You should not use a commit-time quality gate when no approved story.md or design.md contracts exist for your feature branch, as requirements validation requires locating related approved stories to evaluate acceptance criteria against.