# AGENTS.md — BotBaas huisregels

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).