Debugging playbooks.
Concise playbooks for common root-cause patterns. Each links back to ready practice incidents where possible.
Before your first open-source PR
How to read unfamiliar repos, reproduce failing tests, trace a fix commit, write a PR-style explanation, and avoid claiming fake contributions.
Open playbook →Debugging Env Var Issues
A concise checklist for incidents where local works but CI, staging, or production changes behavior.
Debugging Cache Stampedes
How to recognize and contain request spikes when cached data expires.
Debugging CORS Origin Bugs
A practical way to inspect origin parsing, credentials, and header behavior.
Debugging Retry Bugs
Retry issues often hide the first failure and create duplicate work.
Debugging Timezone Bugs
Time bugs usually live at day boundaries, DST changes, and unit conversions.
Debugging Pagination Bugs
Pagination bugs hide in boundary math, cursor reuse, and new records arriving between pages.
Debugging Stale Locks
Stale locks turn a previous failure into a new outage.
Debugging Tenant Cache Bugs
Tenant cache bugs are both correctness and security incidents.
Debugging Idempotency Bugs
How to debug duplicate writes when clients, webhooks, or workers retry after ambiguous failures.
Debugging Distributed Locks
A checklist for stale locks, duplicate workers, TTL drift, and clock-skew ownership bugs.
Debugging Transaction Rollback Issues
How to find partial writes when multi-step database workflows fail mid-request.
Debugging Queue Consumer Failures
How to debug missing retries, duplicate workers, and failed jobs that vanish from queues.
Debugging Deployment Config Bugs
How to debug incidents where the source is deployment wiring rather than application logic.
Debugging Observability Bugs
How to fix telemetry paths that hide failures, crash jobs, or create new production risk.
Debugging Database Consistency Bugs
How to trace query consistency issues across repositories, replicas, and API response contracts.
Debugging Payment Races
How to reason about duplicate charges, concurrent refunds, and payment workflow compensation.
Debugging Performance Backpressure
How to diagnose resource exhaustion in streams, queues, and hot paths.