To, co Państwo wypełnią i zaznaczą, zostaje tylko w tym oknie przeglądarki. Niczego nie wysyłamy, dopóki sami Państwo nie poproszą o ocenę e-mailem. Po zamknięciu strony zniknie, dlatego proszę wydrukować wynik.
Dla CTO i tech leadów, których programiści już korzystają z Claude Code, Codex lub Cursora, każdy po swojemu. Plan nie zmienia narzędzi. Zmienia to, co obowiązuje wszystkich: zasady w repozytorium, bramki w CI, review i pomiar.
AI pisze dziś cały nasz kod, a za wynik odpowiada senior. Od 2023 roku dostarczyliśmy 15+ projektów produkcyjnych. Ten plan opisuje, jak mamy to ustawione u siebie. Szkielet mogą Państwo wziąć z naszego publicznego repozytorium claude-code-production-starter.
1. Dzień 0: proszę zmierzyć stan dzisiejszy
Bez liczb wyjściowych po miesiącu nie będą Państwo wiedzieć, czy coś się poprawiło. Wystarczą trzy, z ostatnich 20 scalonych PR:
- Czas od otwarcia PR do scalenia. Mediana, nie średnia.
- Ile PR wróciło z review przynajmniej raz. I dlaczego, jednym słowem.
- Ile zmian trzeba było cofnąć po wdrożeniu. Revert, hotfix albo poprawka w ciągu dwóch dni.
Gdzie dziś jest zespół, sprawdzą Państwo w kilka minut w teście Jak daleko są Państwo od AI-native SDLC?. Punkty, których brakuje, to praca na najbliższe cztery tygodnie.
2. Plan na cztery tygodnie
Tydzień 1: zasady w CLAUDE.md i AGENTS.md
Agent czyta zasady na początku każdego zadania. Jeśli są tylko w głowach ludzi, każdy agent pracuje inaczej. AGENTS.md czytają Codex, Cursor i inne narzędzia, Claude Code czyta CLAUDE.md. Najprościej trzymać zasady w AGENTS.md i odwołać się do niego w CLAUDE.md.
Pełny szablon zasad znajdą Państwo w narzędziu Zasady dla agentów AI w zespole. Krótsza wersja na start:
# Zasady dla agentów AI w tym repozytorium
## Polecenia
- Po każdej zmianie: pnpm verify (typecheck, lint, testy jednostkowe)
- Przed PR: pnpm verify:full
## Gotowe, gdy
- testy, typecheck, lint i build przechodzą,
- zmieniony kod ma zmieniony lub nowy test,
- szablon PR jest wypełniony, łącznie z tym, czego nie zrobiono.
## Agent nigdy
- nie łączy się z produkcyjną bazą danych,
- nie czyta plików .env ani kluczy,
- nie wdraża i nie uruchamia migracji produkcyjnych,
- nie zmienia testu, według którego jest oceniany, żeby przeszedł.Tydzień 2: bramki CI i hooki
Zdanie w AGENTS.md to prośba. Agent może je obejść, gdy śpieszy się do celu. To, co ważne, musi wymusić ustawienie, hook albo CI. W Claude Code robi to .claude/settings.json (zabronione i dozwolone polecenia) oraz hooki, które działają przed poleceniem albo zanim agent powie „gotowe”.
{
"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" }] }]
}
}Konkretne bramki z przykładami znajdą Państwo w narzędziu Ile z 10 bramek zatrzyma zły kod AI w Państwa CI?.
Tydzień 3: zasady review i review agentowe
Gdy agent pisze szybciej, wąskim gardłem staje się review. Zasady muszą mówić, co człowiek sprawdza zawsze, a co zostawia maszynie.
Tydzień 4: pomiar i wdrożenie w zespole
Proszę zmierzyć te same trzy liczby co w dniu 0 i porównać. Potem z pilotażu zrobić standard dla całego zespołu.
3. Gdzie należy która zasada
Zasadę złamaną dwa razy proszę przesunąć o poziom wyżej.
| Poziom | Siła | Przykład |
|---|---|---|
| Zdanie w AGENTS.md | najsłabsza | „Nie wklejaj danych osobowych klientów do promptu.” |
| Ustawienie lub hook | średnia | Zakaz czytania .env, hook na sekrety przed commitem |
| CI i chroniona gałąź | silna | Czerwone testy blokują scalenie |
| Lint lub test | najsilniejsza | Test, który pada na gałęzi głównej i przechodzi na Państwa |
Więcej narzędzi dla Państwa
12 pytań o zasady dla agentów AI, kontrole w CI i odpowiedzialność. Zobaczą Państwo, gdzie dziś jest zespół.
Proszę zaznaczyć bramki, które Państwo mają, i zobaczyć, których brakuje. Przy każdej przykład dla GitHub Actions.