Rewrites promise a clean slate and usually deliver a long freeze. Incremental replacement is slower to describe and faster to benefit from.

An API is a promise you keep for years. A handful of early choices decide whether it stays workable as consumers multiply.