roll-debuglisted

# Roll Debug Web debugging tool that treats the **Black Box (BB) as a diagnostic probe** — mounted when needed, unmounted when done. Combines diagnostic collection, analysis, and auto-repair into a single workflow: **Mount → Collect → Analyze → Unmount → Auto-Fix (when fixable) → Re-verify**. ## Philosophy - BB is a **diagnostic probe**, not a product feature. Pages do not need to integrate BB natively. - For any web diagnosis, **mount BB first** (unless already present). - The entire lifecycle is **explicit and visible**: you see when BB mounts, when it collects, and when it unmounts. - A visible **BB button** appears on the page during diagnosis so you always know the probe is active. ## When to Use - "Debug the page" - "See what's wrong" - "Page shows blank" - "Feature not working" - User uploads a diagnostic file (`diagnostics-*.json`, `bb-report.json`) - "Analyze BB data", "look at the diagnostic file" - Any scenario requiring web page diagnosis ## When Not to Use - Non-web environments (CLI tools, backend-only services) — outside this skill's scope - Scheduled production sampling / acceptance checks (use `$roll-sentinel`) - Pure source-reading without runtime reproduction ## Quick Start ```bash # Full workflow: mount + collect + analyze + unmount (recommended) $roll-debug https://example.com/page # Collect data only, skip analysis $roll-debug https://example.com/page --no-analyze # Skip BB mount, use built-in universal collector $roll-debug https://example.co