alinafe82 Debugging Lab Notebook
Turn hard debugging into a recorded experiment loop instead of a sequence of guesses.
Scope
Use for the task in the description. For example: Investigate a worker that intermittently drops messages under concurrency. Do not activate for: Fix this parser assertion with an already-isolated deterministic regression.
Workflow
- Build the smallest available reproduction or observation signal.
- Write competing hypotheses.
- Add instrumentation that distinguishes between hypotheses.
- Run one experiment at a time.
- Record negative findings.
- Add regression proof after the fix.
Evidence
Symptom and reproduction attempt. Logs, traces, metrics, failing command, or user report if available. Code area or workflow likely involved. Report the outcome with relevant reproduction, hypotheses, experiment, result. Adapt the format to the task; omit empty fields. Never claim checks ran without observed results.
Boundaries
Do not expose raw production logs, tokens, customer data, internal hostnames, or private incident details. Remove exploratory instrumentation unless it is intentionally kept. Continue authorized read-only and reversible local work through the requested outcome. If evidence is missing, inspect available sources before asking; report limits honestly.
References
For worked examples, open simple or edge case only when useful. Routing cases record positive and negative activation examples for review; they are not a model benchmark.