Does this skill support monorepos?

Yes, it includes specific detection types for monorepo services, Nx apps, Turborepo packages, and Lerna packages.

What is the difference between Greenfield and Brownfield routes?

Greenfield focuses on building a new app by validating spec completeness and choosing a target tech stack, while Brownfield compares existing code against specs to identify missing features or logic.

How does the AST-powered analysis work?

It parses your source code into an Abstract Syntax Tree to verify function signatures, detect placeholder stubs, find missing parameters, and score implementation confidence.

What are the prerequisites for using the Gap Analysis skill?

You must have initialized a Stackshift project and completed Step 3, ensuring your .specify/ directory contains the necessary specifications for comparison.

What kind of roadmap does the skill generate?

It provides a phased implementation plan categorized by priority (P0-P3), including effort estimates, required UI/UX clarifications, and technical debt assessments.

Route-Aware Gap Analysis

Name: Route-Aware Gap Analysis
Author: jschulte

byjschulte

•

Developer Tools

Analyzes implementation gaps by comparing technical specifications against codebases using AST-powered detection.

The Gap Analysis skill is a pivotal component of the Stackshift toolkit, designed to synchronize specifications with actual implementation. It provides dual-route logic: for Brownfield projects, it uses AST-powered analysis to detect missing logic, function stubs, and requirement inconsistencies; for Greenfield projects, it validates specification completeness and assists in tech-stack selection. By generating detailed, prioritized implementation roadmaps, this skill ensures developers have a clear, data-driven path for modernizing legacy systems or building new, spec-driven applications.

Key Features

01Route-aware logic for both legacy migrations and greenfield builds

02P0-P3 prioritization for implementation roadmaps

03AST-powered code analysis for function signature and stub detection

04Integration with GitHub Spec Kit for standardized documentation

05Automated identification of requirement ambiguities and missing specs

061 GitHub stars

Use Cases

01Auditing existing applications for technical debt and undocumented features

02Synchronizing a legacy codebase with new technical specifications during a migration

03Validating specification readiness before starting a greenfield project build

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jschulte/stackshift gap-analysis

For use in Claude.ai and ChatGPT

Download Skill