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.
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.
I think Em dash fans are quitters ⸻ there are much longer dashes in Unicode they can use.
I'm a big fan of semicolons; they don't get used enough.
For me - I forgive an em-dash, but it does make me more skeptical of the other tells of AI-written text. If I start to see those other tells I do start to get a bit annoyed.
I have a wild suggestion so bear with me: you could also write the readme prose yourself?
It's not the readme that gets me. It's the damn "chasing loc" KPI in the industry that continuously drives Claude to spout entire essays of docstrings and comments that make code unreadable that infuriates me!