Hur får du en AI-assistent att följa ditt projekts kodkonventioner?

Question

Accepted Answer

En AI har som standard en generisk genomsnitt från sitt träningsdata, så för att få **din** stil måste du **visa och tillämpa** den — genom exempel, en explicit regellfil och en linter-loop som fångar det som slinker igenom. Förlita dig inte på att den gissar dina standarder (WordPress Coding Standards, PSR-12, etc.).

## Tekniker (i ordning efter påverkan)

- **Tillhandahåll linter-konfigurationen och exempel** — klistra in din `.eslintrc`, `phpcs.xml` eller `.editorconfig`. Dessa är reglerna i maskinläsbar form, och AI:n kan läsa dem.
- **Behåll en regellfil/instruktionsfil** — en `CLAUDE.md` eller systemprompt som uttryckligen anger standarden: "Det här projektet följer **PSR-12**. Använd 4-mellanslag indrag, klammerparenteser på nästa rad för funktioner, snake_case för hooks." Stående instruktioner är bättre än att upprepa dig själv för varje prompt.
- **Visa representativ befintlig kod** — en eller två rena filer lär namngivning, struktur och idiom snabbare än någon beskrivning. AI:n mönstermatchar det den ser.
- **Kör lintern på AI-utdata och mata tillbaka fel** — det mest pålitliga steget. Lintern är källan till sanning; klistra in dess fel och be AI:n att fixa dem.

## Linter-loopen

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

Denna loop konvergerar snabbt eftersom lintern ger exakt, rad-nivå feedback som AI:n kan agera på direkt, istället för att du beskriver stilen i prosa.

## Varför det spelar roll

Kod som ignorerar projektkonventioner skapar **granskningsfriktion och inkonsistens** även när den är funktionellt korrekt — granskare slösar tid på formatering, och kodbasen driver iväg. En AI har ingen medvetenhet om dina husstandarder om du inte tillhandahåller dem, så jobbet är att göra reglerna **explicita och kontrollerbara**: en regellfil för avsikt, representativ kod för idiom och lintern som tillämper den i loopen. Samma disciplin (konfiguration + exempel + automatiserad kontroll) är hur du introducerar en människlig lagkamrat till dina konventioner också.