Skip to content

v1.85.0 ·

The blog sounded like nobody wrote it

My name is on every post on this blog, and in my own words most of them were "very complicated to understand and a lot of AI slop."

They were not written. They were assembled. A release took the problem section from its requirements, a paragraph about the options, and the "what shipped" section from its deployment record, and glued the three together under fixed headings. None of those sections were written for a stranger. The 80 posts on the site had 894 em dashes between them, which tells you most of what you need to know about how they sounded.

What changed

There is now one file that says how a post should sound: .aidlc/guidance/blog-voice.md. It is ported from the skill I already use for posts on my own site. First person, short paragraphs, say what it cost and what broke, no em dashes, and a list of the tells that make text read as generated. It also says every number and name in a post has to come from the repo. If the writer cannot find a source, the claim goes.

Every feature or bugfix release now writes its whole post body with it, in Deployment, autopilot included. The generator stopped assembling. It wraps the body with the release card and that is it.

Fewer checks, not more

The old path had to find the right sections in two files, refuse a section that was more than a quarter table rows, and refuse one with an amendment heading. All of that existed to police text nobody wrote for readers. A body written as a post skips all of it.

What stays is what stops wrong facts and broken pages. The content guard still refuses a post that leaks a local path, an account ID or a token, or names a file that does not exist. The body is still escaped and compiled as MDX before it is written. The cost and the date still come from the tools, not the writer.

What it does not do yet

Four old posts are rewritten as a sample: the newest one, one bugfix, one feature and one release that shipped three things at once. Their URLs, dates and costs did not change. The other 76 still read the old way. I want to read the four before an agent rewrites the rest in a tone I might not like, so that work waits on me.