Protokół startu sesji — 5 minut przed dotknięciem kodu

Po co

Nowa sesja Claude'a zaczyna bez pamięci. Bez rytuału startu zadziała domyślnie — skoczy do kodu, zignoruje stan, nadpisze cudzą pracę. 5 minut czytania ratuje godziny debugowania.

Kolejność czytania (5 min, ZANIM cokolwiek zrobisz)

1. CLAUDE.md (repo root, auto-loaded) — nienegocjowalne zasady harness'u (plan przed kodem, read before edit, jedna sprawa na commit, dyscyplina faz, tool failed → STOP).
2. Session brief (docs/session-briefs/next-session-phase{N}-brief.md) — aktualny stan, pierwsze zadanie, insights/gotchas.
3. Phase spec (zewnętrzny roadmap — ClickUp / Linear / Notion) — DoD bieżącej fazy.
4. Relevant ADR (zewnętrzny doc lub docs/adr/) — decyzje architektoniczne wpływające na bieżący zakres.
5. Credentials (.env.*.local lub inny plik gitignored) — fallback dla connection strings.

Kick-off wiadomość (paste on start)

Jestem nową sesją Claude dla <project>. Przeczytaj:
1. CLAUDE.md
2. docs/session-briefs/next-session-phase{N}-brief.md
3. <phase spec link>
4. <relevant ADR link>

Działaj zgodnie z harness'em. Plan przed kodem. Czekaj na GO.

Infra quick-check (uruchom przed pierwszym commitem)

# branch
git switch <feature-branch> && git pull

# harness sanity
cat CLAUDE.md | head -40  # zasady nienegocjowalne

# test env live (jeśli masz)
curl -s <backend-test-url>/health

# Auth check (jeśli potrzeba)
<cli> whoami --json | head -3
# jeśli 401 → <cli> login w Terminal.app, nie Claude Code bash

# DB/vector quick check
psql "<test-pooler-url>" -c "SELECT ..."

Pre-flight checklist (przed pierwszym planem)

• Phase spec przeczytany (DoD jasne)
• Relevant ADR przeczytany
• git log -5 --oneline + git status sprawdzone
• Test env zweryfikowany (health, pooler, auth)
• Credentials zlokalizowane
• Wiem, jaki jest pierwszy konkretny task

Co NIE robić na starcie

• NIE edytować żadnego pliku przed przeczytaniem CLAUDE.md + briefa
• NIE ufać swojej pamięci z poprzedniej sesji (nie masz pamięci)
• NIE zgadywać stanu — czytaj brief
• NIE pomijać quick-check (30 sekund — oszczędza godziny)
• NIE zaczynać od git push lub git reset — najpierw sprawdź stan

Zamknięcie sesji

Przed końcem sesji zawsze:

1. Status note w zewnętrznym systemie (data, co done, co next, co blocked)
2. Jeśli faza zamknięta → utwórz next-session-phase{N+1}-brief.md
3. git log -5 --oneline — czy commits są atomowe?
4. TODO list odzwierciedla stan

Zostawienie następnej sesji "świeżego" briefa to największy prezent, jaki możesz sobie zrobić na rano.