sdd-gap-report

Compares TRD use cases against source code to report implementation gaps.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/asengardeon/btt-sdd-pipeline --skill sdd-gap-report-asengardeon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-gap-report
Source: https://github.com/asengardeon/btt-sdd-pipeline/tree/main/.claude/skills/sdd-gap-report
Command: npx skills add https://github.com/asengardeon/btt-sdd-pipeline --skill sdd-gap-report-asengardeon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When a feature's Technical Requirements Document (TRD) lists many use cases, it is hard to know which ones are actually implemented in code and which exist only on paper. This Skill automates that comparison so teams can see implementation gaps without manually re-reading the TRD and grepping class by class. ## Core Features & Use Cases - Automated TRD-to-code comparison: Parses section 6 ("Casos de uso") of specs/<slug>/trd.md and searches src/ and frontend/ for each use case class name, producing a table of use case | acceptance criterion | implemented (yes/no) | evidence file. - Cross-platform scripts: Ships both a Bash script and a PowerShell script, with configurable search paths for projects using non-standard folder conventions (e.g., Laravel's src/app/Application/UseCases/ or monorepos). - Honest gap signaling: Flags that a "NÃO" result is a text-search heuristic, not proof of missing implementation, and instructs manual confirmation before blocking decisions. - Use Case: Before a release review, run the report on a feature slug to instantly see which of the 12 planned use cases have real code behind them and which are still only designed in the TRD. ## Quick Start Ask the assistant to run the gap report for a feature, for example: "Run /sdd-gap-report for the checkout feature and tell me which use cases from the TRD are not implemented yet."

Frequently Asked Questions about sdd-gap-report

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

FAQPage Schema
How do I check which TRD use cases are implemented in code?▼

Run the sdd-gap-report script with the feature slug, for example scripts/sdd-gap-report.sh <slug>. It parses section 6 of specs/<slug>/trd.md and greps src/ and frontend/ for each use case class name, returning a table with implementation status and evidence files.

How do I run the gap report on a project with a custom folder structure?▼

Pass your code directories as extra arguments, such as scripts/sdd-gap-report.sh my-feature src/app/Application/UseCases, or -SearchPaths in PowerShell. This overrides the default auto-detection of src/ and frontend/ without editing the script.

Does the gap report work on Windows with PowerShell?▼

Yes, a PowerShell version is included: run scripts/sdd-gap-report.ps1 -Slug <slug> with optional -SearchPaths. It produces the same comparison table as the Bash script and reads the TRD with UTF-8 encoding.

Why does the gap report say a use case is not implemented when it is?▼

The report uses text search for class names, not AST parsing, so renamed classes or code outside the searched roots produce false negatives. Confirm any "NÃO" result with a targeted file read or additional grep before treating it as unimplemented.

What are the limitations of the TRD gap analysis?▼

It only parses the standard use-case table format from the TRD template and does not verify QA or security approval status. If the table deviates from the expected format, the script reports that no rows were recognized and the TRD must be read manually.