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.