Kako prisilite AI asistenta da slijedi dogovore kodiranja vašeg projekta?

Question

Accepted Answer

AI se zadano svodi na generički prosjek svojih podataka za obuku, pa da biste dobili **svoj** stil morali biste ga **pokazati i provesti** — kroz primjere, eksplicitnu datoteku pravila i linter petlju koja hvata ono što prođe. Nemojte se oslanjati na to da pogađa vaše standarde (WordPress Coding Standards, PSR-12, itd.).

## Tehnike (redoslijed utjecaja)

- **Pružite konfiguraciju linter-a i primjere** — zalijepite svoju `.eslintrc`, `phpcs.xml` ili `.editorconfig`. To su pravila u obliku koji se može provjeriti strojem, a AI ih može čitati.
- **Održavajte datoteku pravila/uputa** — `CLAUDE.md` ili sistemsku naredbu koja eksplicitno navodi standard: "Ovaj projekt slijedi **PSR-12**. Koristite 4-razmaknuti indent, zagrade u sljedećoj liniji za funkcije, snake_case za kuke." Trajne upute štede vam od ponavljanja sami s svakom naredbom.
- **Pokažite reprezentativni postojeći kod** — jedna ili dvije čiste datoteke brže mogu naučiti imenovanje, strukturu i idiome nego bilo kakav opis. AI se upoklanja s obrascima koje vidi.
- **Pokrenite linter na AI izlazu i vratite greške** — najotporniji korak. Linter je temeljna istina; zalijepite njegove greške i zatražite od AI-ja da ih popravi.

## Linter petlja

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

Ova petlja brzo konvergira jer linter daje preciznu, povratnu informaciju razine linija na koju AI može djelomično djelovati, umjesto da je vi opisujete u prozi.

## Zašto je to važno

Kod koji ignora dogovore projekta stvara **trenje pri pregledu i nedosljednost** čak i kada je funkcionalno ispravan — recenzenti gube vrijeme na oblikovanje, a kôdna baza se razilazi. AI nema svjesnosti o vašem kućnom stilu osim ako ga ne opskrbite, pa je posao učiniti pravila **eksplicitnim i provjerljiva**: datoteka pravila za namjeru, reprezentativni kod za idiome i linter kao hvatač u petlji. Ista disciplina (config + primjeri + automatizirani pregled) je kako onibodit ljudskog suigrača na vaše dogovore.