Buglyst Blog
Learn to debug under pressure.
Playbooks for fast pattern recognition, guides for the full investigation, and articles for the engineering judgment around the edges.
17 playbooks · 509 guides · 95 articles · 12 linked practice labs ·skip to practice
Fast pattern recognition for the production failures engineers see most often.
0 playbooks in Debugging Craft
No playbooks found
Nothing matches “”. Try a broader term.
Structured investigations for the failure modes engineers meet in real systems.
Diagnosing Missing Cookies in Nuxt SSR Server Context
Nuxt SSR often fails to read cookies server-side if headers are misrouted or missing. This guide shows where things break and how to reliably retrieve cookies in SSR.
Node.js Inspector Debugger: Diagnosing Protocol Disconnections and Async Breakpoints
A practical guide to debugging Node.js with the inspector protocol—covering disconnections, async stacks, and breakpoint failures.
Java Thread Deadlock Detection with jstack: A Practical Guide
Learn how to detect and fix Java thread deadlocks using jstack. This guide covers real-world patterns, command-line usage, and common pitfalls.
Spring Boot Auto-configuration Not Loading: Debugging Conditional Beans
A hands-on guide to debugging Spring Boot auto-configuration failures caused by missing or mismatched conditions, with concrete commands and real-world war stories.
Spring @Transactional Not Rolling Back: Root Causes & Fixes
A senior engineer's guide to why Spring @Transactional fails to roll back — covering checked exceptions, proxy bypass, and connection commit ordering.
Spring Boot Application Startup Failure: A Practical Debugging Guide
A concise guide to diagnosing Spring Boot startup failures with concrete commands, logs, and root causes.
Long-form thinking on debugging habits, observability, and the systems around the bug.
Debugging Timezone Date Bugs: A Case Study in UTC vs. Local Time
A practical walkthrough of a timestamp bug that broke a billing system, with reproducible code and debugging tactics.
Floating Point Arithmetic Errors: A Debugging Postmortem
How a $0.0000000000000004 error silently corrupted a financial system, and the debugging techniques that caught it.
Why JSON.parse() Throws and How to Catch It: A Field Guide to Parsing Failures
JSON.parse() seems simple until it throws. Here's a practical guide to the most common — and most maddening — parsing failures I've encountered, with exact error messages and fixes.
Blameless Postmortems: How We Fixed Root Causes Without Firing Anyone
A practical guide to running postmortems that focus on systemic failures, not individual mistakes. Includes a real incident breakdown from a production database outage.
Pair Debugging: How to Debug Together Without Killing Each Other
Pair debugging sounds great on paper. In practice, it's easy to step on each other's toes, go silent, or fight over the keyboard. Here's how to make it work.
Debugging with AI Tools: What Worked and What Didn't in Production
After a year of using GPT-4, Copilot, and Claude to hunt production bugs, here's what actually helped — and what sent me down dead ends.