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.