saas-migration-audit

What problem does it solve?

Provides a structured, non-destructive analysis of existing JavaScript/TypeScript projects to determine feasibility, risks, and effort required to migrate to a canonical SaaS stack (Turborepo, Next.js, tRPC, Drizzle, Auth.js, Stripe, PageShell). The skill centralizes stack detection, gap classification, data migration risk assessment, and produces a clear migration plan so teams can decide whether to migrate, partially migrate, or rebuild.

Core Features & Use Cases

• Automated Stack Detection: Scans manifests and common files to detect package manager, monorepo tooling, framework, ORM, auth, billing, CI/CD, and deployment patterns.
• Gap Classification & Risk Scoring: Maps each layer to MATCH/COMPATIBLE/DIVERGENT/MISSING/CONFLICTING with quantitative risk assessment and impact/probability scoring.
• Data & Auth Migration Assessment: Highlights schema, auth, and billing migration risks, and lists mitigation and rollback strategies for critical gaps.
• Phased Migration Planning: Produces a dependency-aware, phase-by-phase migration plan with verification and rollback steps and estimated effort per phase.
• Non-destructive Reporting: Generates a markdown audit report suitable for stakeholder review without making any changes to source code.

Quick Start

Ask the skill to analyze the repository at the given path and produce a phased markdown migration audit comparing the current stack to the canonical SaaS stack.