AI kódoló ügynökök fegyelmezése: Ez a Git hooks módszer beválik

Az AI kódoló segédek ma már villámgyorsan összeraknak teljes funkciókat. De a sebesség önmagában csapda: fegyelem nélkül óriási technikai adósságot halmoznak fel. Ha egy AI 2000 soros fájlokat dobál vagy végtelen rekurziót ír, a kódbázisod katasztrófa lesz. A csapatod pedig rád haragszik.

A megoldás? Közös Git hooks-ok, amelyek minőségi szabványokat kényszerítenek ki, mielőtt a kód bejut a repóba.

Mi a baj a korlátlan AI ügynökökkel?

Ha Claude-t, Copilotot vagy más AI-t szabadjára engeded, ez történik:

• Duzzadt fájlok, amelyek semmibe veszik az egységes felelősség elvét
• Ördögi bonyolultság, ahol a hibakeresés ásatásnak tűnik
• Véletlenszerű commit üzenetek, amik miatt a git history olvashatatlan
• Lázadó ügynökök, akik --no-verify-vel megkerülik a védelmet

Vicces, hogy segíteni akarnak, de korlátok nélkül csak a gyors befejezésre mennek, nem a minőségre.

Git hooks-ok: A minőségi tűzfalad

A Git hooks-ok automatikus szabályok, amelyek kulcspilléreken futnak le a munkafolyamatban. Képzeld el őket őrnek a repó ajtajában: ellenőrzik a kódot, mielőtt beengedik.

Két remek keretrendszer könnyíti meg:

1. pre-commit – Nyelvfüggetlen, iparági sztenderd Python és vegyes csapatoknál

2. husky – JavaScript kedvenc, npm-mel integrálódik, szuper felhasználóbarát

Így néz ki egy szigorú beállítás:

Kulcsfontosságú hooks szabályok AI ügynököknek

# Példa pre-commit konfiguráció
repos:
  - repo: local
    hooks:
      - id: max-file-lines
        name: Fájlméret ellenőrzés
        entry: python -c "import sys; max_lines=600"
        language: system
        types: [python]
      
      - id: complexity-check
        name: McCabe komplexitás limit
        entry: flake8 --max-complexity=10
        language: system
        types: [python]

Miért pont ezek a számok?

• 600 sor fájlonként – Megelőzi a szörnyű dump-okat, de hagy helyet összetett fájloknak
• 10-es McCabe komplexitás – A függvények tesztelhetők és érthetők maradnak

Ha az AI túllépi, a hook elbukik. Nem commitelhető. Így a refactorolás kötelező, mielőtt a rossz kód terjed.

Eszközök, amiket az ügynököknek ismerniük kell

Hogy teljesítsék a szabályokat, refaktoroló szupererő kell nekik:

Pythonhoz: rope mindent tud: függvények kiemelése, átnevezések, modulok létrehozása. Az AI ezzel aprítja szét a nagy fájlokat.

TypeScript/JavaScripthez: ts-morph AST-alapú refaktorolás. Erős elég ahhoz, hogy az AI javítsa a saját architektúráját.

Nem kézi munka – az ügynökök programozottan hívják meg, önjavításra.

Az ügynökök alkotmánya: Írd le a szabályokat

Hozz létre egy AGENTS.md vagy CLAUDE.md fájlt a repóban, mint szabálykönyvet:

# Útmutató az AI ügynököknek

## Commit fegyelem
- Részletes üzenetek ésszerű időközönként (ne egy óriási commit feladatként)
- Húzd be a ticket számot, magyarázd a *mit* és *miért*-et
- Példa: "feat(auth): OAuth2 refresh token forgás [#324]"

## Git hooks telepítés
- Futtasd `git config core.hooksPath .husky`-t vagy hasonlót
- Telepítsd a hook-okat az első commit előtt
- Teszteld helyben push előtt

## A legfontosabb szabály
- **Sose használd a `--no-verify`-t**, hacsak a felhasználó nem erősíti meg
- Ez megkerüli az összes védelmet – dokumentáld, miért kell

## Kódminőség módszer
- Kövesd a Test-Driven Developmentet: Red → Green → Refactor
- Írj először hibás tesztet
- Add meg neki
- Utána optimalizáld és takaríts
- Ez jobb architektúrát hoz ki

Ez nem diktatúra, hanem egyértelműség. Az AI-k jobban teljesítenek világos elvárásokkal.

Miért fontos ez a csapatodnak?

Az emberi fejlesztőidnek megvannak a véleményei a kódról. Égtek már a technikai adósságon. Ezekkel a védőkorlátokkal:

✅ Biztosak a folyamatban – A main branch-be érkező kód minimumszabályoknak megfelel

✅ Kevesebb vitában a review-knál – A revúerek a logikára fókuszálnak, nem stílusra vagy fájlméretre

✅ Jobb belépés újaknak – Látják rögtön, mi a jó

✅ Az AI-k fejlődnek – Megtanulják, mi elfogadható, és igazítják a generálást

Megvalósítási checklist

1. Válassz keretrendszert – pre-commit Pythonhoz, husky JS-hez (vagy mindkettő vegyesben)

2. Állíts be reális limiteket – 600 sor és 10 komplexitás jó kiindulópont, igazítsd a saját kódodhoz

3. Adj refaktoroló eszközöket – rope vagy ts-morph legyen az AI toolboxában

4. Dokumentálj mindent – AGENTS.md a szabályokkal és magyarázattal

5. Vezess be fokozatosan – Kezdd figyelmeztetéssel, lépj kemény blokkolásra

6. Figyeld és finomhangolj – Kövesd a hook hibákat; ha túl sok, lazíts a limiteken

A lényeg

Nem csak a rossz kód megakadályozása a cél. Olyan környezetet teremtesz, ahol a jó kód a legegyszerűbb út.

Automatikus kényszer + tiszta doksi + kéznél refaktorolás = csoda. Az AI-k jobbat generálnak, mert muszáj: kisebb darabokra bontanak, fókuszált függvényeket írnak, részletes commit-eket.

Így az AI fejlesztés nem kockázat, hanem igazi turbó a csapatnak.

NameOcean-nél odavagyunk a skálázható infrastruktúráért – domaintól a cloud hostingig, fejlesztői workflow-kig. A kódod ugyanilyen fegyelemmel kezeld, mint az infrastruktúrát. Ez alap a profi csapatoknál. Kezdd a Git hooks-szal. Köszönöd majd később.