In the studioZen — a little more clarity for ambitious work
sico studio®
Open workspace
← Skills library

zen-diagnose / Reference

View source

Diagnosis worksheet

Capture: symptom; expected behavior; trigger; version/environment; baseline evidence; hypotheses and distinguishing observations; experiment; actual result; cause; correction; original reproduction after correction; regression results; remaining uncertainty.

Example investigation:

HypothesisDistinguishing observationResult
Browser sends twiceSame command ID in both deliveriesRepeated transport is expected
Writer allocates twiceTwo record IDs for the same operation keyConfirmed at writer boundary
UI duplicates one recordOne file/ID, two displayed rowsNot observed in this experiment

Create a bug TSK if implementation is not already assigned. Include the reproduction and acceptance criterion, not only the proposed fix. Use LOG/DOC for the evidence packet and RDT for a substantial unresolved investigation. Preserve failed output and timestamps.

When reproduction is unavailable, say exactly which boundary could not be exercised, why, and the next safe experiment. Do not replace a missing real-provider observation with a fixture success claim.