Jak udržet AI kódovací agenty na uzdě. Git hooks, které opravdu fungují

AI asistenti píšou kód rychleji než kdy dřív. Celé funkce za pár vteřin. Problém? Bez pravidel to vede k obrovskému technickému dluhu. AI může naházet tisíce řádků do souboru nebo vytvořit nekonečné smyčky. Výsledek: kód, který nikdo nechce číst.

Řešení je jednoduché: sdílené Git hooks, co kontrolují kvalitu před commitnutím.

Proč AI bez omezení ničí repo

Bez omezení dostanete:

• Přehnaně dlouhé soubory, co porušují princip jedné odpovědnosti
• Zmatekou složitost, kde ladění trvá věčnost
• Chaotické commity, co dělají git log nepřečitatelným
• Agenty, co obcházejí kontroly pomocí --no-verify

AI se snaží dokončit úkol co nejdříve. Kvalita jde stranou.

Git hooks jako ochrana kvality

Git hooks jsou automatické skripty, co běží v klíčových bodech. Jako vrátný u dveří repo – nikdo se nedostane dovnitř bez kontroly.

Dvě top nástroje:

1. pre-commit – Univerzální framework, ideální pro Python i smíšené projekty

2. husky – Pro JavaScript, snadno se integruje s npm

Příklad nastavení:

Klíčové pravidla pro AI agenty

# Příklad .pre-commit-config.yaml
repos:
  - repo: local
    hooks:
      - id: limit-lines
        name: Max délka souboru
        entry: python -c "import sys; sys.exit(1 if len(open(sys.argv[1]).readlines()) > 600 else 0)"
        language: system
        types: [python]
      
      - id: check-complexity
        name: Limit složitosti McCabe
        entry: flake8 --max-complexity=10
        language: system
        types: [python]

Proč tyto limity?

• 600 řádků na soubor – Brání dumpům, ale nechává prostor pro složitější kód
• Složitost 10 – Funkce zůstanou testovatelné a srozumitelné

Poruší AI pravidlo? Hook selže. Commit neprojde. Kód se refaktoruje hned.

Nástroje, co AI potřebuje pro refactoring

Aby agenty splnily pravidla, musí umět refaktorovat:

Pro Python: rope – Automaticky dělí soubory, přesouvá funkce, mění názvy.

Pro TypeScript/JS: ts-morph – Pracuje s AST, agenty si kód vylepší samy.

Žádné ruční práce. AI to spustí samo.

Pravidla pro agenty: AGENTS.md

Vytvořte soubor AGENTS.md jako ústavu:

# Pravidla pro AI agenty

## Commity
- Pište krátké, popisné zprávy v pravidelných intervalech
- Zmiňte ticket: "feat(login): Přidání 2FA [#123] – Zabrání brute-force"
- Žádné obří commity na konci úkolu

## Instalace hooks
- Spusťte `git config core.hooksPath .husky`
- Testujte lokálně před push

## Nejdůležitější pravidlo
- **Nikdy `--no-verify` bez souhlasu uživatele**
- Zapište důvod

## Přístup k kódu
- TDD: Nejdřív test (red), pak pass (green), refaktor
- To vede k čistší architektuře

Jasná pravidla pomáhají AI pracovat efektivněji.

Proč to pomůže týmu

Lidi v týmu už mají zkušenosti s špatným kódem. S hooks:

✅ Důvěra v main branch – Kód splňuje standardy

✅ Rychlejší review – Zaměřte se na logiku, ne na formát

✅ Snadnější nástup – Nováčci vidí, jak to má vypadat

✅ AI se učí – Přizpůsobí se a generuje lepší kód

Checklist pro start

1. Vyberte framework – pre-commit pro Python, husky pro JS

2. Nastavte limity – 600 řádků, složitost 10 (upravte podle potřeby)

3. Přidejte refaktory – rope nebo ts-morph do toolkitu AI

4. Dokumentujte – AGENTS.md s vysvětlením

5. Zavádějte postupně – Nejdřív varování, pak blokování

6. Sledujte – Pokud hooks padají často, limity uvolněte

Hlavní myšlenka

Nejde jen o blokování špatného kódu. Jde o prostředí, kde dobrý kód je nejjednodušší cesta.

S automatickými kontrolami, dokumentací a nástroji se AI naučí dělit úkoly, psát čisté funkce a užitečné commity. Pak se z pomůcky stane skutečný multiplikátor produktivity.

V NameOcean se staráme o skalovatelnou infrastrukturu – od domain po hosting a workflowy pro developery. Stejnou disciplínu aplikujte i na kód. Začněte s Git hooks. Poděkujete si.