Version or phase in incompatible changes.
Section: Anti-patterns
Do not ship breaking changes silently
text
text
Avoid removing fields or changing meanings without deprecation and migration guidance.Explanation
Silent breaking changes erode trust and create hard-to-debug production failures for clients.
Learn the surrounding workflow
Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.
Related commands
Same sheet · prioritizing Anti-patterns
Verbs in CRUD endpoints
Avoid route names that duplicate the HTTP method.
Do not expose raw database internals
Keep API models stable and intentional.
Keep response contracts consistent
Use the same top-level response structure across endpoints.