Hvordan får du en AI-assistent til å følge prosjektets kodestandarder?

Question

Accepted Answer

En AI bruker som standard et generisk gjennomsnitt av treningsdataene sine, så for å få **din** stil må du **vise og håndheve** den — gjennom eksempler, en eksplisitt regelsfil, og en linter-løkke som fanger opp det som glir gjennom. Ikke stol på at den gjetter standardene dine (WordPress Coding Standards, PSR-12, osv.).

## Teknikker (i rekkefølge etter effekt)

- **Oppgi linter-konfigurasjonen og eksempler** — lim inn `.eslintrc`, `phpcs.xml` eller `.editorconfig`. Dette er reglene i maskinlesbar form, og AI-en kan lese dem.
- **Hold en regler/instruksjonsfil** — en `CLAUDE.md` eller system-prompt som oppgir standarden eksplisitt: "Dette prosjektet følger **PSR-12**. Bruk 4-mellomrom innrykk, krøllparenteser på neste linje for funksjoner, snake_case for hooks." Stående instruksjoner er bedre enn å gjenta deg selv i hver prompt.
- **Vis representativ eksisterende kode** — en eller to rene filer lærer navngivning, struktur og idiomaer raskere enn noen beskrivelse. AI-en pattern-matcher det den ser.
- **Kjør linter på AI-utdata og send tilbake feil** — det mest pålitelige steget. Linteren er kilden til sannheten; lim inn feilene dens og be AI-en om å fikse dem.

## Linter-løkken

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

Denne løkken konvergerer raskt fordi linteren gir presise, linje-nivå tilbakemeldinger som AI-en kan handle direkte, i stedet for at du skal beskrive stilen i prosa.

## Hvorfor det betyr noe

Kode som ignorerer prosjektkonvensjoner skaper **review-friksjon og inkonsistens** selv når den er funksjonelt korrekt — reviewere sløser tid på formatering, og kodebassen glir av. En AI har ingen bevissthet om din husstil med mindre du oppgir den, så jobben er å gjøre reglene **eksplisitte og kontrollerable**: en regelsfil for intensjon, representativ kode for idiomaer, og linteren som håndhever i løkken. Den samme disiplinen (config + eksempler + automatisert sjekk) er hvordan du introduserer en menneskelig lagkamerat til dine konvensjoner også.