Hvordan får du en AI-assistent til at følge dit projekts kodningskonventioner?

Question

Accepted Answer

AI bruger som standard et generisk gennemsnit af sine træningsdata, så for at få **dit** stil skal du **vise og håndhæve** det — gennem eksempler, en eksplicit regelsfil og en linter-løkke, der fanger det, som glider gennem. Stol ikke på, at det gætter dine standarder (WordPress Coding Standards, PSR-12 osv.).

## Teknikker (i rækkefølge efter indflydelse)

- **Giv linter-config og eksempler** — indsæt din `.eslintrc`, `phpcs.xml` eller `.editorconfig`. Dette er regler i maskinekontrollerbar form, som AI kan læse.
- **Vedligehold en regler-/instruktionsfil** — en `CLAUDE.md` eller systemprompt, der eksplicit angiver standarden: "Dette projekt følger **PSR-12**. Brug 4-spaces indryk, seler på næste linje for funktioner, snake_case for kroghøjre." Stående instruktioner er bedre end at gentage dig selv i hver prompt.
- **Vis repræsentativ eksisterende kode** — en eller to rene filer lærer navngivning, struktur og idiomer hurtigere end nogen beskrivelse. AI mønstermatches det, den ser.
- **Kør linter på AI-output og feed fejl tilbage** — det mest pålidelige trin. Linteren er grundsandhed; indsæt dens fejl og bed AI'en om at rette 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økke konvergerer hurtigt, fordi linteren giver præcis feedback på linjeniveauet, som AI kan handle direkte på, i stedet for at du beskriver stilen i prosa.

## Hvorfor det betyder noget

Kode, der ignorerer projektkonventioner, skaber **reviewfriktion og uoverensstemmelse** selv når den er funktionelt korrekt — reviewere spilder tid på formatering, og kodebasen glider. AI har ingen bevidsthed om din hus-stil, medmindre du forsyner den, så arbejdet er at gøre reglerne **eksplicitte og kontrollable**: en regelsfil til hensigt, repræsentativ kode til idiomer og linteren som håndhæver i løkken. Den samme disciplin (config + eksempler + automatisk tjek) er også, hvordan du onboarder en menneskelig holdmedlem til dine konventioner.