Hogyan készítsd arra az AI asszisztenst, hogy kövesse a projektedhez tartozó kódolási konvencióknak?

Question

Accepted Answer

Az AI alapértelmezésben a képzési adatainak egy általános átlagára redukálódik, ezért ahhoz, hogy megkapd az **te** stílusodat, **meg kell mutatnod és érvényesítenünk kell** — példákon, kifejezett szabályfájlon, és egy linter hurok, amely megragad amit elcsúszott. Ne számíts rá, hogy megoldja a szabványaidat (WordPress Coding Standards, PSR-12, stb.).

## Technikák (hatás szerinti sorrendben)

- **Biztosítsd a linter konfigurációt és példákat** — illessz be az `.eslintrc`-t, `phpcs.xml`-t vagy `.editorconfig`-et. Ezek a szabályok gépi ellenőrizhetű formában vannak, és az AI képes olvasni.
- **Tartsd meg a szabály/utasítás fájlt** — egy `CLAUDE.md` vagy rendszerutasítást amely kifejezetten kimondja a standardot: "Ez a projekt a **PSR-12**-t követi. Használj 4-szóköz behúzást, kapcsos zárójeleket a függvények következő sorában, snake_case-t a hookokhoz." Az állandó utasítások megspórolják magadtól, hogy minden prompt-on megismételje magát.
- **Mutass reprezentatív meglévő kódot** — egy vagy két tiszta fájl gyorsabban tanít meg az elnevezésre, struktúrára és idiómákra, mint bármelyik leírás. Az AI megfelel azzal a mintákkal amiket lát.
- **Futtass linter-t az AI kimenetén és küldd vissza a hibákat** — a legmegbízhatóbb lépés. A linter az alapigazság; illessz be a hibáit és kérd meg az AI-t hogy javítsa ki őket.

## Linter hurok

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

Ez a hurok gyorsan konvergál, mivel a linter precíz, soros szintű visszajelzést ad, amelyre az AI közvetlenül hathat, ahelyett, hogy prózában leírnád a stílust.

## Miért számít

A projektkonvenciákat figyelmen kívül hagyó kód **áttekintési súrlódást és következetlenséget** hoz létre még akkor is, ha funkcionálisan helyes — az értékelők formázásra pazarolnak időt, és a kódbázis sodródik. Az AI-nek nincs tudomása a házistílusodról, hacsak nem biztosítasz, ezért a munka a szabályokat **egyértelművé és ellenőrizhetővé** teszi: szabályfájl a szándékhoz, reprezentatív kód az idiómákhoz, és a linter a hurok érvényre juttatójaként. Ugyanez a fegyelem (config + példák + automatizált ellenőrzés) az, ahogy egy emberi csapattársat a konvenciódhoz bekészítesz.