← All posts

breaking changes

8 posts

|8 min read

What Is MTBBC and Why Your Team Should Track It

Mean Time Between Breaking Changes is the missing engineering metric for API-first teams. Here's how to calculate it, what good looks like, and how to improve it.

|6 min read

Vibecoding Is Fast. Breaking Your API Contracts Is Faster.

AI-assisted coding accelerates shipping but introduces subtle API contract drift that cascades across teams. Here's what's going wrong and how to catch it.

|7 min read

The Hidden Cost of Moving Fast Without API Contract Monitoring

Unmonitored API changes cost more than you think. Engineering hours, customer trust, partner churn, and on-call burnout compound with every incident.

|8 min read

The API Breaking Change Checklist Every Team Needs

A comprehensive reference of what constitutes a breaking API change — from field renames and type changes to status codes and authentication shifts.

|8 min read

How One Renamed Field Took Down Three Services for Four Hours

A realistic incident postmortem of a field rename that cascaded through a microservices architecture. The change wasn't wrong — it was uninformed.

|7 min read

API Versioning Won't Save You (Here's What Will)

Versioning is a release strategy, not a prevention strategy. By the time you need v2, you've already broken v1 consumers.

|8 min read

How GraphQL Schema Changes Break Clients (And Why Nobody Notices Until Production)

GraphQL's flexibility creates a false sense of safety. Removed fields, type changes, and required arguments all return 200 status codes — making breakage invisible to standard monitoring.

|8 min read

Protobuf Field Changes That Seem Safe But Aren't

Protobuf's wire compatibility rules give false confidence. Removed fields return silent default values, type changes cause truncation, and renamed fields break JSON serialization.