Root causes · guides · ideas
Bug Casebook
From root causes and fixes
to guides and ideas that help you build.
Clues and fixes found in real development work, plus guides and ideas.
Field Notes
28 postsWhat to check, in order, when WiFi QR autofill comes back null in a local Windows web app
This isn't a finished implementation. It's a diagnostic order for figuring out where the null comes from. A local web app (formation) has viewer and reader page
When you launch one Python program but Task Manager shows two pythonw.exe processes — identifying Windows venv launcher stubs
I was building a personal voice assistant (voice-assistant) that stays running on Windows, transcribes speech when it hears a wake word, gets an answer from the
When a script works in Chrome but fails only in Whale: Cannot destructure property of undefined
On Android Whale only, the buttons wouldn't turn on after a video was selected. The problem went away after fingerprint.js was renamed to mediacheck.js and the
A WebSocket room host loses control after leaving and rejoining — restoring it with a localStorage token and a server-side hash
We were moving formation, a web app where one person (the leader) plays a video in a dance rehearsal studio while everyone else follows the same point in the vi
When a hidden-VBS Python script in Startup occasionally pops an error dialog and silently fails to launch only at boot
I was building a local voice assistant (voice-assistant) for Windows that stays running and answers when it hears a wake word. To get it to start without a wind
When an AI content pipeline keeps searching the web for nearly identical topics (filtering duplicates against published articles and within the same batch)
I was working on an automated content pipeline (content-loop-mvp) that picks topics, runs web research, writes articles, submits them for model review, and save
When your AI article pipeline passes its tests but produces zero articles, where do you start looking?
This post is about the order of diagnosis, not about a fix. I have a personal project that automatically generates IT troubleshooting articles in four stages: t
Installed Termux but can't see your Downloads folder? Start with storage permissions
I installed Termux (a terminal app for Android) to run formation, a web app for reviewing formations together alongside a video in a dance studio, on a single A
Sync the same video across multiple phones without a video server — relay only playback position over WebSocket and match files with a partial hash
Have everyone save the video to their phone ahead of time, and have the server use WebSocket to relay only the leader's play, pause and playback position within
When character-driven Shorts deliver neither information nor personality well: criteria for considering a move to blog posts
If both the information and the characters feel weak in Shorts, there's reason to test whether a written prototype gets them across better. This case ended with
If automatic audio sync keeps getting it wrong: the static screen that scene cut detection can't see
I was building personaverse, a pipeline that automatically produces Shorts videos of AI characters bickering about the day's news, all the way from script to re
If a Python import reads your own file instead of the standard library, check whether the file is named inspect.py
While scoring kept failing in an automated content pipeline (content-loop-mvp), I was writing a small diagnostic script to print per-criterion scores. The scrip
When launching Python with PowerShell Start-Process gives unrecognized arguments, but a bat file works fine
I was building a local voice assistant (voice-assistant) that stays running on Windows, transcribes speech when it hears a wake word, and reads its answers alou
I made a video by screen-recording with Playwright, and it has no sound at all
I was working on personaverse, a project where AI characters make Shorts videos. I was building a "VTuber" format that places a character cutout over a backgrou
When Playwright page.goto times out after 30 seconds — the networkidle trap
The rendering pipeline for personaverse, a project featuring AI characters bickering in short-form videos, opened HTML pages in headless Chromium and recorded t
Why does a square grid turn into rectangles when you draw it in 0–1 normalized coordinates?
I was building a web app (formation) for dance studios. Several people each watch the same choreography video on their own phones and line up formations and mov
When it only fails in a mobile browser (Whale) and you can't access the console — an on-screen debug panel with ?debug=1
I was building a video synchronization web app for a dance studio, where everyone watches their own copy of a video in sync with the leader's controls. To avoid
If users have to re-pick a local video on the next page
I was building a web app for dance practice (formation). Each person plays a choreography video they prepared themselves, and playback follows the leader's cont
When iPhone video sync keeps jumping and stays 0.5 seconds behind
We were building a web app (formation) for dance rehearsals: a leader's laptop plays a choreography video with music, while members use their own phones to foll
How to check hotspot connection limits before attaching multiple phones to a laptop server
I was building a web app called formation for dance studios. Everyone in the room follows the same choreography video on their own phone, kept in sync. A laptop
How to recover the original snap interval from coordinate data with no recorded grid size
In formation, a web app that overlays a grid on dance practice videos and lets users mark dancer positions at different times to edit formations and movement pa
Fixing a Durable Objects room list, alarm-based expiry, and a WebSocket headcount that ignored departures
Per-room state lives in a Room Durable Object (DO). The list of active rooms that participants pick from lives in a separate Lobby DO. Expiry is scheduled with
Connecting Claude Code to an Android tablet: where do you start with the voice assistant app?
This is a design discussion about moving a PC voice assistant—a Windows Python program that listens for the wake word hey_jarvis, passes a sentence to claude -p
When video uploads on Android only open Google Photos: accept doesn't filter files, it changes which picker opens
I was building a web app (formation) for a dance studio. Each person keeps the choreography video on their own phone, and everyone watches it together while the
Keeping the microphone on in an Android app: a pre-implementation checklist for boot startup and offline SpeechRecognizer
The plan was to move a personal voice assistant (voice-assistant), which listened for a wake word on a PC and read responses aloud, to an always-listening app o
When the Join button won't enable on Android Whale even after you pick a video
I was building a web app for dance studios. Several people play the same choreography video on their own phones so they can line up their moves. A leader create
When a short question to AI gets a long, off-target design explanation
We were building a synchronized web app (formation) for a dance studio: one leader plays a video, and everyone else connects on their own phone to follow along
A background process launched from Claude Code disappears seconds later — on Windows, it wasn't a bug but the agent shell cleaning up its processes
On Windows, I had an AI coding agent (Claude Code) try launching a program in the background, and every time, the launched process vanished after about 20 secon