kata-quality-gate

Validate implementations against acceptance criteria and quality gates, persisting reports to .ahrena.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-quality-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-quality-gate
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-quality-gate
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-quality-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents shipping incomplete or risky implementations by enforcing a final, evidence-based validation against acceptance criteria, scope, best practices, tests, coverage, types, and performance budgets.

Core Features & Use Cases

  • AC ↔ Test traceability: Ensures every acceptance criterion has at least one covering test and that tests reference the right ACs.
  • Scope creep detection: Flags modifications outside the declared component/file plan, with explicit exceptions for legitimate generated or implicit test artifacts.
  • Quality enforcement checklist: Runs best-practice Lexis, verifies tests and coverage thresholds, checks types, and validates performance budgets when applicable.
  • Single PR and stacked-layer support: Works for both single-PR flows and per-layer stacked PR workflows, including final aggregate validation to catch orphan ACs/components.

Quick Start

Run the kata-quality-gate flow for the current issue layer or PR to produce a quality report at .ahrena/issues/{n}/06-quality-report.md and update the checkpoint status accordingly.

Frequently Asked Questions about kata-quality-gate

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

FAQPage Schema
How do I enforce acceptance criteria traceability to tests before merging a pull request?

Acceptance criteria traceability is enforced by validating that every acceptance criterion has at least one covering test and that tests reference the correct ACs. The quality gate runs checks across traceability, scope, tests, coverage, types, and performance budgets to produce a final go/no-go score.

What is the best way to detect scope creep in a stacked PR workflow?

Scope creep detection flags modifications outside the declared component or file plan, explicitly allowing legitimate generated or implicit test artifacts. It supports per-layer stacked PR workflows by evaluating subsets of acceptance criteria and components per layer while running tests fully.

How do I validate performance budgets and type checking as part of a quality gate?

Performance budgets and type checking are validated through a quality enforcement checklist that verifies best practices, executes tests, checks coverage thresholds, and validates performance budgets when applicable. The gate consolidates these outcomes into a final quality score.

Can I use a quality gate to validate single PRs and catch orphaned acceptance criteria?

Yes, the quality gate works for both single PR flows and per-layer stacked workflows. For stacked workflows, it performs a final aggregate validation in the last layer to catch orphaned acceptance criteria or components that were not covered.

Why does my quality gate require executing checks in a specific order?

Executing checks in a specific order ensures evidence-based validation across traceability, scope, best practices, test execution, coverage, types, and performance budgets. This ordered execution is required to consolidate the final go/no-go decision and persist the quality report.

How do I persist quality validation reports for issue-driven workflows?

Quality validation reports are persisted by writing the final quality score and evidence to `.ahrena/issues/{n}/06-quality-report.md` and updating the checkpoint status in `.ahrena/workflow/issue-{n}/checkpoint.md` to reflect the go/no-go outcome.