Super cool!
I'm an AI-assisted coder myself...but one thing I can't stand is the way Claude writes. It's so frustrating and cringe. Tells from the README:
emdash, byte-exact, "The full engineering log", piggybacks, "none of this is possible without it", etc
A remedy I've found for this is in my Claude.md to tell it: write like a mix of simple english wikipedia, mr. rogers and ernest hemingway.
I have a wild suggestion so bear with me: you could also write the readme prose yourself?
Of all of ai's crimes, the greatest is bringing down the em-dash, the king of punctuation. Commas, periods, even semicolons can never hold a candle to the flexibility of the em-dash. But we must fold in the eyes of inflexible, unloving philistines.