gap-review

Identify gaps between implemented solutions and original architecture documents.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/I-Synergy/AI --skill gap-review-i-synergy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gap-review
Source: https://github.com/I-Synergy/AI/tree/main/.claude/skills/gap-review
Command: npx skills add https://github.com/I-Synergy/AI --skill gap-review-i-synergy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates alignment between a generated or implemented solution and the original architecture document and design decisions, helping teams detect drift early and maintain architectural integrity.

Core Features & Use Cases

  • Gap detection: Detects deviations from the architecture document and decisions.
  • Traceability checks: Verifies decisions are traceable to the implementation.
  • Use Case: After solution generation or feature completion, run gap-review to surface missing decisions and unresolved design trade-offs.

Quick Start

Compare the current solution with the architecture document and identify any deviations.

Frequently Asked Questions about gap-review

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

FAQPage Schema
How do I verify traceability between an implemented solution and the original architecture document?

To verify traceability, compare the generated solution against the architecture document to detect deviations and surface missing design decisions. This gap review checks alignment with documented constraints and architecture patterns after feature completion.

When should I run an architecture gap review on my software project?

You should run an architecture gap review after solution generation or feature completion. This timing allows you to detect drift early, validate traceability of decisions, and highlight unresolved design trade-offs before they impact architectural integrity.

What is the best way to detect deviations from documented architecture patterns and design decisions?

The best way to detect deviations is to validate the implementation by comparing it directly with the architecture document. This process surfaces missing design commitments and verifies that the solution aligns with documented constraints.

Can I use a gap review to check for unresolved design trade-offs in my solution?

Yes, a gap review can check for unresolved design trade-offs by identifying gaps between the implemented solution and the original architecture document. It highlights missing decisions and verifies that existing architecture patterns are properly applied.

Why does my implemented solution drift from the documented architecture constraints?

Solutions drift from architecture constraints when implementation skips documented design decisions. A gap review surfaces these missing commitments and deviations, helping teams validate alignment and maintain architectural integrity over time.