sb-gap-analysis

Compare planned work against existing repository implementation and record gap findings.

Updated Jul 17, 2026
One-click install
npx skills add https://github.com/Huruikagi/pc-build-planner --skill sb-gap-analysis-huruikagi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sb-gap-analysis
Source: https://github.com/Huruikagi/pc-build-planner/tree/main/.agents/skills/sb-gap-analysis
Command: npx skills add https://github.com/Huruikagi/pc-build-planner --skill sb-gap-analysis-huruikagi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before writing requirements or design, teams often guess whether the codebase already supports a requested change. This Skill investigates what the repository actually provides, names precisely what is missing, unknown, or constrained, and hands the next phase evidence it can decide from—without making the decision itself. ## Core Features & Use Cases - Evidence-based investigation: Dispatches fresh readers to examine what exists, what constrains it, and what the work must meet, reading actual code rather than plausible assumptions. - Routing of findings: Sends discoveries that change what is being asked back to the user before touching the brief, while design constraints flow to the design phase instead of polluting requirements. - Optional research artifact: Writes a research document only when findings outlive the analysis, marking each conclusion for its proper destination (Brief, Requirements, Design, Steering, or none). - Use Case: After a new feature request is routed to a spec, run this analysis to discover that a similar module already exists but restricts how the work can be done—recording that as design input rather than a requirement. ## Quick Start Use the sb-gap-analysis skill to compare the intended work for this spec against what the repository already provides and report what is missing, unknown, or constrained.

Frequently Asked Questions about sb-gap-analysis

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

FAQPage Schema
How do I check if my codebase already supports a planned feature?▼

Run a gap analysis that reads the spec brief, steering documents, and existing code, then dispatches fresh readers to investigate what exists, what constrains it, and what the work must meet. The output distinguishes what is missing, unknown, and constrained.

When should gap analysis run in a spec-driven workflow?▼

Run it right after routing, before requirements are written. Requirements are an input, not a precondition—running early means the findings are cheapest to act on, and the analysis works from the milestone scope when no requirements exist yet.

Does gap analysis change requirements or the spec brief?▼

No. It informs but does not decide. Findings that change what is being asked go back to the user first; only after user acceptance is the brief revised. Design constraints flow to the design phase, never into requirements.

When should I write a research artifact versus skipping it?▼

Write research only when findings outlive the analysis: substantial investigation a later session would repeat, conclusions design needs and cannot reconstruct, or an explicit user request. Routine analysis needs no document, and you must state which you chose and why.

What are the limitations of gap analysis output?▼

Research binds nothing and is deleted at release finalization. Requirements, design, and contracts remain the authoritative statements, and no later artifact may defer meaning to the research document.