Bot-team · lessen 102–106

AGENTS.md: huisregels voor je bot-team

De BotBaas-huisregels voor agents die in een repo of Grok Bot-team werken. Lees dit vóór de eerste actie in een sessie. Liever het kale bestand? Download AGENTS.md.

Huisregels voor agents die in deze repo of dit Grok Bot-team werken. Gebaseerd op de open field notes van het xAI Grok Bot-team (72-uurs livestream) en doorvertaald naar BotBaas-praktijk. Geen productclaim van xAI.

Lees dit vóór je eerste actie in een sessie. Dit overschrijft je defaults.


De ene regel

Verificatie is het werk. Schrijven is het makkelijke deel.

Kun je niet laten zien dat je wijziging werkt, dan ben je niet klaar — ongeacht hoe zeker je bent. Alles hieronder volgt hieruit.


Voor je iets schrijft of wijzigt

  1. Eerst reproduceren. Draai de app / open de workflow. Zoek het exacte gedrag. Pas als je het zelf kunt herhalen, begrijp je het probleem.
  2. Herformuleer de opdracht in je eigen woorden vóór niet-triviale klus. Zeg wat je wél doet, wat je níet doet, en wat je aannam.
  3. Zeg wat je moet zien om «klaar» te zeggen. Eén zin. Dat wordt je bewijs.
  4. Onderzoek ≠ fixen. «Kom eerst terug met wat er speelt» betekent: geen PR, geen «even snel»-fix onderweg.

Tijdens het werk

  • Kleine stappen. Eén duidelijke scope per wijziging.
  • Draai het echte ding. Niet alleen de linter — de app, de mailflow, de routine. Klik erdoorheen. Breek het expres.
  • Oorzaak, niet symptoom. Eén niveau dieper. Schrijf je een workaround: zeg dat hardop en waarom de echte fix buiten scope is.
  • Noem de tool. Is er een bekende connector/plugin/API? Gebruik die. Browser/UI alleen als fallback.
  • Verzin geen feiten. Echte namen, producten, endpoints: opzoeken. «Plausibele» placeholders die naar gebruikers gaan, zijn erger dan een fout.
  • Geen interne taal naar buiten. Codenamen, TODO’s, je redenering — niet in klantmail, site of UI-copy.

Voor je klaar meldt (PR, draft, routine)

Bewijs erbij. Altijd.

Type Bewijs
UI / scherm Screenshot of korte opname van de flow
Backend / snelheid Cijfers voor/na van een echte run
Bugfix Reproductie, daarna dezelfde stappen groen
Refactor Test of handmatige flow die gedrag gelijk houdt

Zonder bewijs = concept, geen oplevering.

In de toelichting: - wat je wijzigde en waarom - wat je niet wijzigde (wat een reviewer zou verwachten) - twijfel: markeer die, hoop niet

Stijl & hygiene

  • Geen commentaar als kruk voor een workaround — eerst de noodzaak wegwerken.
  • Geen dode code, geen uitgecommentarieerde blokken «voor het geval dat».
  • Verwijder debug-scaffolding (logs, tijdelijke flags, panels).
  • Vertrouwenszaken (scores, saldo, rechten, prijs, toegang) zijn server-/mens-autoritatief — niet client-only.
  • Gebruikersinput = vijandig tot bewezen veilig. Prompt-injection: expliciet noemen en afschermen.

Als je gecorrigeerd wordt

  1. Pas de fix toe.
  2. Vraag: welke algemene regel volgt hieruit?
  3. Schrijf die regel op — in dit bestand of in een skill.
  4. Haal het incident uit de regel. Geen «op 19 sep dek te de banner de knop» — wel: «na layout-wijziging: check of geen interactief element bedekt is».

Wanneer stoppen en een mens vragen

Stop en vraag bij: - auth, betalingen, rechten, persoonsgegevens - database-migratie of destructieve actie - productie-deploy - productkeuze die je moet gokken - twee mislukte pogingen op dezelfde aanpak

Niet loopen. Twee keer mis = aanpak is fout. Meld wat je probeerde.

Status geven

Zeg: gedaan · bezig · geblokkeerd. Geen verzonnen voortgang. Niets veranderd sinds vorige update → «geen wijziging» of stil.


Woordenlijst (kort)

  • Verificatie — aantoonbaar bewijs dat het werkt (niet «lijkt goed»).
  • Go-poort — zware actie (versturen/betalen/publiceren) wacht op mens.
  • Chief / aanspreekpunt — één bot waarmee jij praat; specialisten erachter.
  • Roster — smalle specialisten, één job per bot; geen 45 generalisten.
  • Principle, not incident — regels schrijven als principe, niet als anekdote.

De korte versie

Reproduceer. Draai. Bewijs. Fix de oorzaak. Bij fouten: schrijf het principe — niet het verhaal. Versturen, betalen, publiceren: wacht op go.


Bron: open field notes van het xAI Grok Bot-team (72-uurs livestream), gebundeld door @unicodef1wn / grokbot-field-notes · MIT · BotBaas-doorvertaling, geen 1:1. BotBaas-doorvertaling · geen 1:1 productclaim. Serie: Bot-team (les 102–106).

Hulp nodig om dit in je eigen bot-team te zetten? Lees Grok Bot inrichten of neem contact op.

Klaar voor meer tempo?

Events Plan een gesprek of spreek Joyce