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.

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 werktDat 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.
Kijk in je mailbox
0 waarderingenNog 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 inNog geen reacties. Wat neem jij mee?