Record the starting point
Write down the exact symptom, time, application version, and a minimal example. Leave out passwords, cookies, and URLs with embedded tokens. A clear starting point distinguishes a new failure from the old one.
## Symptom
What failed, when, and with which version?
## Hypothesis
What observation would disprove it?
## Check
Command, expected result, actual result.
## Outcome
Cause, change, verification, remaining questions.Change one variable
Choose a check that could disprove each hypothesis. Repeat the same command after a change and record the result. Several simultaneous edits obscure the reason for success.
Leave a reproducible conclusion
Finish with the cause, the precise change, and a way to verify it. If the cause remains unknown, say so. This is more useful than a confident explanation without evidence.