Writing
4 entries
-
Part 2 — The Handoff (From the AI's Point of View)
The second part of a documentation experiment, written from the AI's perspective. GPT inherits a codebase cold, reads the principles doc, and uses it to constrain a feature decision — validating the thesis that the right documentation shapes choices, not just describes code.
-
What's Left When the Code Becomes the Source of Truth
I wrote 786 lines of documentation, then deleted 83% of it. Here's what survived — and why it's the only documentation that matters.
-
AI Can Explain Your Code. Stop Documenting the Obvious
AI can now explain what a system does and how it works. That changes what documentation is for — and what's still worth writing down.
-
Avoiding the AI Tell: How to Write in a Way That Sounds Like You
The "You're not X, you're Y" pattern is everywhere in AI-generated writing — punchy, rhythmic, and a dead giveaway. This post identifies the tell and offers four concrete rewrites to keep the impact without the polish that signals AI.