Lab 05: Debug A Broken System
Practice debugging with evidence.
Use failure fixtures or take your ticket feature and intentionally add one bug:
- API returns wrong status code.
- Server accepts empty title.
- Database write fails.
- UI shows success even when API fails.
- Duplicate submit creates two tickets.
- Write the expected behavior.
- Reproduce the bug.
- Capture logs or screenshots.
- Identify the failing boundary.
- Write a failing test.
- Fix the root cause.
- Run the test again.
- Write a postmortem.
Debugging Map
Section titled “Debugging Map”symptom -> where did the request enter? -> where did it change shape? -> where did it fail? -> what evidence proves that?Artifact
Section titled “Artifact”Create debugging-log.md with:
- Symptom.
- Reproduction steps.
- Evidence.
- Root cause.
- Fix.
- Verification.
- Prevention.
Done When
Section titled “Done When”The postmortem names the root cause and includes proof that the fix works.