AI-native SDLC w Claude Code

Ścieżka Claude Code wdraża sześć wspólnych etapów przez Plan mode, CLAUDE.md, skille, hooki, subagentów, worktree, print mode i automatyzację GitHuba. Ta strona jest adapterem narzędzia: wskazuje natywną funkcję dla każdej bramki i prowadzi do jednego kanonicznego opisu danego etapu.

Sam cykl pozostaje niezależny od narzędzia. Najpierw przeczytaj przegląd AI-native SDLC, a tutaj wracaj po sposób wykonania kroku w Claude Code.

Mapa etapów

Etap	Zaakceptowany artefakt	Funkcja Claude Code	Kanoniczna procedura
Plan	`intent.md`	Interaktywna sesja odkrywania problemu i kontekst repozytorium	Uchwyć intencję
Design	`spec.md`	Skille w `.claude/skills/`; trwały kontekst repo w `CLAUDE.md`	Napisz specyfikację
Build	`plan.md`, diff, testy	Plan permission mode, `claude -w`, subagenci i deterministyczne hooki	Buduj z zaakceptowanego planu
Test	Dowody z testów	Ta sama sesja uruchamia testy, build i kontrolę wizualną; `claude -p` obsługuje powtarzalne kontrole	Zamknij pętlę informacji zwrotnej
Deploy	Zrecenzowany pull request	`claude-code-action`, automatyczne review, chroniony merge i środowisko produkcyjne	Warstwowe review i akceptacje
Maintain	Incydent i następny `intent.md`	Zewnętrzny harmonogram lub routine uruchamia ograniczony triage przez `claude -p`	Połącz produkcję z planowaniem

Skonfiguruj ścieżkę budowy

Wymagania: repozytorium Git, czysty working tree, uwierzytelniony Claude Code oraz rzeczywiste komendy testowe zapisane w CLAUDE.md.

Rozpocznij planowanie bez prawa edycji:
Okno terminala
```
claude --permission-mode plan
```

Poproś o plan i dowody przed zmianą kodu:

Przeczytaj docs/intents/FUNKCJA.md i docs/specs/FUNKCJA.md. Zbadaj repozytorium.
Zaproponuj uporządkowany plan z konkretnymi plikami, ryzykami, krokami test-first
i rollbackiem. Nie edytuj plików aplikacji. Zatrzymaj się do akceptacji.

Zapisz zaakceptowany plan w repozytorium i utwórz izolowaną sesję:
Okno terminala
```
claude -w feature-slug
```

Zrealizuj wyłącznie zaakceptowany fragment:

Przeczytaj docs/plans/FUNKCJA.md i CLAUDE.md. Zrealizuj tylko milestone 1.
Uruchom wskazany typecheck, lint, testy jednostkowe, integracyjne i wizualne.
Jeśli dowód zawiedzie, popraw implementację; nie osłabiaj testów.
Zakończ listą plików, wynikami komend i pozostałym ryzykiem.

Przejrzyj diff i dowody przed commitem. Wdrożenie produkcyjne pozostaw za ludzką bramką akceptacji.

Opcja -w/--worktree tworzy dla sesji izolowany Git worktree. Repozytoryjny helper może być lepszy, gdy dodatkowo przydziela porty, kopiuje ignorowaną konfigurację i przygotowuje lokalną bazę.

Umieść zasady we właściwej warstwie

Wiedzę objaśniającą repozytorium zapisuj w CLAUDE.md.
Powtarzalne procedury zapisuj w .claude/skills/NAZWA_SKILLA/SKILL.md.
Specjalistyczną delegację umieszczaj w .claude/agents/.
Deterministyczne reguły allow/deny i walidację zapisuj w hookach.
Ochronę gałęzi, wymagane checki i akceptację produkcji konfiguruj na platformie. Prompt nie jest kontrolą wydania.

Automatyzuj ograniczone kontrole

Print mode nadaje się do zadań z góry ograniczonych wejściem, uprawnieniami, formatem wyniku, timeoutem i obsługą błędu:

claude -p \
  --permission-mode plan \
  --output-format json \
  "Porównaj bieżący diff z docs/specs/FUNKCJA.md. Zwróć tylko blokujące problemy."

Trybu pozwalającego na zapis używaj wyłącznie w izolowanym środowisku z ograniczonymi poświadczeniami. --dangerously-skip-permissions nie jest zwykłym skrótem do CI.

Potwierdź działanie adaptera

claude --help pokazuje --permission-mode, --worktree, --print i --output-format.
Sesja Plan bada repo bez zmiany plików aplikacji.
Zaakceptowany plan.md wskazuje źródłowe intent.md i spec.md.
Sesja wykonawcza uruchamia prawdziwe bramki jakości i raportuje ich status.
Merge oraz wydanie produkcyjne nadal wymagają wskazanego człowieka lub polityki platformy.

Typowe awarie

Claude edytuje przed akceptacją planu. Uruchom --permission-mode plan, rozdziel odkrywanie od implementacji i commituj zaakceptowany plan.

Hook jest dobrze opisany, ale niczego nie blokuje. Porównaj z aktualnym zagnieżdżonym schematem hooków i JSON-em decyzji; nie kopiuj starego, płaskiego przykładu z samym command.

Równoległe sesje kolidują. Jedno zadanie przypisz do jednego worktree, a porty i lokalny stan przydzielaj jawnie. Worktree izoluje pliki, nie wspólne zasoby chmurowe.

Kontynuuj ścieżkę

Łańcuch artefaktów Zbuduj ślad od intencji przez specyfikację i plan po incydent.

Szybki start Claude Code Zainstaluj, uwierzytelnij i skonfiguruj pierwszą sesję.

Hooki Przenieś deterministyczne zabezpieczenia z promptów do kontroli cyklu.

GitHub Actions Uruchamiaj ograniczone zadania Claude Code w CI.