Claude Code best practices pre tím: 7, ktoré držia

Claude Code best practices, na ktorých v tíme záleží, nie sú tipy na prompty. Je to sedem pravidiel, ktoré platia, aj keď sa nikto nepozerá: krátky CLAUDE.md, ktorý stráži CI, jeden zdieľaný plugin, oprávnenia a hooky v repozitári, jedno issue na jeden PR, test, ktorý najprv padne, a reviewer, ktorý kód nepísal. Každé z nich vynucuje súbor alebo kontrola, nie niečia pamäť.

Takto máme nastavený každý repozitár a AI dnes píše všetok náš kód. Zvyšok článku ukazuje, ako sa každá praktika vynucuje, so skutočnými súbormi.

Ktoré praktiky pre Claude Code v tíme držia?

Tipy jednotlivca žijú v jeho hlave. Tímová praktika potrebuje miesto, kde je zapísaná, a kontrolu, ktorá si všimne, keď sa poruší:

Tabuľka je zároveň poradie. Prvé štyri stoja jedno popoludnie. Posledné tri menia, ako tečie práca.

1. Prečo držať CLAUDE.md krátky a ako to vynútiť?

CLAUDE.md a každý vždy načítaný súbor s pravidlami idú do kontextu pri každej požiadavke. Sprievodca nákladmi od Anthropicu odporúča držať ho pod 200 riadkami a postupy presunúť do skills, ktoré sa načítajú, až keď treba.

„Držte to krátke“ vydrží asi dva týždne. Náš validátor to preto počíta. Sčíta CLAUDE.md aj všetky vždy načítané pravidlá spolu, preto má strop 300 riadkov, nie 200:

# CLAUDE.md + every .claude/rules/*.md that loads on every session
# (rules scoped with `paths:` load only under matching paths and are skipped)
if [ "$total_lines" -gt 300 ]; then
  log_critical "Context budget exceeded: $total_lines lines (max 300)."
fi

Beží v CI v každom repozitári. Vo firemných a klientskych repozitároch build zhodí, v repozitároch s kódom len varuje.

Druhá polovica je, kam pravidlo patrí. Osobný štýl práce patrí do ~/.claude. Všetko, čo musí dodržať celý tím, patrí do repozitára.

Ako rozdeliť pravidlá medzi CLAUDE.md, AGENTS.md a osobné súbory, rozoberáme podrobne v článku Pravidlá pre AI kód v tíme.

2. Prečo jeden zdieľaný plugin namiesto kópií?

Kedysi sme naše skills na plánovanie, stavbu a review kopírovali do každého repozitára. Za pár týždňov sa kópie rozišli a niektoré boli len prázdne kostry. Disciplína to nevyriešila. Vyriešil to jeden plugin, wizrd, náš interný plugin a CLI pre Claude Code (nie je verejný). Skills, agenti a hooky žijú v jednom repozitári a každý ďalší si ho zapne dvoma riadkami nastavení:

{
  "enabledPlugins": { "wizrd@digitaliko": true },
  "extraKnownMarketplaces": {
    "digitaliko": { "source": { "source": "directory", "path": "services/wizrd" } }
  }
}

Oprava review skillu sa teraz dostane do každej session pri jej ďalšom štarte. Ako je samotný plugin postavený, je v článku Claude Code skills a pluginy pre tím.

3. Prečo dať oprávnenia do repozitára?

Lebo deny v repozitári prebije allow kdekoľvek inde. Claude Code kontroluje najprv deny, potom ask, potom allow, naprieč všetkými súbormi nastavení. Tím teda rozhodne raz, v .claude/settings.json: deny pre .env súbory a kľúče, ask pred pushom, mergom alebo nasadením, allow pre skripty, ktorými si agent kontroluje vlastnú prácu.

Všetko osobné ostáva v ~/.claude/settings.json. Tvar a naše presné položky sú v článku Claude Code permissions: kedy je skip permissions bezpečné?.

4. Prečo blokovať hookmi namiesto prosieb v CLAUDE.md?

Veta v CLAUDE.md je prosba. Jedného októbrového dňa agent vpísal do niekoľkých pull requestov v našich vlastných repozitároch pätičku s AI podpisom, a to v session, ktorej CLAUDE.md presne toto jasne zakazoval.

Riešením bol PreToolUse hook, ktorý prejde každý príkaz git commit, gh pr a gh issue vrátane súborov odovzdaných cez --body-file a vráti exit 2. Komentár na začiatku skriptu to hovorí najlepšie: „A rule is a request. This is the lock.“ Pravidlo je prosba, hook je zámok.

