Documentation
README
Diagnosing Bugs
Start from evidence and adapt the depth of the investigation to the problem. Read relevant repository context and architectural decisions when they exist.
Establish a useful signal
Reproduce the reported symptom with the cheapest signal that distinguishes broken from fixed. A focused test or script is ideal when practical; logs, traces, snapshots, comparisons, or measured timings may be better for other failures. Tighten the loop by improving speed, specificity, and determinism.
If an exact reproduction is unavailable, continue with the strongest evidence available and state the limitation. Request an artifact, access, or temporary instrumentation only when it would materially improve the diagnosis.
This is the opening of the README. Read the full README on GitHub.