Laat je agent de handleiding schrijven voor je uitrolt

Vroeger was documenteren een klus die je uitstelde tot het nooit meer gebeurde. Je moest alles zelf uitschrijven, en dat deed niemand graag. Vandaag hoeft dat niet meer. Je zegt gewoon tegen je agent: voor we deployen, schrijf de documentatie.

Ik zou die vraag op een vast moment stellen, net voor je iets live zet. Dan weet je agent nog alles, want hij heeft het net gebouwd. Hij kent de structuur, de keuzes en de stappen om het te installeren. En dan schrijft hij dat op in gewone taal, in een Markdown-bestand.

Op GitHub zie je dat mooi. Zet je een README in je repo, dan staat die meteen op de homepage van die repo. Wie de repo opent, leest dus eerst wat de tool doet. Bij die organisatie stonden daar de tools zelf, de volledige structuur en een handleiding om alles te installeren. Zo konden de mensen intern er makkelijk zelf mee aan de slag.