Mixed
improving the docs let us use smaller models and get better quality work out of them
bunderbunder on Hacker News
In the thread “The Decoherence Trap”, replying to this comment
Helped: Improving written documentation and replacing skill files with Markdown.
Got in the way: Models still make a mess of code and documentation.
… I've been experimenting with improving coding agent performance by improving written documentation. Anecdotally I've seen that, compared to the vibecoded mess I inherited, improving the docs let us use smaller models and get better quality work out of them. Replacing our skill files with Markdown documentation also made a difference. …