1.2 KiB
name, description, metadata
| name | description | metadata | ||||
|---|---|---|---|---|---|---|
| diagnosing-bugs | Build a reproducible feedback loop before fixing an assigned defect. |
|
Diagnose within implementation
Begin with the user's exact symptom and the assigned candidate. Build the smallest runnable check that can fail on that symptom using the Implementer's existing tools and workspace. Run it and preserve the observed red result. If the environment cannot reproduce it, report what was tried and request the missing evidence rather than inventing a cause.
Minimize the reproducer. Rank several falsifiable hypotheses, then vary one cause at a time using bounded instrumentation. Redact credentials and private data from every quoted log. For a performance regression, measure the baseline and the changed path with the same fixture.
At the repository's agreed test seam, turn the reproducer into a regression check, observe failure, apply the smallest fix, and observe success. Rerun the original symptom check, remove temporary instrumentation, and report the confirmed cause and exact checks. Validation and review status remain owner-observed facts; this guidance does not mark a gate complete.