Pidä AI-koodausagentit kurissa: Git-hookit, jotka todella toimivat

AI-koodausagentit kirjoittavat kokonaisia ominaisuuksia sekunneissa. Hieno juttu, mutta ilman rajoja ne synnyttävät teknistä velkaa salamannopeasti. Yhden agentin tuottama 2000-rivinen möhkäle tai loputtomaan silmukkaan jumittuva funktio tuhoaa koodisi – ja tiimisi vihaa sinua.

Ratkaisu on yksinkertainen: jaetut Git-hookit, jotka tarkistavat laadun ennen kuin koodi pääsee repoon.

Miksi vapaana laukkaavat agentit epäonnistuvat

Kun annat Claudelle, Copilotille tai mille tahansa agentille vapaat kädet, tuloksena on:

• Liian isot tiedostot, jotka rikkovat kaiken single-responsibility-oppien
• Yksityiskohtainen sotku, jonka debuggaus tuntuu kaivauksilta
• Epäjohdonmukaiset commitit, joista git-historia muuttuu sohvapölyksi
• Kujeilevat agentit, jotka kiertävät tarkistukset --no-verify-lipulla

Agentit yrittävät auttaa, mutta ilman rajoja ne priorisoivat nopeutta laadun sijaan.

Git-hookit laadun vartijana

Git-hookit ovat automaatiota, joka käynnistyy workflow'n kriittisissä kohdissa. Ne toimivat reposi ovimiehinä: tarkistavat, ennen kuin mikään pääsee sisään.

Kaksi suosituinta työkalua tekee asetuksista helpon:

1. pre-commit – Kielirajoista vapaa standardi, täydellinen Python- ja sekakielitiimeille

2. husky – JS-maailman suosikki, integroituu npmiin ja helppo asentaa

Tässä esimerkki toimivasta kokonaisuudesta:

Pakolliset säännöt AI-agenteille

# Esimerkki pre-commit-konffista
repos:
  - repo: local
    hooks:
      - id: max-file-lines
        name: Tarkista tiedoston pituus
        entry: python -c "import sys; max_lines=600"
        language: system
        types: [python]
      
      - id: complexity-check
        name: McCabe-kompleksisuusraja
        entry: flake8 --max-complexity=10
        language: system
        types: [python]

Miksi juuri nämä rajat?

• 600 riviä tiedostoa kohti – Estää möhkäleet, mutta sallii monimutkaisetkin tiedostot
• McCabe 10 – Pidättää funktiot testattavina ja ymmärrettävinä

Jos agent rikkoo säännöt, hook kaataa committi. Koodi ei leviä ennen korjausta.

Työkalut, joilla agentit pärjäävät

Agenttien täytyy osata refaktoroida itseään. Tässä avaintyökalut:

Pythonille: rope hoitaa kaiken – funktioiden erottelun, nimeämisen, moduulit. Agentit kutsuvat sitä ohjelmallisesti.

TypeScript/JS:lle: ts-morph muokkaa AST:ta. Agentit voivat parantaa omaa arkkitehtuuriaan reaaliajassa.

Ei manuaalityötä – agentit korjaavat itse.

Agenttien ohjekirja: AGENTS.md

Luo repoosi AGENTS.md-tiedosto, joka listaa säännöt selkeästi:

# Ohjeet AI-agenteille

## Commit-säännöt
- Kirjoita kuvaavat commitit kohtuullisin välein (ei yhtä jättiläistä per tehtävä)
- Lisää tiketinumero ja selitys *miksi*, ei vain *mitä*
- Esimerkki: "feat(auth): Lisää OAuth2 tokenin kierrätys [#324]"

## Hookien asennus
- Aja aina `git config core.hooksPath .husky` tai vastaava
- Testaa paikallisesti ennen pushea

## Kultainen sääntö
- **ÄLÄ KOSKAAN käytä `--no-verify` ilman käyttäjän lupaa**
- Selitä, miksi se on tarpeen

## Laaturutiinit
- Seuraa TDD:tä: Red → Green → Refactor
- Kirjoita testi ensin
- Saat sen läpi
- Sitten siivoa ja optimoi

Selkeät odotukset parantavat agenttien tulosta.

Miksi tämä auttaa tiimiäsi

Ihmiskehittäjät tuntevat jo teknisen velan kivun. Näillä rajoilla:

✅ Luottamus prosessiin – Mainiin pääsee vain laadukasta koodia

✅ Nopeammat reviewt – Keskitytään logiikkaan, ei tyyliongelmiin

✅ Helppo perehdytys – Uudet näkevät heti, millaista koodia odotetaan

✅ Agentit kehittyvät – Opin rajat ja tuottavat parempaa

Toteutuksen tarkistuslista

1. Valitse framework – pre-commit Pythonille, husky JS:lle (tai molemmat)

2. Aseta rajat – 600 riviä ja kompleksisuus 10 ovat hyvät lähdöt

3. Lisää refaktorointityökalut – rope tai ts-morph agenttien käyttöön

4. Dokumentoi – Kirjoita AGENTS.md syineen

5. Tee asteittain – Aloita varoituksilla, siirry koviin failauksiin

6. Seuraa – Jos hookit kaatuvat jatkuvasti, löysää rajoja

Oikea oppi

Tämä ei vain estä huonoa koodia. Se luo ympäristön, jossa hyvä koodi on helpoin tie.

Kun yhdistät automaation, ohjeet ja työkalut, agentit oppivat automaattisesti: pienet palaset, keskittyneet funktiot, hyvät commitit. AI-muutos ei ole enää riski – se moninkertaistaa tiimisi voiman.

NameOceanissa panostamme skaalautuvaan infraan domain-hallinnasta web-hostingiin ja kehitystyönkulkuihin. Käsittele koodiasi yhtä tiukasti kuin infrastruktuuria. Aloita Git-hokeista. Tuleva minäsi kiittää.