incremental-migration

Incremental Migration

Never attempt to migrate an entire codebase in a single step. Mega-commits are impossible to review and dangerous to merge.

Define the Target Pattern: Clearly establish the "Old Way" and the "New Way".
Implement Side-by-Side: Create the "New Way" implementation alongside the old one. Do not delete the old one yet.
Migrate One Vertical Slice: Pick exactly one feature, route, or component. Update it to use the new pattern.
Test and Commit: Verify the slice works. Commit this step.
Repeat: Move to the next slice.
Deprecate and Remove: Only once all usages of the "Old Way" are gone can you safely delete the old implementation.

If a migration is too large for a single session, leave a clear handoff.md summarizing progress and the next files to migrate.

Never attempt to migrate an entire codebase in a single step. Mega-commits are impossible to review and dangerous to merge.

Define the Target Pattern: Clearly establish the "Old Way" and the "New Way".
Implement Side-by-Side: Create the "New Way" implementation alongside the old one. Do not delete the old one yet.
Migrate One Vertical Slice: Pick exactly one feature, route, or component. Update it to use the new pattern.
Test and Commit: Verify the slice works. Commit this step.
Repeat: Move to the next slice.
Deprecate and Remove: Only once all usages of the "Old Way" are gone can you safely delete the old implementation.

If a migration is too large for a single session, leave a clear handoff.md summarizing progress and the next files to migrate.