What makes a great quantum circuit README?

After rewriting 50 READMEs, I settled on 4 layers:

1. Intuition — the physical picture, no equations
2. How it works — what each gate does to the state
3. The math — state evolution for those who want proof
4. Expected output — what you should see when you run it

Each layer for a different reader: beginner → student → physicist → experimenter.

Most READMEs I've seen only have layer 2. Which do you skip to first?

#QuantumComputing #LearningInPublic