[mkovach]

> The way the LLMs write (Claude perhaps?) With short phrases separated by colons, commas, or full stops, is so poor and frustrating.

This is exactly why I keep a WRITING.md file alongside AGENTS.md or CLAUDE.md.

Most people spend time telling the model what to build, but very little time telling it how to write. LLMs are surprisingly good at following explicit style guidance if you bother to give it to them.

Mine includes conventions like avoiding unnecessary colons, em dashes, and sentence fragments masquerading as emphasis. Basically, AI-isms and any grammatical errors I tend to make. It also points to writers whose technical prose I admire. Brian Kernighan and Rob Pike are great examples: clear, conversational, and readable without trying to sound important. I've always tried to do two things with documentation: 1) Make it readable and 2) Make people want to read it. A WRITING.md file helps with both points.

If you're generating documentation regularly, it's worth having your agents reference a WRITING.md file. The improvement in readability is often much larger than any gain you'll get from switching to the latest model, and it can keep your documentation consistent between model switches.

[RugnirViking]

Willing to share your writing.md somewhere? pastebin or the like? I'd love to take a look at how different people are doing this.

I disagree with the person below - I don't think its a wrongheaded goal in and of itself to get better ai generated writing. I read ai output half of my day, I may as well try and make it better for my own sake. Passing that onto other people is an entirely unrelated field of problems, and passing it off as stuff you authored yourself is just plagarism.

[mkovach]

Here is a sample I am using for testing on a personal project (I'm also working on using SpeechActs to do prompting, so yes, the repo is all AI-generated).

https://f.mek.cc/gombasic/file?name=WRITING.md&ci=tip

And in many cases, like you, I spend a good amount of time reading AI documentation. I'm not "stealing" anything, just having a model generate words in a specific way. I'm just being precious in how I want things, without having to do it myself.

[Marha01]

There is also Humanizer:

https://github.com/blader/humanizer

[Planktonne]

Making a problem harder to sport is not a way to fix it.

[mkovach]

I understand what you are saying, but inside the repo, I'm making it explicit.

I'm not trying to hide the problem, just offering a solution that people may find useful, or curiously odd.