Kako dosežeš, da AI asistent sledi kodnim konvencijam tvojega projekta?

Question

Accepted Answer

AI se privzeto naslanja na generično povprečje svojih podatkov za učenje, zato da dosežeš **tvoj** stil, moraš **pokazati in uveljavljati** — prek primerov, eksplicitne datoteke s pravili in zanke z lintrjem, ki ujame vse, kar se izogne. Ne zanašaj se, da bo uganil tvoje standarde (WordPress Coding Standards, PSR-12, itd.).

## Tehnike (po vrstnem redu učinkovitosti)

- **Priloži konfiguracijsko datoteko lintrja in primere** — prilepi svojo `.eslintrc`, `phpcs.xml` ali `.editorconfig`. To so pravila v strojno-preverjivi obliki, AI pa jih lahko prebere.
- **Obdrži datoteko s pravili/navodili** — datoteko `CLAUDE.md` ali sistemsko sporočilo, ki jasno navede standarde: "Ta projekt sledi **PSR-12**. Uporabi zamik s 4 presledki, oglatim oklepajem na naslednji vrstici za funkcije, snake_case za kljuke." Stalna navodila so boljša kot ponavljanje v vsakem pozivu.
- **Pokaži reprezentativno obstoječo kodo** — ena ali dve čisti datoteki nauči poimenovanja, strukture in idiomov hitreje kot kateri koli opis. AI se ujema s tistim, kar vidi.
- **Zaženi lintrja nad izhodom AI in vrni napake nazaj** — najbolj zanesljiv korak. Lintrja je resnica; prilepi njegove napake in prosi AI, da jih popravi.

## Zanka z lintrjem

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

Ta zanka konvergira hitro, ker lintrja daje natančno povratno informacijo na ravni vrstice, ki jo AI lahko neposredno obdela, namesto da bi ti opisal stil s proso.

## Zakaj je to pomembno

Koda, ki ignorira projektne konvencije, ustvari **trenje pri pregledih in nedoslednost** tudi kadar je funkcionalno pravilna — pregledovalci trosijo čas na oblikovanje, kodna baza pa se raziduje. AI nima zavesti za tvoj domač stil, če ga ne zagotovišš, zato je delo, da postaviš pravila **eksplicitna in preverjljiva**: datoteka s pravili za namen, reprezentativna koda za idiome in lintrja kot uporabnik v zanki. Ista disciplina (konfiguracija + primeri + avtomatizirana preverka) je tudi način, kako vodiš novega člana tima v konvencije tvojega projekta.