// Manages the end-to-end modernization of legacy Express monoliths into Next.js architectures. Orchestrates subagents for auditing, scaffolding, and verification. Use when starting or managing a greenfield rewrite project.
Compares a modernized Next.js application against its legacy Express counterpart using runtime side-by-side verification. Use when ensuring functional and business logic parity between two systems.
Systematically probe a modernized Next.js application for logic flaws, security vulnerabilities, or missing features. Use this to find bugs or cases where the migration failed to match legacy behavior.
Analyzes Express route definitions and controller logic to document API endpoints, payloads, and response structures. Use when reverse-engineering an existing Express application's API surface.
Analyzes authentication flows, authorization rules, middleware logic, and side-effects. Use when extracting business rules, Passport configurations, or mailer logic from an Express application.
Analyzes legacy ORM models (Mongoose, Sequelize) to extract schemas, validations, and relationships. Use when reverse-engineering a legacy data layer for a modern rewrite.
Analyzes legacy UI templates (Pug, EJS, HTML) to extract a comprehensive inventory of components, layouts, and conditional logic. Use when reverse-engineering a legacy frontend for a modern rewrite.
| name | orchestrating-greenfield-migration |
| description | Manages the end-to-end modernization of legacy Express monoliths into Next.js architectures. Orchestrates subagents for auditing, scaffolding, and verification. Use when starting or managing a greenfield rewrite project. |
This skill manages the transition from legacy Node.js monoliths (Express/Pug/Mongoose) to modern Next.js architectures using a Greenfield Rewrite strategy.
The preferred workspace layout is a "Modernization Hub" monorepo:
/workspace-root/
āāā .agents/ # This Skills Pack
āāā docs/ # Centralized Audit & Verification Specs
āāā legacy-app/ # The Source (Read-Only)
āāā modern-app/ # The Target (The Greenfield Repo)
Dispatch subagents to produce specifications while identifying project-specific test scenarios for the Verification_Plan.md.
legacy-app/docker-compose.yml to include ports: ["27017:27017"] and restart the service.docs/verification/Verification_Plan.md: Create the baseline template using resources/verification-strategy.md.auditing-data-models -> Append Data Integrity Stress-Tests.auditing-api-contracts -> Append API Parity & Edge Case Probes.auditing-business-logic -> Append Logic & Authorization Stress-Tests.auditing-ui-archeology -> Append Interaction & Layout Verification Targets.scaffolding-nextjs-foundation to generate the base App.scaffolding-test-foundation to configure Vitest.generating-api-tests to convert API_Contracts.md into failing integration tests.scaffolding-data-layer to translate models into Native MongoDB/Zod types.scaffolding-api-routes to implement Route Handlers until tests pass.generating-database-seeder based on the Strategy decision.scaffolding-ui-and-pages to translate UI_Component_Inventory.md into ShadCN components AND complete Next.js pages.page.tsx implementation.auditing-parity to perform a side-by-side runtime check.adversarial-verification to probe for security and logic flaws.Parity_Adversarial_Report.md.legacy-app and modern-app.docs/) to be completed before starting the implementation phase.resources/verification-strategy.md: The master methodology for side-by-side verification.