Documentation: Agentic Superpower

Coding agents have an overlooked superpower: documentation.

Their ability to write technical and product specs, design and update implementation roadmaps, write test plans, and even explain code effortlessly ... not only helps humans approve what the agents are planning to build, but helps the agents stay on track while building it.

One of the most important side effects of good implementation documentation is the ability for the agents to maintain larger and longer context windows (even across sessions). This helps the agents stay disciplined and focused as they proceed through complex multi-step coding tasks, validate that what they have built conforms to the overall specs, and makes code more manageable ... for both machines and humans.

We all used to hate writing documentation ... now it's one prompt away.

Carpe Diem.