🗺️ Backend Engineering · Journey Playbooks
Playbook: Ship an API v2 safely
Introduce breaking API improvements while every existing client keeps working.
journey~80 minBackend EngineersAPI DevelopersPlatform Engineers
Journey Steps
- 1Step 1 — Migrate API versions without breaking clients: start with "Ship vN+1 alongside vN behind the same gateway; no big-bang cutover"
- 2Step 2 — Run zero-downtime schema migrations: start with "Expand: add nullable columns/tables first; deploy code writing both paths"
- 3How it fits together: Expand-contract thinking applies to both schema AND endpoint surface. Parallel-run is the whole game.
Commands
Install all referenced skills
$ npx skills add aniruddhaadak80/skills --skill api-design-api-versioning-migration && npx skills add aniruddhaadak80/skills --skill databases-zero-downtime-migrationsTags
#playbook#journey#backend-engineering