trace-requirements

Generate bidirectional traceability matrices mapping acceptance criteria to implementation evidence and tests.

2|2|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill trace-requirements
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace-requirements
Source: https://github.com/adolfoaranaes12/BMAD-ENHANCED/tree/main/.claude/skills/trace-requirements
Command: npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill trace-requirements

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires risk-profile, test-design, and includes references (resource) and templates (resource) components.

What problem does it solve?

This Skill builds a traceability matrix mapping acceptance criteria to implementation and tests, identifies gaps, and assesses the impact on quality gates.

Core Features & Use Cases

  • Forward traceability: AC -> implementation evidence
  • Backward traceability: tests -> AC coverage
  • Gap analysis and severity assignment
  • Gate impact assessment and recommendations

Quick Start

Generate a traceability report linking ACs to files and tests.

Frequently Asked Questions about trace-requirements

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

FAQPage Schema
How do I create a traceability matrix mapping acceptance criteria to tests?

A traceability matrix links each acceptance criterion to implementation evidence and test cases, creating bidirectional links from ACs forward to code and backward from tests to requirements. This Skill generates a comprehensive matrix that documents these connections, identifies coverage gaps, and produces audit-ready reports showing which ACs are tested and which lack evidence.

What is gap analysis in requirements traceability?

Gap analysis identifies acceptance criteria that lack test coverage or implementation evidence. This Skill assigns severity and priority classifications to gaps, helping teams understand which missing connections pose the highest risk and impact quality gates most significantly.

Can I use traceability matrices to verify test coverage completeness?

Yes. This Skill builds backward traceability from tests to acceptance criteria, letting you verify that every test maps to a requirement and every AC has corresponding test evidence. Coverage metrics show what percentage of ACs are tested and which areas have gaps.

How does traceability impact quality gates and compliance audits?

Traceability matrices provide the evidence needed for compliance audits and quality gate decisions. This Skill assesses gap severity against quality gate criteria and generates recommendations, showing whether missing coverage should block release or requires remediation before deployment.

What dependencies do I need before building a traceability matrix?

You need a risk profile to contextualize gaps and understand impact, and test design documentation to establish the baseline of what tests exist. These inputs allow the Skill to classify gaps by severity and priority relative to overall project risk.

Does this approach work for large codebases with many acceptance criteria?

Yes. This Skill is designed for comprehensive bidirectional traceability across complex projects. It scales to generate audit-ready reports across many ACs, implementations, and tests while maintaining detailed gap identification and coverage metrics.

Related Skills