Yet the README is generated ("Two skills maintain the boundary in both directions.") and the demo is .. a Mobius strip?

I'd prefer if you explain what it is you are building in the form of human-written text.

Well, if they're consistent, the ADR directory contains only human written text that drives the underlying development... Aaand it's empty. Well.

I personally would probably have the readme generated based on that directory as the primary document, probably with another `readme_generation_rules.md` in the ADRs directory, and I would be pretty ruthless about disallowing all the slop-adjacent wording.