01
What this skill does
Use this skill when code reading is not enough. It forces hypotheses, logging, reproduction, root-cause notes, and post-fix verification before cleanup. The bundled collector can capture browser or app logs into NDJSON and expose a same-origin dashboard for live inspection, then final cleanup removes collector artifacts and the root-cause document unless evidence retention is requested.
02
When to use it
- 01Frontend issues where browser logs need to reach an active collector directly.
- 02Runtime failures that are easy to guess about but hard to prove from static code.
- 03Flaky behavior that needs timestamped evidence and before/after comparison.
03
How it works
- 01
State precise hypotheses before instrumenting.
- 02
Attach to an existing logging session or start the bundled collector.
- 03
Add minimal temporary instrumentation tied to each hypothesis.
- 04
Reproduce the issue, inspect the recorded log file, and mark hypotheses as confirmed, rejected, or inconclusive.
- 05
Apply only proven fixes, then collect fresh post-fix logs before removing instrumentation.
04
What you get back
- 01A root-cause document that evolves during investigation and is deleted after successful final cleanup unless retained by request.
- 02Temporary instrumentation plus collector, log, and root-cause document cleanup.
- 03A verified fix backed by fresh runtime logs.
05
Important boundaries
- 01Do not ship speculative fixes without runtime proof.
- 02Do not create app-local proxy APIs for browser logs unless direct collector delivery is proven blocked.
- 03Keep root-cause documents through intermediate log clears, then delete them during final successful cleanup unless the user asks to retain evidence.
06