verification-loop

Runs prioritized verification checks for builds, types, lint, tests, security, spec conformance, and silent-failures before merging PRs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Pyl-Tech/stream-coding --skill verification-loop-pyl-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-loop
Source: https://github.com/Pyl-Tech/stream-coding/tree/main/.agents/skills/verification-loop
Command: npx skills add https://github.com/Pyl-Tech/stream-coding --skill verification-loop-pyl-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill prevents AI-generated code from passing “looks good” reviews by enforcing deterministic verification gates that catch build failures, spec drift, test-quality issues, and silent failure patterns before a PR.

Core Features & Use Cases

  • Multi-phase quality verification: Runs prioritized checks for security, build, types, lint, tests, and debugging artifacts.
  • Spec conformance audit: Detects divergence between specification documents and exported symbols, API routes, and referenced files.
  • TDD gate enforcement: Verifies the TDD sequencing artifact via .tdd_lock to prevent gate skipping and confirmation bias.
  • Silent-failure hunting: Flags common patterns that hide broken behavior even when CI might appear green.
  • Use cases: After completing a feature, after refactoring, and before creating a PR to ensure the implementation matches the spec and the test-first process was followed.

Quick Start

Run the verification loop with: python .agents/skills/verification-loop/scripts/verify.py . --priority P0,P1,P2,P3,P4,P5,P6,P7,P8,P9,P10

Frequently Asked Questions about verification-loop

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

FAQPage Schema
How do I enforce spec conformance and prevent silent failures before creating a PR?

To enforce spec conformance and prevent silent failures before a PR, run a verification loop that executes prioritized checks for build, typecheck, lint, tests, and security while auditing exported symbols against specification documents.

What is a TDD gate and how does it prevent test-first process skipping?

A TDD gate prevents test-first process skipping by verifying the TDD sequencing artifact via a .tdd_lock file, ensuring developers followed the correct test-driven development sequence and blocking integration if gate skipping or confirmation bias is detected.

How do I run prioritized quality checks across security, build, and linting phases?

You run prioritized quality checks across security, build, and linting phases by executing the verification script with a priority flag, allowing you to sequence checks from P0 through P10 to catch critical security and build failures before lower priority lint issues.

Can I detect spec drift between my specification documents and API routes automatically?

Yes, you can detect spec drift between specification documents and API routes automatically through the spec conformance audit, which flags divergence by comparing exported symbols, API routes, and referenced files against the defined specification.

What's the best way to catch silent failure patterns that pass CI in AI-assisted code?

The best way to catch silent failure patterns in AI-assisted code is to use silent-failure hunting, which flags common patterns that hide broken behavior even when CI appears green, ensuring deterministic verification gates block PR creation for flawed implementations.

Do I need a .tdd_lock file to enforce TDD sequence during code review cycles?

Yes, you need a .tdd_lock file to enforce TDD sequence during code review cycles, as the verification loop requires this sequencing artifact to verify that the test-first process was followed and to prevent developers from bypassing the TDD gate.