Go Troubleshooting

Diagnosis before fixes. Reproduce, observe, localize, then change code. Never "fix" a symptom you haven't explained — the bug will move.

Detailed reference material, loaded on demand:

• references/methodology.md — the debugging loop, tracing callers before blaming code, git bisect, red flags in your own reasoning.
• references/flaky-and-build.md — reproducing flaky tests and their usual causes; build, module and toolchain errors with their fixes.
• references/common-bugs.md — symptom → bug → fix tables for the Go bugs that compile cleanly and misbehave.

Read a reference file only when the summary below is not enough.

0. Method