AI-tips #11: Les ruta før du bruker den
Vi lagde en liste over inviterte brukere i en ny funksjon. Claude brukte endepunktet /api/users/:id og antok at det hentet brukeren med den id-en. Det er jo slik REST pleier å fungere. Hos oss ser ruta ikke på id-en i det hele tatt, den returnerer alltid den som er logget inn. Lista viste feil person, og det oppdaget jeg først da jeg testet det live.
I CLAUDE.md står det at Claude aldri skal gjette feltnavn eller API-endepunkter. I den globale CLAUDE.md-en min står det i tillegg: «make sure you are correct. Iterate until you are confident. And do not guess!»
Slik sjekker Claude en rute hos meg:
- Les selve handleren før du skriver et kall mot den. Navnet på ruta er ikke nok.
- Sjekk hvilke parametere den leser, hva den returnerer og hvem som har lov til å bruke den.
- Sjekk feltnavnene i skjemaet. Hos oss heter det feks cellphone og ikke phone, postalcode og ikke zip, og place og ikke city.
- Et nytt felt må inn tre steder: i skjemaet, i API-et og i lista over felt som sendes tilbake. Glemmer du den siste, lagres feltet, men det kommer aldri med i svaret.
Jeg anbefaler derfor å skrive regelen inn i CLAUDE.md, sammen med de feltnavnene som er lettest å gjette feil i ditt prosjekt. Det er hele tipset.
Har du en rute som ikke gjør det navnet lover? Del gjerne i kommentarfeltet.