zhongwei/gh-jschulte-claude-plugins-stackshift

Files

Zhongwei Li f8e59e249c Initial commit

2025-11-30 08:29:31 +08:00

2.9 KiB

Raw Blame History

description

description
Generate spec-to-code coverage map showing which code files are covered by which specifications. Creates ASCII diagrams, reverse indexes, and coverage statistics.

Generate Spec Coverage Map

Create a comprehensive visual map of specification-to-code coverage.

What This Does

Analyzes all specifications and generates a coverage map showing:

Spec → Files: ASCII box diagrams for each spec
Files → Specs: Reverse index table
Coverage Statistics: Percentages by category
Heat Map: Visual representation
Gap Analysis: Uncovered files
Shared Files: High-risk multi-spec files

Output: docs/spec-coverage-map.md

Usage

# Generate coverage map
/stackshift.coverage

I'll:

Find all spec files in .specify/memory/specifications/ or specs/
Extract file references from each spec
Categorize files (backend, frontend, infrastructure, etc.)
Generate visual diagrams and tables
Calculate coverage statistics
Identify gaps and shared files
Save to docs/spec-coverage-map.md

When to Use

✅ After Gear 6 (Implementation complete)
✅ During code reviews (validate coverage)
✅ When onboarding new team members
✅ Before refactoring (identify dependencies)
✅ For documentation audits

Example Output Summary

📊 Spec Coverage Health Report

Overall Coverage: 91% (99/109 files)

By Category:
  Backend:       93% [████████████████░░]
  Frontend:      92% [████████████████░░]
  Infrastructure: 83% [███████████████░░░]
  Database:      100% [████████████████████]
  Scripts:       67% [█████████░░░░░░░░░]

Status:
  ✅ 12 specs covering 99 files
  ⚠️  10 gap files identified
  🔴 2 high-risk shared files

Full report: docs/spec-coverage-map.md

What You'll See

The full coverage map includes:

ASCII Box Diagrams

┌─────────────────────────────────┐
│  001-vehicle-details            │ Status: ✅ COMPLETE
├─────────────────────────────────┤
│ Backend:                        │
│  ├─ api/handlers/vehicle.ts     │
│  └─ api/services/data.ts        │
│ Frontend:                       │
│  └─ site/pages/Vehicle.tsx      │
└─────────────────────────────────┘

Reverse Index

| File | Covered By | Count |
|------|------------|-------|
| lib/utils/pricing.ts | 001, 003, 004, 007, 009 | 5 |

Coverage Gaps

Files not covered by any specification:
- api/utils/debug.ts
- scripts/experimental/test.sh

Ready! Let me generate your spec coverage map now...

2.9 KiB Raw Blame History