Scenario Coverage Reviewer

Reviews test files against spec-derived scenario tables to flag uncovered scenarios.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/htxryan/claude-code-config-profiles --skill scenario-coverage-reviewer-htxryan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Scenario Coverage Reviewer
Source: https://github.com/htxryan/claude-code-config-profiles/tree/main/.agents/skills/compound/agents/scenario-coverage-reviewer
Command: npx skills add https://github.com/htxryan/claude-code-config-profiles --skill scenario-coverage-reviewer-htxryan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a spec defines a scenario table (happy paths, errors, boundaries, adversarial cases), it is easy for tests to silently miss scenarios. This Skill heuristically matches test cases against each scenario row and reports coverage gaps before code ships. ## Core Features & Use Cases - Heuristic Scenario Matching: Matches tests to scenarios by precondition, trigger, and expected outcome similarity rather than mechanical name traceability, accepting property-based tests as covering multiple boundary or combinatorial scenarios. - Prioritized Findings: Flags fully uncovered scenarios as P1 SCENARIO_GAP findings and partially covered ones (trigger tested but outcome not asserted) as P2 PARTIAL findings. - Coverage Summary: Reports an X/Y scenarios covered percentage and routes uncovered security or boundary scenarios to the appropriate reviewer teammates via SendMessage. - Use Case: During a review phase on a diff over 100 lines, spawn this reviewer to read the epic's scenario table with bd show <epic>, scan the changed test files, and surface any S-IDs lacking test coverage. ## Quick Start Ask the agent to review the current diff's test files against the scenario table in the beads epic and report any uncovered or partially covered scenarios.

Frequently Asked Questions about Scenario Coverage Reviewer

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

FAQPage Schema
How do I check test coverage against a spec scenario table?▼

Extract the scenario table from the epic description, then heuristically match each scenario row to test cases by precondition, trigger, and expected outcome. Report uncovered scenarios as P1 gaps and partially covered ones as P2 findings with a coverage percentage summary.

How does heuristic scenario matching differ from mechanical traceability?▼

Heuristic matching judges whether a test exercises the same logical path as a scenario, even with different naming, rather than requiring explicit ID references. Property-based tests can count as covering multiple boundary or combinatorial scenarios.

What counts as a partially covered test scenario?▼

A scenario is partially covered when the trigger is tested but the expected outcome is not asserted. These are flagged as P2 PARTIAL findings rather than full P1 gaps.

When is the scenario coverage reviewer spawned in a review workflow?▼

It runs as a medium-tier AgentTeam member in the review phase, spawned for diffs larger than 100 lines. It shares findings with security-reviewer and test-coverage-reviewer teammates via SendMessage.

What are the limitations of heuristic test coverage review?▼

Heuristic matching relies on AI judgment of logical-path similarity, so it can produce false positives or miss subtle gaps that strict traceability matrices would catch. It complements rather than replaces line-coverage tooling.