Writing Culture is Agent Infrastructure - sohail mohammad
Everyone's talking about AI replacing writers. But the orgs best positioned for AI agents are the ones with the strongest human writing cultures. i recently joined Amazon. Within a month, i had my first significant code change up. Within two weeks of adopting a new service, i was answering questions from people reaching out about how it works. Not because i'm some genius onboarder. Because the writing culture did the heavy lifting. The unfair advantage wasn't the tooling. It was the documentation. At previous companies, documentation was always a second thought. It was never given priority. The pattern was always the same: "okay let's now update the Confluence to account for the work we've done." But even then, it wasn't met with excitement, and it wasn't structured in a way that made it easy to parse out what the status or understanding of things are. It was broken up pieces of graphs and charts and fragments. At Wendy's, there wasn't much documentation at all. It was tribal knowledge
Everyone's talking about AI replacing writers. But the orgs best positioned for AI agents are the ones with the strongest human writing cultures. i recently joined Amazon. Within a month, i had my first significant code change up. Within two weeks of adopting a new service, i was answering questions from people reaching out about how it works. Not because i'm some genius onboarder. Because the writing culture did the heavy lifting. The unfair advantage wasn't the tooling. It was the documentation. The Problem: Docs as Afterthought ¶ At previous companies, documentation was always a second
Explore this link on the map →saved by
related reading
- The machines are fine. I'm worried about us.ergosphere.blog
- Building Effective AI Agents \ Anthropicanthropic.com
- Building Effective AI Agents \ Anthropicanthropic.com
- The end of "Just ask Sarah" — Simon Aronssonsimme.dev
- How Stripe Built a Writing Culture - Knock Down Silos by Slabslab.com
- After Automation | Everyevery.to
- Writing for LLMs So They Listen · Gwern.netgwern.net
- Best practices for using AI coding Agents | Augment Codeaugmentcode.com
- AddyOsmani.com - How to write a good spec for AI agentsaddyosmani.com
- Effective context engineering for AI agents \ Anthropicanthropic.com
- Thoughts on slowing the fuck downmariozechner.at
- Conversations on Human Culture in the AI Agejasmi.news