This is a little inevitable when working with (internal) binary protocols. You have some bits that used to be used as one thing, haven't been used for that thing in awhile, and it can be very tempting to just repurpose those old bits for new tricks.
In that case I'd call the sin deprecating and reusing in a single step. If you have to change the meaning of bits in a binary protocol, you should deprecate the old meaning, wait several release cycles, and then repurpose it after you're very, very confident that there are no remaining clients or servers in lurking around production with the old meaning, and that you won't need to roll back production to the old state ever again.
Roll-out failures like this happen all the time; you have to roll-out new changes almost assuming they will happen.
Either way, it shows some attempt at longer-term thinking undone by short term implementation done improperly. That’s a microcosm of this story as a whole which gives this incident a fractal quality.
A hard lesson to learn, and a hard rule to push for with others who have not yet learned.
Imagine what our species could do if experience were directly and easily transferable...
Same goes for functions, classes, React components, DB tables and everything else.
Just model it as close as possible to the real world. The world doesn't really change that often. What does is how we interpret and behave within it (logic/behaviour/appearance on top).
If you have a Label and Subheader in your app, create separate components for them. It doesn't matter that they look exactly the same now. Those are two separate things and I guarantee you more likely than not at some point they will differ.
My rule of thumb is: If it's something I can somehow name as an entity (especially in product and not tech talk) it deserves to be its own entity.
"The new RLP code also repurposed a flag" - this is the moment when terrible software development idea was executed that resulted in all of the mess.
Of course I don't know the full context and maybe, just maybe there was a really solid reason to reuse a flag on anything.
What I observe more often is something like this though:
If you have an use case A, create a handle_a flag. If you have a use case B create handle_b flag even if they do exactly the same thing as more than likely they do exactly the same thing only for now.What would probably be even better is separate, properly named config flags for each little behaviour change and just use all 5 of those to handle different use cases.
edit: formatting