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?