spec-coverage-map

Generate ASCII diagrams, reverse indexes, and coverage statistics mapping specifications to code files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jschulte/stackshift --skill spec-coverage-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-coverage-map
Source: https://github.com/jschulte/stackshift/tree/main/skills/spec-coverage-map
Command: npx skills add https://github.com/jschulte/stackshift --skill spec-coverage-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often struggle to understand how specifications map to code. This Skill generates a visual spec-to-code coverage map, creates a reverse index, and reports coverage statistics to identify gaps and shared files.

Core Features & Use Cases

  • Spec → Files mapping: See which code files each spec covers.
  • Files → Specs reverse index: Identify which specs cover a given file.
  • Coverage statistics: Categorized metrics (backend, frontend, infrastructure).
  • Gap analysis: Detect code not covered by any spec.
  • ASCII diagrams: Human-friendly diagrams for docs.

Quick Start

After Gear 6 implementation or during cleanup, run this Skill to generate docs/spec-coverage-map.md containing ASCII diagrams, a reverse index, and coverage statistics.

Frequently Asked Questions about spec-coverage-map

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

FAQPage Schema
How do I visualize which specifications cover which code files?

Spec-to-code coverage mapping reveals which code files each specification covers by parsing specs, extracting file references, and generating ASCII diagrams with reverse indexes. Run the Skill after Gear 6 implementation to produce docs/spec-coverage-map.md showing coverage across backend, frontend, and infrastructure.

Can I identify code files not covered by any specification?

Gap analysis detects code not covered by specifications. The Skill computes coverage statistics and highlights gaps in the generated ASCII diagrams and reverse index, helping teams spot undocumented or orphaned files across all layers.

What's the best way to document spec-to-code relationships in a team project?

Generate a comprehensive spec-to-code coverage map that produces ASCII diagrams, reverse indexes mapping files back to specs, and categorized coverage statistics. This creates human-friendly documentation suitable for cleanup phases and knowledge transfer.

How do I find which specifications cover a specific code file?

The reverse index component maps individual files to all specifications covering them. Query the generated coverage map to see dependencies, shared ownership, and spec-to-file relationships for any code file across your architecture.

Do I need to run this Skill at a specific point in development?

Run spec-coverage-map after Gear 6 implementation or during cleanup and documentation phases. It requires parsed specifications with file references already in place; use it when you're ready to audit coverage and identify gaps.

Can I detect shared files across multiple specifications?

Yes. The Skill highlights shared files covered by multiple specs and categorizes them by backend, frontend, and infrastructure. This reveals overlapping coverage and helps surface coordination opportunities or potential conflicts.