Preskočiť na obsah

Plán na štyri týždne

AI v SDLC za 30 dní: plán po týždňoch

AI kódovacích agentov dostanete do vývoja za štyri týždne, jedna téma na týždeň: v 1. týždni pravidlá v CLAUDE.md a AGENTS.md, v 2. brány v CI a hooky, v 3. pravidlá pre review a agentické review, v 4. meranie a zavedenie v celom tíme. Predtým zmerajte tri čísla, aby ste po mesiaci vedeli, čo sa zmenilo. Kostru si môžete zobrať z nášho verejného repozitára.

Čo vyplníte a zaškrtnete, ostáva len v tomto okne prehliadača. Nič neodosielame, kým si sami nenecháte poslať vyhodnotenie e-mailom. Po zatvorení stránky to zmizne, preto si výsledok vytlačte.

Pre CTO a tech leadov, ktorých vývojári už používajú Claude Code, Codex alebo Cursor, každý po svojom. Plán nemení nástroje. Mení to, čo platí pre všetkých: pravidlá v repozitári, brány v CI, review a meranie.

AI dnes píše všetok náš kód a za výsledok zodpovedá senior. Od roku 2023 sme dodali 15+ produkčných projektov. Tento plán opisuje, ako to máme nastavené u seba. Kostru si môžete zobrať z nášho verejného repozitára claude-code-production-starter.

1. Deň 0: zmerajte dnešok

Bez východiskových čísel nebudete po mesiaci vedieť, či sa niečo zlepšilo. Stačia tri, z posledných 20 zlúčených PR:

  • Čas od otvorenia PR po zlúčenie. Medián, nie priemer.
  • Koľko PR sa vrátilo z review aspoň raz. A prečo, jedným slovom.
  • Koľko zmien sa vracalo po nasadení. Revert, hotfix alebo oprava do dvoch dní.

Kde je tím dnes, zistíte za pár minút v teste Ako ďaleko ste od AI-native SDLC?. Body, ktoré vám v ňom chýbajú, sú vaša práca na najbližšie štyri týždne.

2. Plán na štyri týždne

Týždeň 1: pravidlá v CLAUDE.md a AGENTS.md

Agent číta pravidlá na začiatku každej úlohy. Ak sú len v hlavách ľudí, každý agent pracuje inak. AGENTS.md číta Codex, Cursor aj ďalšie nástroje, Claude Code číta CLAUDE.md. Najjednoduchšie je mať pravidlá v AGENTS.md a v CLAUDE.md naň odkázať.

Celú šablónu pravidiel nájdete v nástroji Pravidlá pre AI agentov v tíme. Kratšia verzia, s ktorou začať:

# Pravidlá pre AI agentov v tomto repozitári

## Príkazy
- Po každej zmene: pnpm verify (typecheck, lint, unit testy)
- Pred PR: pnpm verify:full

## Hotové je, keď
- testy, typecheck, lint a build prechádzajú,
- zmenený kód má zmenený alebo nový test,
- šablóna PR je vyplnená vrátane toho, čo ste neurobili.

## Agent nikdy
- sa nepripája k produkčnej databáze,
- nečíta .env ani kľúče,
- nenasadzuje a nespúšťa produkčné migrácie,
- neupravuje test, ktorým sa hodnotí, aby prešiel.

Týždeň 2: CI brány a hooky

Veta v AGENTS.md je prosba. Agent ju môže obísť, keď sa ponáhľa k cieľu. Čo je dôležité, musí vynútiť nastavenie, hook alebo CI. V Claude Code to robí .claude/settings.json (zakázané a povolené príkazy) a hooky, ktoré bežia pred príkazom alebo pred tým, než agent povie „hotovo“.

{
  "permissions": {
    "deny": ["Read(**/.env)", "Bash(git push --force:*)", "Bash(git reset --hard:*)", "Bash(psql:*)"],
    "ask": ["Bash(git push:*)", "Bash(gh pr merge:*)"]
  },
  "hooks": {
    "Stop": [{ "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/stop-gate.sh" }] }]
  }
}

Konkrétne brány aj s ukážkami nájdete v nástroji Koľko z 10 brán zastaví zlý AI kód vo vašom CI?.

Týždeň 3: pravidlá pre review a agentické review

Keď agent píše rýchlejšie, úzkym miestom sa stáva review. Pravidlá musia povedať, čo človek pozerá vždy, a čo nechá na stroj.

Týždeň 4: meranie a zavedenie v tíme

Zmerajte tie isté tri čísla ako v deň 0 a porovnajte. Potom z pilotu urobte štandard pre celý tím.

3. Kam patrí ktoré pravidlo

Pravidlo, ktoré sa porušilo dvakrát, posuňte o úroveň vyššie.

ÚroveňSilaPríklad
Veta v AGENTS.mdnajslabšia„Do promptu nedávajte osobné údaje zákazníkov.“
Nastavenie alebo hookstrednáZákaz čítať .env, hook na tajomstvá pred commitom
CI a chránená vetvasilnáČervené testy zablokujú zlúčenie
Lint alebo testnajsilnejšiaTest, ktorý padne na hlavnej vetve a prejde na vašej

Ďalšie nástroje pre vás

Ako ďaleko ste od AI-native SDLC? 12 otázok

12 otázok o pravidlách pre AI agentov, kontrolách v CI a zodpovednosti. Uvidíte, kde je váš tím dnes.

Koľko z 10 brán zastaví zlý AI kód vo vašom CI?

Zaškrtnite brány, ktoré máte, a uvidíte, ktoré chýbajú. Ku každej ukážka pre GitHub Actions.

Časté otázky

Aký je rozdiel medzi CLAUDE.md a AGENTS.md?
CLAUDE.md číta Claude Code, AGENTS.md číta Codex, Cursor a ďalšie nástroje. Najjednoduchšie je mať pravidlá v AGENTS.md a v CLAUDE.md na ne odkázať, aby všetci agenti v tíme pracovali podľa rovnakých pravidiel.
Prečo nestačí napísať pravidlá do AGENTS.md?
Veta v texte je prosba. Agent ju môže obísť, keď sa ponáhľa k cieľu. Dôležité pravidlá preto vynúti nastavenie, hook alebo CI. Pravidlo, ktoré sa porušilo dvakrát, posuňte o úroveň vyššie.
Čo merať pri zavádzaní AI do vývoja?
Stačia tri čísla z posledných 20 zlúčených PR: medián času od otvorenia po zlúčenie, koľko PR sa vrátilo z review a koľko zmien sa vracalo po nasadení. Zmerajte ich pred začiatkom a po štyroch týždňoch.
Zvládne to tím sám?
Väčšinou áno. Plán je zoznam práce a kostru nájdete v našom verejnom repozitári claude-code-production-starter. Pomoc dáva zmysel, keď na to tím nemá čas alebo chce nastavenie, ktoré už beží na produkčných projektoch.

AI v SDLC: nastavené za mesiac

Pravidlá, brány a review nastavíme vo vašom repozitári spolu s vaším tímom. Napíšte nám, kde ste dnes. Ozveme sa do dvoch pracovných dní s pár otázkami k vašej práci. Potom sa dohodneme, čo urobíme ako prvé.