coverage-map

Read test plans and pipeline-state.json to report per-story and per-AC coverage status.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill coverage-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coverage-map
Source: https://github.com/heymishy/2x2-v3-28-03-20216/tree/main/.github/skills/coverage-map
Command: npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill coverage-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Produce a visual coverage map across all stories in a feature. Reads from existing pipeline artefacts (test plan .md files + pipeline-state.json). Answers two questions at a glance: what is tested, and by what kind of test? Where are the gaps, and how risky are they? Does not run tests. Does not read test results - reads test plans. Does not generate test plans - that is /test-plan. Does not fix gaps - reports them for humans to action.

Core Features & Use Cases

  • Reads test plan artefacts to compute AC coverage per story (Unit/Integration/E2E/Manual)
  • Produces a per-story rollup with risk scoring and gap types
  • Highlights stories without test plans and shows where gaps exist
  • Provides a concise coverage summary for stakeholders without executing tests
  • Reads artefacts to surface coverage status for planning and risk assessment

Quick Start

Run the coverage map after at least one test plan exists for the feature.

Frequently Asked Questions about coverage-map

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

FAQPage Schema
How do I visualize test coverage gaps across feature stories without executing tests?

You can visualize test coverage gaps by reading existing test plan markdown files and pipeline-state.json artefacts to summarize which stories have automated, manual, or no coverage. This approach flags high-risk gaps for planning without running any tests.

What is the difference between test coverage reporting from artefacts and running automated tests?

Coverage reporting from artefacts reads test plans and pipeline state data to determine what is intended to be tested and by what method, whereas running tests executes code to verify pass or fail outcomes. The reporting approach surfaces coverage gaps for risk assessment.

Can I generate acceptance criteria coverage reports from existing test plans?

Yes, you can generate per-story and per-AC coverage reports by reading existing test plan artefacts. The reports compute coverage status across Unit, Integration, E2E, and Manual test types, highlighting stories without test plans.

Do I need pipeline-state.json artefacts to map test coverage for feature stories?

Yes, pipeline-state.json artefacts are required alongside test plan markdown files to compute coverage. The coverage map reads these existing artefacts to surface per-story coverage status and risk scoring without executing tests.

How do I assess test plan coverage risk for stories lacking automated tests?

You can assess risk by applying the coverage map to features with test plans and pipeline state data. It produces a per-story rollup with risk scoring and gap types, flagging stories with manual or no coverage as high-risk gaps for humans to action.