gap-review

Audit alignment between SDDs and software artifacts to surface gaps and create remediation plans.

21|3|Updated May 26, 2026
One-click install
npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill gap-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gap-review
Source: https://github.com/AlphaBitCore/nexus-gateway/tree/main/.claude/skills/gap-review
Command: npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill gap-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gap Review automates the systematic comparison between SDDs, architecture, requirements, OpenAPI specs, code, and tests to surface misalignments and create actionable remediation plans.

Core Features & Use Cases

  • SDD-to-code parity audit: identify where implementation diverges from the SDD and document exact gaps.
  • Code-to-SDD gaps discovery: surface improvements introduced in code that are not described in the SDD.
  • Comprehensive traceability mapping: connect stories to requirements, APIs, architecture, and tests for full coverage.
  • Plan to fix gaps: generate prioritized plans and task lists to bring docs and code into alignment.

Quick Start

Trigger a gap-review run on recent changes to generate a parity report.

Frequently Asked Questions about gap-review

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

FAQPage Schema
How do I audit alignment between my SDD and source code?

To audit SDD-to-code alignment, compare software design documents against implementation artifacts to identify divergences. This process surfaces exact gaps where code strays from architectural design.

What is the best way to map traceability across requirements, APIs, and tests?

Traceability mapping connects stories to requirements, OpenAPI specs, architecture, and tests for full coverage. It ensures every software artifact is linked, providing comprehensive parity verification across the entire development phase.

How do I create a remediation plan for documentation gaps?

Creating a remediation plan for documentation gaps involves generating a prioritized task list to bring docs and code into alignment. The output provides actionable steps to fix misalignments between SDDs and software artifacts.

Can I use gap analysis to find code improvements missing from my SDD?

Yes, gap analysis can discover code-to-SDD gaps by surfacing improvements introduced in the code that are not described in the SDD. This ensures your documentation accurately reflects the current implementation state.

Does this audit work with OpenAPI specs and test suites?

Yes, the audit supports phase-driven analysis across SDDs, requirements, OpenAPI specs, code, and tests to ensure parity. It systematically compares these software artifacts to surface misalignments and generate remediation plans.