Parallel change (or expand, migrate and contract)



Introduce new functionality by adding new code instead of changing existing code. If you are expanding a class or an interface, introduce new methods instead of changing existing ones. If the behavior from the outside is similar and only implementation changes, duplicate existing tests and point them to new code, leaving the existing tests untouched. Make sure tests for existing code are still working.

Implement new functionality starting from the tests, either by writing new tests or by adapting duplicated old tests. Make sure to write new code using TDD practices. Once all new functionality is implemented, move to the migration step.


Deprecate old code and allow clients to migrate to new expanded code, or change client code to point to new code.


Once all client code is migrated to new code, remove old functionality by removing deprecated code and its tests.