bmad-testarch-trace

Map requirements to tests and generate a traceability matrix with coverage gaps.

88|24|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise --skill bmad-testarch-trace-bmad-code-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-testarch-trace
Source: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/workflows/testarch/bmad-testarch-trace
Command: npx skills add https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise --skill bmad-testarch-trace-bmad-code-org

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml.

What problem does it solve?

Automates the creation of a traceability matrix by mapping requirements to tests, surfacing coverage gaps, and enabling governance through a quality gate.

Core Features & Use Cases

  • Maps formal requirements, spec items, and inferred journeys to corresponding tests to build a complete traceability matrix.
  • Performs gap analysis (coverage, authenticity of items, and risk priorities) and outputs actionable recommendations.
  • Emits a machine-readable summary (e.g., e2e-trace-summary.json) and gate decisions when gate-eligibility criteria are satisfied.

Quick Start

Run the trace workflow to generate the traceability matrix and gate decision using your configured project settings.

Frequently Asked Questions about bmad-testarch-trace

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

FAQPage Schema
How do I automate building a traceability matrix from requirements to tests?

To build a traceability matrix, this Skill maps formal requirements, spec items, and inferred journeys to corresponding tests, surfacing coverage gaps and outputting actionable recommendations automatically.

What is a quality gate decision in test architecture and how is it generated?

A gate decision is a machine-readable summary determining if test coverage satisfies governance criteria. It is generated by performing gap analysis and evaluating gate-eligibility across your test architecture.

How do I identify coverage gaps in my test architecture?

You identify coverage gaps by mapping formal requirements and inferred journeys to existing tests. This process performs gap analysis to evaluate coverage authenticity and output risk prioritization recommendations.

Can I use yaml configurations to generate machine-readable test summaries?

Yes, you can use yaml configurations to define project settings. The workflow processes these settings to emit a machine-readable summary, such as e2e-trace-summary.json, and gate decisions.

What is the best way to persist provenance and oracle sources for traceability workflows?

The best way to persist provenance and oracle sources is through deterministic multi-step orchestration. This workflow saves output artifacts and provenance data to configured locations during tracing.

Does this traceability workflow support complex multi-phase test architectures?

Yes, it supports complex test architectures by executing Phase 1 tracing to build the matrix and Phase 2 to generate gate decisions, handling prioritization and automated outputs across both phases.