Day 8: I Started Writing Documentation for My AI Teammate

On day 5 of my new job, I got Claude Code. On day 8, I started writing documentation specifically for AI — not README, but LLM.md. On day 14, my first PR landed and surprised my teammate, but two weeks later he was writing his own LLM.md, and even drafted a "documentation of documentation" to standardize our practice. This talk shares the 60-day story of how a Kotlin / Android team developed a dual-track documentation system: README for humans, LLM.md for AI. We'll cover why AI needs different documentation, how the system evolved, how individual practice became team norms, and the real costs and limitations of this approach. The practice comes from an Android team, but the concepts apply to any JVM project.