bmad-testarch-trace

Generate requirements-to-tests traceability matrices and quality gate decisions for test coverage analysis.

2|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Wizarck/nexandro --skill bmad-testarch-trace-wizarck
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-testarch-trace
Source: https://github.com/Wizarck/nexandro/tree/main/skills/bmad-testarch-trace
Command: npx skills add https://github.com/Wizarck/nexandro --skill bmad-testarch-trace-wizarck

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams lack visibility into which requirements are actually covered by tests and whether a story, epic, or release is safe to deploy. This Skill maps acceptance criteria, API contracts, or inferred user journeys to existing tests, classifies coverage gaps by priority, and produces a deterministic PASS/CONCERNS/FAIL/WAIVED gate decision. ## Core Features & Use Cases - Traceability Matrix Generation: Maps coverage oracle items (acceptance criteria, OpenAPI endpoints, or synthetic journeys) to E2E, API, component, and unit tests with FULL/PARTIAL/NONE status. - Gap Analysis & Heuristics: Detects uncovered endpoints, missing auth negative-path tests, happy-path-only criteria, and duplicate coverage, prioritized as CRITICAL/HIGH/MEDIUM/LOW. - Quality Gate Decision: Evaluates P0/P1 pass rates, coverage thresholds, security issues, and flakiness to emit a gate decision plus machine-readable JSON summaries for CI/CD pipelines. - Use Case: Before merging a PR for story 1.3, run the workflow to discover that password reset has only PARTIAL coverage, receive recommended test IDs to add, and get a CONCERNS gate decision with a remediation backlog. ## Quick Start Ask the AI to create a traceability matrix and analyze test coverage for the current story or release.

Frequently Asked Questions about bmad-testarch-trace

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

FAQPage Schema
How do I create a requirements traceability matrix for my tests?▼

Run the trace workflow, which discovers tests by ID, describe blocks, and file patterns, then maps each requirement or journey to matching tests. It outputs a traceability-matrix.md with coverage status per criterion plus a gap analysis.

What is a quality gate decision in CI/CD testing?▼

A quality gate decision is a PASS, CONCERNS, FAIL, or WAIVED verdict computed from deterministic rules such as 100% P0 coverage, P0 pass rate, zero security issues, and zero flaky tests. The workflow emits gate-decision.json so pipelines can block or allow deployments.

Can traceability work without formal requirements documents?▼

Yes. When no formal oracle exists, the workflow resolves contracts like OpenAPI specs, follows external pointers to trackers such as Jira, or infers synthetic user journeys from source code routes, forms, and auth flows as a fallback.

Does the traceability workflow generate missing tests automatically?▼

No. It identifies coverage gaps and recommends specific test IDs, levels, and Given-When-Then scenarios, but test creation is delegated to separate ATDD or automation workflows.

What test levels does coverage analysis support?▼

Coverage is classified across E2E, API, component, and unit levels, with statuses like FULL, PARTIAL, NONE, UNIT-ONLY, and INTEGRATION-ONLY. It also flags unacceptable duplicate coverage across levels.