Hooky majú vlastnú pascu: môžu stíchnuť a aj tak prechádzať. Štyri kontroly, ktoré to odhalia, sú v článku Claude Code hooks: prečo naše hooky nerobili nič.

5. Prečo jedno issue na jeden PR?

Session agenta zabúda. GitHub issue nie. Každá úloha začína ako issue s tým, čo znamená „hotovo“, napísaným tak, aby reviewer vedel odpovedať áno alebo nie, a končí jedným pull requestom s Closes #N.

Dá to tri veci, ktoré chat nedá. Plán je vidieť ešte pred začiatkom práce. Dvaja agenti môžu pracovať paralelne, každý vo vlastnom git worktree na vlastnej vetve, bez toho, aby si prekážali. A zmergované pull requesty sú changelog, takže nikto nepíše výkaz práce.

Plan mode pomáha vnútri session. Kde pre tím prestáva stačiť, je v článku Claude Code plan mode: kedy tímu stačí?.

6. Prečo musí test najprv padnúť?

Agent vie napísať testy, ktoré prejdú, či kód funguje, alebo nie. Naša brána preto spustí nové alebo zmenené testy na základnej vetve, pred opravou. Ak prejdú aj tam, nič nedokazujú a pull request sa vráti. Počíta sa len test, ktorý je bez zmeny červený a so zmenou zelený. Celý mechanizmus je v článku Red-green TDD s AI agentom.

7. Prečo má kód skontrolovať iný agent?

Agent, ktorý kód napísal, už presvedčil sám seba. Nová session, ktorá číta len diff, nájde, čo autor preskočil. Náš reviewer v CI dostane zoznam nástrojov len na čítanie (git diff, git log, gh pr diff, Read, Grep) a checklist na review z repozitára. Komentuje, nikdy neschvaľuje. Ochrana vetvy vyžaduje človeka, takže merge je vždy ľudské rozhodnutie. Nastavenie aj prompt sú v článku AI code review s Claude Code v CI.

Kde má tím začať?

Nie všetkými siedmimi naraz. Poradie, ktoré fungovalo nám:

Prvé tri kroky zaberú v existujúcom repozitári deň. Štvrtý je zvyk a trvá pár týždňov komentárov v review, kým tím píše issues, ktoré agent dokončí bez otázok.

Kde je váš tím dnes?

Spočítajte, čo už vo vašich repozitároch je, nie to, čo ľudia hovoria, že robia:

Nastavenia, hooky, bránu aj review workflow si môžete skopírovať z nášho Claude Code production starteru pod licenciou MIT.

Chcete tieto praktiky vo vašich repozitároch?

Nastavujeme ich priamo v repozitároch tímu, spolu s vývojármi, v službe AI-native SDLC pre vývojové tímy. AI dnes píše všetok náš kód a za výsledok ručí senior. Od roku 2023 sme dodali 15+ produkčných projektov.

Ozveme sa do dvoch pracovných dní a spolu vyberieme, čo vyriešime ako prvé.

Ak sa chcete najprv porozprávať, dohodnite si meeting na 15 minút s Filipom.

Ktorá zo siedmich by sa vo vašom tíme rozpadla prvá, keby ju nikto nekontroloval?

Časté otázky

Ktoré Claude Code best practices sú najdôležitejšie?

Pre tím: krátky CLAUDE.md s limitom, ktorý sa kontroluje, skills a hooky zdieľané ako jeden plugin, oprávnenia v repozitári, blokovanie hookmi namiesto prosieb v texte, jedno issue na jeden PR, každá zmena dokázaná testom, ktorý najprv padne, a review od iného agenta, potom merguje človek.

Aký dlhý má byť CLAUDE.md?

Taký krátky, aby sa oplatil pri každej požiadavke. Anthropic odporúča menej ako 200 riadkov. My sčítame CLAUDE.md a všetky vždy načítané súbory s pravidlami spolu a vo firemných a klientskych repozitároch CI zlyhá nad 300 riadkov.

Majú byť nastavenia Claude Code v gite?

Tímová časť áno: .claude/settings.json s oprávneniami a hookmi patrí do repozitára. Osobné preferencie patria do ~/.claude/settings.json a lokálne úpravy do .claude/settings.local.json, ktorý v gite nie je.

Ako zdieľať Claude Code skills v tíme?

Ako plugin, ktorý si každý repozitár zapne v nastaveniach. Kópie skills v jednotlivých repozitároch sa za pár týždňov rozídu; jeden plugin dá každej session tie isté skills, agentov aj hooky.

Je plan mode best practice pre každú úlohu?

Na prieskum pred väčšou zmenou áno. V tíme však plán musí žiť aj tam, kde ho prečítajú ostatní, napríklad v issue s kritériami prijatia, nie len v session jedného vývojára.