Two majors, one README, one demo: two cheap design reviews

Writing the docs is what surfaced both mistakes. There’s a meta-lesson in there about how docs are the cheapest design review you can run…