Hold AI-kodningsagenter i skak med Git hooks, der virkelig virker

AI-kodningsværktøjer som Claude og Copilot kan bygge features på få sekunder. Men uden kontrol skaber de kaos. Store filer på 2000 linjer og rodede løsninger ødelægger din kodebase. Dit team vil hader dig.

Løsningen er fælles Git hooks, der stopper dårlig kode før den rammer repoet.

Problemet med frie AI-agenter

Uden begrænsninger laver AI-agenter:

• Oppustede filer, der ignorerer principper om enkelt ansvar
• Kompleksitet, der gør fejlfinding til et mareridt
• Ujævne commits, der gør git-historikken ulæselig
• Uautoriserede omgange med --no-verify

De mener det godt, men prioriterer hastighed over kvalitet.

Git hooks som din kvalitetssikring

Git hooks er automatiske checks i workflowet. De står som vagter ved repo-døren.

To smarte værktøjer gør det nemt:

1. pre-commit – Standard for Python og blandede teams
2. husky – Perfekt til JavaScript med npm-integration

Se et eksempel på solid opsætning:

Vigtigste hook-regler til AI

# Eksempel på pre-commit config
repos:
  - repo: local
    hooks:
      - id: max-file-lines
        name: Tjek filstørrelse
        entry: python -c "import sys; sys.exit(1 if any(len(open(f).readlines()) > 600 for f in sys.argv[1:]) else 0)"
        language: system
        types: [python]
      
      - id: complexity-check
        name: McCabe-kompleksitetsgrænse
        entry: flake8 --max-complexity=10
        language: system
        types: [python]

Hvorfor disse grænser?

• 600 linjer pr. fil – Stramt nok til at stoppe dump, fleksibelt nok til rigtige opgaver
• McCabe 10 – Holder funktioner testbare og forståelige

Bryder agenten reglerne, fejler hooket. Ingen commit. Refaktorér først.

Værktøjer, AI-agenter skal mestre

Agenter skal kunne refaktorere for at overholde reglerne:

Python: rope håndterer alt – udtræk funktioner, omdøb variabler, splitt filer.
TypeScript/JS: ts-morph arbejder med AST for smart arkitektur.

Agenter kalder dem selv automatisk.

Agent-reglerne: Dit manifest

Lav en AGENTS.md i repoet som håndbog:

# Regler til AI-agenter

## Commit-regler
- Skriv klare beskeder i passende intervaller (ikke alt i én klump)
- Inkluder ticket-numre og forklar *hvad* og *hvorfor*
- Eksempel: "feat(auth): Tilføj OAuth2 token-rotation [#324]"

## Hook-opsætning
- Kør `git config core.hooksPath .husky` (eller tilsvarende)
- Installer hooks før første commit
- Test lokalt

## Guldregel
- **Aldrig `--no-verify` uden brugerens godkendelse**
- Det skipper alle checks – begrund altid

## Kodestil
- Følg TDD: Rød test → Grøn → Refaktor
- Skriv test først, få den til at lykkes, rydd op
- Det giver bedre design naturligt

Klare forventninger gør agenter bedre.

Hvorfor det betyder noget for holdet

Menneskelige udviklere kender technical debt. Med hooks:

✅ Tillid til main-branch – Kode opfylder minimumskrav
✅ Færre review-problemer – Fokus på logik, ikke basics
✅ Nem on-boarding – Nye ser standarden med det samme
✅ Agenter bliver klogere – Tilpasser sig over tid

Opsætningscheckliste

1. Vælg framework – pre-commit til Python, husky til JS (begge til mixed teams)
2. Sæt grænser – Start med 600 linjer og kompleksitet 10, tilpas efter behov
3. Tilføj refaktor-værktøjer – rope eller ts-morph i agentens værktøjskasse
4. Dokumentér – AGENTS.md med regler og begrundelser
5. Rul ud stille – Begynd med advarsler, skærp til blokering
6. Følg med – Tjek fejl; justér hvis grænser er for stramme

Den store pointe

Det handler ikke om at blokere AI. Det handler om at gøre god kode til den nemme vej.

Med hooks, dokumentation og refaktor-tools genererer agenter bedre kode af sig selv. De lærer at splitte opgaver, holde fokus og skrive gode commits.

Så bliver AI et boost for holdet – ikke en byrde.

Hos NameOcean er vi gale efter skalérbar infrastruktur – fra domain til cloud hosting og dev-flows. Behandl din kodebase med samme disciplin som din infra. Start med Git hooks. Din fremtidige selv siger tak.