Dialogue driven development: when code becomes the documentation

Wed, 08 Apr 2026 00:00:00 +0000

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.

Development on Musings about technology

Dialogue driven development: when code becomes the documentation