Route Conversion

Convert a specific page from pages/ directory to app/ directory, handling data fetching migration, metadata extraction, and file structure changes.

Iron Law

ONE ROUTE AT A TIME. VALIDATE BEFORE MOVING ON. DELETE THE OLD FILE.

Every route follows the full cycle: analyze → convert → validate → delete old file → build. Skip a step? You'll ship broken code. "I'll validate later" means "I'll debug for hours later."

Prerequisites:

• REQUIRED: Run migration-assessment first if this is the start of a migration. No exceptions — even "simple" codebases have hidden blockers.
• REQUIRED: Ensure app/layout.tsx exists before converting any route. If it doesn't, convert pages/_app.tsx + pages/_document.tsx first.

Toolkit Setup