qa-commit

Verify commits against QA Contracts with lint, type, and test checks.

341|48|Updated Apr 4, 2025
One-click install
npx skills add https://github.com/WellApp-ai/Well --skill qa-commit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qa-commit
Source: https://github.com/WellApp-ai/Well/tree/main/cursor-rules/skills/qa-commit
Command: npx skills add https://github.com/WellApp-ai/Well --skill qa-commit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures commits satisfy their assigned QA Contract criteria (G#N Gherkin scenarios and AC#N acceptance criteria) by automatically loading criteria, running lint checks, type checks, and tests, and triggering debug on failure.

Core Features & Use Cases

  • QA Contract driven validation: verifies Gherkin scenarios and acceptance criteria for each commit.
  • Deterministic verification flow: loads criteria, validates code, runs tests, and reports results in a structured Verification Report.
  • Automatic debugging on RED: on failure, automatically invokes the debug workflow to surface issues.

Quick Start

Use the qa-commit skill to verify your current commit against the assigned QA Contract. If RED is returned, the system will auto-invoke debugging to help resolve failures.

Frequently Asked Questions about qa-commit

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

FAQPage Schema
How do I automate commit verification against Gherkin scenarios and acceptance criteria?▼

To automate commit verification, load assigned QA contracts, run lint and type checks, execute tests, and verify Gherkin endpoints to generate an end-to-end Verification Report.

What happens when automated QA contract checks fail during a commit?▼

When automated QA contract checks fail and return RED, the system automatically invokes a debug workflow to surface issues and help resolve failures.

Does the commit verification flow support npm typecheck and lint?▼

Yes, the commit verification flow executes ReadLints and npm typecheck alongside related tests and optional browser MCP steps to satisfy external checks.

What is a QA contract and how does it validate code changes?▼

A QA contract defines Gherkin scenarios and acceptance criteria that validate code changes by running deterministic checks on lint, types, and tests to ensure compliance.

Can I run end-to-end verification reports without manual test execution?▼

Yes, the system generates an end-to-end Verification Report automatically by loading criteria, validating code, running tests, and verifying Gherkin endpoints.

Why does my typecheck pass but the commit verification still fail?▼

A commit verification can still fail if the code violates assigned Gherkin endpoints or acceptance criteria, triggering an automatic debug workflow to resolve the mismatch.