qa-trace-requirements

Creates a requirements traceability matrix mapping acceptance criteria to test coverage.

3|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/gabrielnsmnto/kord-aios --skill qa-trace-requirements-gabrielnsmnto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qa-trace-requirements
Source: https://github.com/gabrielnsmnto/kord-aios/tree/main/src/features/builtin-skills/kord-aios/qa/qa-trace-requirements
Command: npx skills add https://github.com/gabrielnsmnto/kord-aios --skill qa-trace-requirements-gabrielnsmnto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often ship stories without knowing whether every acceptance criterion is actually covered by tests, leaving gaps that surface as production defects. This Skill builds a requirements traceability matrix that maps each acceptance criterion to concrete test cases and exposes uncovered or partially covered requirements. ## Core Features & Use Cases - Requirement Extraction: Pulls testable requirements from acceptance criteria, user stories, tasks, and non-functional requirements. - Coverage Mapping: Documents which unit, integration, and e2e tests validate each requirement using Given-When-Then descriptions, with coverage levels (full, partial, none, integration, unit). - Gap Analysis & Gate Output: Identifies coverage gaps with severity ratings, suggests new tests, and emits a gate YAML block plus a dated traceability report for quality gate decisions. - Use Case: Before closing a login story, run this Skill to confirm AC1 through AC5 each have tests, discover that the password-reset timing requirement has no coverage, and record the gap in the quality gate. ## Quick Start Ask the QA agent to trace the requirements of the current story and generate a traceability matrix with coverage gaps.

Frequently Asked Questions about qa-trace-requirements

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

FAQPage Schema
How do I create a requirements traceability matrix for a user story?▼

Extract all testable requirements from the acceptance criteria, story statement, and tasks, then map each one to the unit, integration, or e2e tests that validate it. Document each mapping with Given-When-Then descriptions and assign a coverage level such as full, partial, or none.

How to check if every acceptance criterion has test coverage?▼

Run a traceability analysis that lists each acceptance criterion and the test files validating it. Criteria with no mapped tests are flagged as uncovered, and partially covered ones are marked with the missing aspects and suggested tests.

Should Given-When-Then be used in actual test code?▼

No. Given-When-Then is used only to document what each test validates in the traceability matrix, not how tests are written. Test code should follow the project's existing standards, such as describe/it blocks, without BDD syntax.

What happens when traceability finds coverage gaps?▼

Each gap is recorded with a severity rating and a suggested test type, such as integration or performance. Critical gaps cause the quality gate to FAIL, while minor gaps or missing P0 tests result in CONCERNS status.

What are the limitations of requirements traceability analysis?▼

It requires a story file with clear acceptance criteria and access to existing test files to produce accurate mappings. It documents coverage but does not write or execute the missing tests itself.