Debugging Playbook

0•

Diagnoses and remediates automation pipeline failures using symptom-to-action routing and discriminating tests.

The Debugging Playbook provides a structured triage framework for browser automation and data extraction pipelines, mapping observed failure symptoms directly to underlying root causes, discriminating validation tests, and verified corrective actions. Rooted in real-world clinical automation incidents, it prevents false-pass conclusions through payload-reality checks, enforces data hygiene on protected volumes, and guides Claude Code through systematic troubleshooting of process isolation, DevTools protocol limitations, UI drift, and auth scope boundaries.

Key Features

010 GitHub stars
02Symptom-to-action decision matrix with discriminating verification tests
03Payload-reality checks to prevent false-pass reporting on fallback or marketing pages
04Data hygiene rules protecting sensitive or encrypted volumes during debugging
05Surface isolation checks ensuring test runs do not hijack the operator's active browser
06Pre-written bash verification snippets for byte-identity and clinical signal detection

Use Cases

01Troubleshooting silent failures and process-isolation traps in headless browser automation
02Validating captured payloads and documents against byte-identical fallback responses
03Enforcing systematic incident triage and gate controls in multi-agent automation pipelines