Two silhouettes in conversation with golden speech bubbles and code flowing between them

Dialogue driven development: when code becomes the documentation

Twenty-five years ago, extreme programming made a bold promise: code should be the documentation. Good idea. Didn’t work. Humans can’t efficiently parse 50,000 lines of code to understand what a system does and why. So we kept writing design docs, architecture diagrams, and specification documents – and they kept going stale. AI changes that. An agent can read an entire codebase and produce a feature summary that’s more accurate than the design doc written six months ago, because it reflects what actually exists. The XP promise is finally landing – just not the way anyone expected. ...

April 8, 2026 · 7 min · Ilkka Anttonen