Migrating Legacy Apps to Next.js with Claude Code

Over the past year I migrated a handful of legacy projects to Next.js with Claude Code. Along the way I settled on a workflow that keeps working: two agent spec files for architecture and admin UI conventions, one migration prompt, then a Playwright and pixel-diff loop to eliminate the visual regressions left after the first pass.