Sjabloon, een README die je opvolger en zijn agent snappen

Je tool werkt, en je wil hem live zetten. Alleen staat de uitleg nog in je hoofd, en verspreid over een chat van vorige week. Dit sjabloon geeft je agent een vaste vorm voor de handleiding: een README in Markdown. En je krijgt de prompts erbij om hem te laten invullen. Daarna test je hem met een agent die je tool nog nooit gezien heeft. Reken op een kwartiertje, in de sessie waarin je de tool gebouwd hebt.

Cartoon

Het geraamte van een goede README

Je hoeft niet bij nul te beginnen. Een README die werkt, beantwoordt de vragen die een nieuwe collega je anders zou mailen. En die vragen zijn verrassend voorspelbaar. Dit zijn de kopjes die ik zou gebruiken.

# [Naam van je tool]
## Wat het doet en voor wie
## Wat je nodig hebt
## Installeren en starten
## Hoe het in elkaar zit
## Instellingen en toegangen
## Wat het niet doet
## Bekende beperkingen en open vragen
## Voor de agent die hieraan verder werkt

Dat laatste kopje lijkt misschien wat vreemd. Toch wordt dat stuk waarschijnlijk het vaakst gelezen. Je opvolger vraagt zijn AI om iets aan te passen, en die AI begint met lezen.

Als member krijg je hieronder het volledige sjabloon, met per kopje wat erin hoort. Daarbij zit de prompt die je agent het laat invullen. En je krijgt een test met een verse agent, die laat zien of je README echt werkt.

Lees gratis verder

Registreer gratis met je e-mailadres en lees verder. Met je account open je de gratis artikels in de leerruimte; de rest is voor abonnees, vanaf Learn Plus.

Al geregistreerd? Nog geen account?

Nog geen reactiesLees de reacties

Reacties

Leden reageren hier en lezen elkaars reacties. Registreer gratis of log in om mee te praten.

Registreer gratis of log in

Nog geen reacties. Wat neem jij mee?

    QR-code van deze pagina

    coachsteff.live/toolkit-sjabloon-readme

    Scan met je telefoon om de pagina te openen.