name: auto-init
description: CCv2 inicjalizacja trybu auto - wywiad + CONTINUITY + VALIDATION. Triggers: auto-init, auto init, inicjuj auto, plan auto
allowed-tools: AskUserQuestion, Read, Write, Edit, Glob, Grep, Task
/auto-init - CCv2 Auto Mode Initialization v2.6 (Hybrid + Min10 + MandatoryDelegation)
⛔ KRYTYCZNE - PRZECZYTAJ NAJPIERW!
DO ZADAWANIA PYTAŃ MUSISZ UŻYĆ NARZĘDZIA AskUserQuestion!
AskUserQuestion(
questions: [
{ question: "...", header: "Cel", options: [...], multiSelect: false }
]
)
- ❌ NIE WOLNO pisać pytań jako zwykły tekst
- ❌ NIE WOLNO wypisywać opcji A) B) C) D) w wiadomości
- ✅ MUSISZ użyć tool AskUserQuestion
- ✅ CZEKAJ na odpowiedź przed kontynuacją
Przeprowadź GŁĘBOKI wywiad i utwórz pliki CONTINUITY.md + VALIDATION.md dla trybu autonomicznego.
FILOZOFIA:
- CONTINUITY = maksymalnie rozbudowany (dla resume po /clear)
- VALIDATION = prosty + priorytety (dla iteracji)
Faza 1: Rozpoznanie kontekstu
1.1 Sprawdź istniejące pliki:
Glob: logs/CONTINUITY.md, VALIDATION.md, README.md, package.json, requirements.txt
- Czy projekt istnieje? Jaka struktura?
- Czy są już pliki CCv2?
1.2 Jeśli CONTINUITY.md lub VALIDATION.md ISTNIEJĄ:
WAŻNE: Użytkownik wywołał /auto-init mimo że pliki istnieją = chce NOWY PLAN.
Przeczytaj istniejące pliki i znajdź:
- Nieukończone taski
[ ] z VALIDATION.md
- Nieukończone taski
[ ] i [→] z CONTINUITY.md State
- Open Questions bez odpowiedzi
- Blokery które nie zostały rozwiązane
Zapytaj użytkownika (AskUserQuestion):
Znalazłem istniejące pliki CCv2:
- logs/CONTINUITY.md (Status: [status])
- VALIDATION.md ([X] ukończonych / [Y] total)
Nieukończone z obecnych plików:
- [ ] task 1
- [ ] task 2
- [→] task 3 (w trakcie)
Co chcesz zrobić?
Opcje:
- "Zastąp całkowicie" - nowy plan, stare pliki zarchiwizowane
- "Przenieś nieukończone" - nowy plan + nieukończone taski z poprzedniego
- "Anuluj" - nie rób nic
Jeśli "Zastąp całkowicie":
- Przenieś stare pliki do
logs/archive/CONTINUITY-[data].md
- Kontynuuj wywiad od nowa
Jeśli "Przenieś nieukończone":
- Zapisz listę nieukończonych tasków
- Kontynuuj wywiad
- W Fazie 4 dodaj nieukończone do nowych plików (sekcja "Przeniesione z poprzedniego planu")
1.3 Sprawdź dostępne szablony:
~/.templates/validation/
├── web-frontend.md
├── web-backend.md
├── api-rest.md
├── android-app.md
├── cli-tool.md
├── python-script.md
├── documentation.md
├── pwa-capacitor.md
├── flutter-app.md
├── go-app.md
├── rust-app.md
├── devops.md
Faza 2: GŁĘBOKI WYWIAD (MINIMUM 10 rund, do 20)
⚠️ DLACZEGO TAK DUŻO PYTAŃ?
CCv2 Philosophy: Im więcej szczegółów w CONTINUITY i VALIDATION:
- ✅ Lepszy resume po /clear (nie tracimy kontekstu)
- ✅ Mniej zgadywania podczas pracy autonomicznej
- ✅ Mniej "nie wiem" i błędnych założeń
- ✅ Wyższe prawdopodobieństwo poprawnego wyniku końcowego
5 rund = za mało. W 5 rundach użytkownik nie przekaże wszystkiego co istotne.
⚠️ OBOWIĄZKOWE: Użyj narzędzia AskUserQuestion!
MUSISZ użyć AskUserQuestion tool do zadawania pytań!
- NIE pisz pytań jako zwykły tekst
- NIE zakładaj odpowiedzi
- CZEKAJ na odpowiedzi użytkownika przed kontynuacją
- Zadawaj 2-4 pytania na raz (multiSelect gdzie sensowne)
- MINIMUM 10 rund - nie kończ wcześniej nawet jeśli wydaje się że masz dość info
ZASADY WYWIADU:
- ✅ Pytaj o CEL BIZNESOWY i EFEKT KOŃCOWY
- ✅ Pytaj o funkcjonalności z perspektywy UŻYTKOWNIKA
- ✅ Pytaj o obawy, ryzyka, blokery
- ✅ Pytaj o priorytety (MVP vs Full)
- ✅ Pytaj o zależności i integracje
- ✅ DYNAMICZNIE generuj pytania na podstawie odpowiedzi
- ❌ NIE pytaj o techniczne szczegóły (frameworki, biblioteki)
- ❌ NIE zakładaj - PYTAJ
FORMAT:
- Użyj
AskUserQuestion z 2-4 pytaniami
- Przeanalizuj odpowiedzi
- Wygeneruj follow-up pytania na podstawie odpowiedzi
- Powtarzaj dopóki masz PEŁNY obraz projektu
RUNDA 1: Wizja projektu
- "Co dokładnie ma powstać? Opisz efekt końcowy tak jakbyś pokazywał gotowy produkt."
- "Jaki problem to rozwiązuje? Dlaczego to budujesz?"
- "Kto będzie tego używał? (ty, klient, zespół, publiczność)"
RUNDA 2: Użytkownicy i kontekst
- "Opisz typowego użytkownika - kim jest, co robi, czego potrzebuje?"
- "W jakim kontekście będą używać produktu? (praca, dom, w ruchu)"
- "Czy użytkownicy mają specjalne potrzeby? (dostępność, język, urządzenia)"
DYNAMICZNE: Jeśli użytkownik wspomniał o "klientach" → pytaj o ich branżę, wielkość, oczekiwania
RUNDA 3: Funkcjonalności core
- "Jakie są 3-5 NAJWAŻNIEJSZYCH funkcji? (te bez których produkt nie ma sensu)"
- "Co użytkownik ma móc zrobić krok po kroku? (user journey)"
- "Czy są funkcje które MUSZĄ działać offline?"
DYNAMICZNE: Dla każdej wymienionej funkcji → "Opisz dokładniej jak ma działać [funkcja X]"
RUNDA 4: Funkcjonalności szczegółowe
- "Czy potrzebna jest rejestracja/logowanie użytkowników?"
- "Czy są dane do przechowywania? Jakie?"
- "Czy potrzebne są powiadomienia? (email, push, SMS)"
- "Czy potrzebna jest integracja z innymi systemami?"
DYNAMICZNE:
- Jeśli logowanie → "OAuth, email/hasło, czy oba?"
- Jeśli dane → "Czy dane są wrażliwe? (GDPR, medyczne, finansowe)"
- Jeśli integracje → "Z jakimi systemami? Czy mają API?"
RUNDA 5: UI/UX (jeśli ma interfejs)
- "Jak ma wyglądać? Masz referencje, mockupy, inspiracje?"
- "Czy ma być responsywne? (mobile, tablet, desktop)"
- "Czy jest design system / brand guidelines do przestrzegania?"
- "Jakie są najważniejsze ekrany/widoki?"
DYNAMICZNE:
- Jeśli mockupy → "Gdzie są? Czy mogę je zobaczyć?"
- Jeśli brand → "Jakie kolory, fonty, styl?"
RUNDA 6: MVP vs Full scope
- "Co MUSI być w pierwszej wersji (MVP)? (bez czego nie ma sensu wypuszczać)"
- "Co może poczekać na v2, v3?"
- "Gdybyś miał tylko 1 dzień - co byś zbudował?"
- "Gdybyś miał tydzień - co dodatkowo?"
DYNAMICZNE: Dla każdej funkcji MVP → "Czy ta funkcja ma dependencies?"
RUNDA 7: Kryteria sukcesu
- "Po czym poznasz że projekt jest GOTOWY?"
- "Jakie metryki będą świadczyć o sukcesie? (użytkownicy, konwersja, czas)"
- "Czy są konkretne benchmarki do osiągnięcia? (np. Lighthouse 90%+)"
- "Kto będzie akceptował że projekt jest 'done'?"
DYNAMICZNE:
- Jeśli metryki → "Jakie konkretne liczby?"
- Jeśli akceptacja → "Czy jest formalny proces review?"
RUNDA 8: Ryzyka i obawy
- "Co Cię NAJBARDZIEJ martwi w tym projekcie?"
- "Co może pójść nie tak? (techniczne, biznesowe, ludzkie)"
- "Czy były już próby zbudowania czegoś podobnego? Co poszło nie tak?"
- "Jakie są największe unknowns?"
DYNAMICZNE: Dla każdego ryzyka → "Jak możemy to zmitigować?"
RUNDA 9: Blokery i zależności
- "Czy są rzeczy które mogą ZABLOKOWAĆ pracę? (dostępy, dane, decyzje)"
- "Czy czekasz na coś od kogoś? (API, design, content)"
- "Czy są zewnętrzne serwisy od których zależysz?"
- "Czy potrzebujesz dostępu do czegoś czego nie masz?"
DYNAMICZNE:
- Jeśli blokery → "Kiedy się spodziewasz rozwiązania?"
- Jeśli zewnętrzne API → "Czy masz dokumentację? Klucze API?"
RUNDA 10: Ograniczenia
- "Czy są ograniczenia czasowe? (deadline, milestone)"
- "Czy są ograniczenia budżetowe? (hosting, API, licencje)"
- "Czy są ograniczenia technologiczne? (musi być X, nie może być Y)"
- "Czy są ograniczenia prawne? (GDPR, HIPAA, branżowe)"
DYNAMICZNE:
- Jeśli deadline → "Co się stanie jeśli go nie dotrzymasz?"
- Jeśli GDPR → "Jakie dane osobowe? Gdzie przechowywane?"
✅ CHECKPOINT: MINIMUM 10 RUND OSIĄGNIĘTE
Po rundzie 10 możesz przejść do Fazy 3, ALE:
- Rundy 11-20 są ZALECANE dla złożonych projektów
- Jeśli projekt ma: integracje, płatności, użytkowników, security → KONTYNUUJ
- Jeśli projekt prosty (1-2 dni pracy) → możesz zakończyć
Przed zakończeniem wywiadu ZAWSZE zapytaj:
"Czy jest coś o czym nie zapytałem a powinienem wiedzieć?"
RUNDA 11: Środowisko i deployment
- "Gdzie ma działać? (chmura, własny serwer, lokalnie)"
- "Czy są wymagania dot. hostingu? (region, certyfikaty)"
- "Jak ma wyglądać proces wdrożenia?"
- "Czy potrzebujesz CI/CD?"
DYNAMICZNE:
- Jeśli chmura → "AWS, GCP, Azure, Vercel, inne?"
- Jeśli CI/CD → "GitHub Actions, GitLab CI, inne?"
RUNDA 12: Testowanie i jakość
- "Jak chcesz testować? (automatyczne, manualne, oba)"
- "Czy są krytyczne ścieżki które MUSZĄ być przetestowane?"
- "Czy potrzebujesz testów wydajnościowych?"
- "Kto będzie robił QA?"
RUNDA 13: Dokumentacja i maintenance
- "Czy potrzebna jest dokumentacja? (techniczna, użytkownika, API)"
- "Kto będzie utrzymywał projekt po zakończeniu?"
- "Czy przewidujesz regularne aktualizacje?"
RUNDA 14: Konkurencja i inspiracje
- "Czy są podobne produkty na rynku? Co robią dobrze/źle?"
- "Czy masz przykłady które Ci się podobają? (linki, screenshoty)"
- "Czym Twój produkt ma się wyróżniać?"
DYNAMICZNE: Jeśli konkurencja → "Co chcesz zrobić LEPIEJ niż oni?"
RUNDA 15: Monetyzacja (jeśli dotyczy)
- "Czy produkt ma zarabiać? Jak?"
- "Czy jest model freemium/premium?"
- "Czy potrzebna jest integracja płatności?"
DYNAMICZNE:
- Jeśli płatności → "Stripe, PayPal, inne? Subskrypcje czy jednorazowe?"
- Jeśli freemium → "Co jest free, co premium?"
RUNDA 16: Analityka i monitoring
- "Czy potrzebujesz analityki? (Google Analytics, custom)"
- "Jakie metryki chcesz śledzić?"
- "Czy potrzebujesz error trackingu? (Sentry)"
- "Czy potrzebujesz logów/auditu?"
RUNDA 17: Bezpieczeństwo
- "Czy są dane wrażliwe? (hasła, finansowe, medyczne)"
- "Czy potrzebna jest szyfrowanie?"
- "Czy są wymagania compliance? (SOC2, ISO)"
- "Czy potrzebujesz rate limiting / ochrony przed botami?"
RUNDA 18: Skalowanie (jeśli dotyczy)
- "Ile użytkowników spodziewasz się? (teraz, za rok)"
- "Czy są peak times? (święta, kampanie)"
- "Czy system musi się automatycznie skalować?"
RUNDA 19: Komunikacja i współpraca
- "Czy pracujesz sam czy w zespole?"
- "Jak będziemy się komunikować podczas projektu?"
- "Jak często chcesz widzieć postępy?"
- "Czy są stakeholderzy do informowania?"
RUNDA 20: Podsumowanie i weryfikacja
- "Czy jest coś o czym nie zapytałem a powinienem wiedzieć?"
- "Czy moje zrozumienie projektu jest poprawne? [podsumuj]"
- "Czy są pytania do mnie zanim zaczniemy?"
DYNAMICZNE PYTANIA FOLLOW-UP:
Dla KAŻDEJ odpowiedzi sprawdź czy wymaga dopytania:
| Jeśli użytkownik mówi... |
Zapytaj dodatkowo... |
| "użytkownicy" |
Kim są? Ilu? Skąd przyjdą? |
| "dane" |
Jakie? Gdzie? Jak dużo? Wrażliwe? |
| "integracja" |
Z czym? Czy mają API? Dokumentację? |
| "mobile" |
iOS, Android, oba? PWA czy native? |
| "szybko" |
Jaki deadline? Co jeśli później? |
| "prosty" |
Prosty dla kogo? Co to znaczy? |
| "jak X" |
Pokaż X. Co dokładnie z X? |
| "później" |
Kiedy? Co blokuje teraz? |
| "nie wiem" |
Kto wie? Kiedy się dowiesz? |
| "zależy" |
Od czego? Jakie opcje? |
Faza 3: Analiza i wybór szablonu
3.1 Na podstawie wywiadu określ:
- Typ projektu: frontend / backend / fullstack / mobile / CLI / script
- Złożoność: simple (1-2 dni) / medium (tydzień) / complex (więcej)
- MVP scope: co jest absolutnie konieczne
- Blokery: co może zatrzymać pracę
- Ryzyka: co może pójść nie tak
3.2 Wybierz i dostosuj szablon:
- Przeczytaj najbliższy szablon z
~/.templates/validation/
- DODAJ punkty specyficzne dla projektu (z wywiadu)
- USUŃ punkty nieistotne dla tego projektu
- OZNACZ priorytety (🔴 MVP, 🟡 ważne, 🟢 v2)
Faza 4: Generowanie plików
4.1 CONTINUITY.md (logs/CONTINUITY.md) - ROZBUDOWANY
# Continuity Ledger - [Nazwa Projektu]
## Aktywna Sesja
**Urządzenie:** [PC/Android - wykryj z platform]
**Start:** [YYYY-MM-DD HH:MM]
**Cel:** [1-2 zdania z wywiadu - CEL BIZNESOWY]
**Status:** IN_PROGRESS
**Kontekst:** ~5% (updated: [HH:MM])
---
## Goal (Success Criteria)
Co musi być prawdą, żeby zadanie było DONE:
- [ ] [Kryterium 1 z wywiadu]
- [ ] [Kryterium 2 z wywiadu]
- [ ] [Kryterium 3 z wywiadu]
---
## Constraints (Wymagania techniczne)
- [Constraint 1 z wywiadu - np. "Mobile responsive"]
- [Constraint 2 z wywiadu - np. "Lighthouse 95%+"]
- [Constraint 3 z wywiadu - np. "GDPR compliant"]
---
## Phases (z estimated effort)
- [→] **Phase 1: [nazwa]** (~Xh) - [krótki opis]
- [ ] **Phase 2: [nazwa]** (~Xh) - [krótki opis]
- [ ] **Phase 3: [nazwa]** (~Xh) - [krótki opis]
**Total estimated:** ~XXh
---
## State (Postęp)
### Phase 1: [nazwa]
- [→] [Pierwszy task - CURRENT]
- [ ] [Task 2]
- [ ] [Task 3]
**Znaczniki:** `[x]` = done, `[→]` = CURRENT, `[ ]` = todo
---
## MVP Scope (z wywiadu)
**MUST HAVE (MVP):**
- [funkcja 1]
- [funkcja 2]
**SHOULD HAVE (v1.1):**
- [funkcja 3]
**COULD HAVE (v2):**
- [funkcja 4]
---
## Key Decisions (z wywiadu)
| Decyzja | Powód | Alternatywy |
|---------|-------|-------------|
| [decyzja 1] | [dlaczego] | [co odrzucone] |
| [decyzja 2] | [dlaczego] | [co odrzucone] |
---
## Open Questions (UNCONFIRMED)
### ❓ BLOCKING (muszę wiedzieć żeby kontynuować)
- [ ] [pytanie krytyczne]
### 💭 CLARIFICATION (warto wyjaśnić)
- [ ] [pytanie do wyjaśnienia]
---
## Working Set
**Pliki:**
- [plik1] - [opis]
- [plik2] - [opis]
**Branch:** [main/feature-X]
**Komendy testowe:**
```bash
[komenda testowa z wywiadu]
Blokery
🛑 BLOCKING NOW
⚠️ BLOCKING NEXT PHASE
Dependencies (z wywiadu)
External (poza naszą kontrolą)
Internal (nasza decyzja)
- Phase 2 wymaga Phase 1
- [inna zależność]
Risks (z wywiadu)
| Risk |
Impact |
Mitigation |
| [risk 1] |
High/Med/Low |
[jak zmitigować] |
Notatki
[Ważne informacje z wywiadu które nie pasują do innych sekcji]
Przeniesione z poprzedniego planu (jeśli dotyczy)
Poniższe taski zostały przeniesione z poprzedniego CONTINUITY.md ([data]):
Open Questions z poprzedniego planu:
Context Management
Thresholds
- 60% - zwiększ delegowanie do agentów
- 70% - zapisz stan, rozważ /clear
- 80% - MUSISZ zapisać i /clear
- 90% - KRYTYCZNE, natychmiast /clear
Przed /clear (OBOWIĄZKOWE)
- Zaktualizuj WSZYSTKIE sekcje powyżej
- Oznacz current task jako
[→]
- Zapisz Open Questions
- Dopiero potem
/clear
Po /clear
- Powiedz: "resume"
- Claude czyta CONTINUITY.md
- Weryfikuje stan vs rzeczywistość
- Kontynuuje od
[→]
---
### 4.2 VALIDATION.md (./VALIDATION.md) - SZCZEGÓŁOWE CHECKPOINTY
**⚠️ KRYTYCZNE:** Każdy checkpoint musi być:
- **TESTOWALNY** - jasne kryterium PASS/FAIL
- **SZCZEGÓŁOWY** - nie "PDF działa" ale "tekst nie ucięty, logo widoczne, kolory poprawne"
- **OBEJMUJĄCY EDGE CASES** - polskie znaki, długi tekst, puste dane
**❌ ZŁE checkpointy (zbyt ogólne):**
**✅ DOBRE checkpointy (szczegółowe, testowalne):**
PDF Export
**Dla KAŻDEJ funkcji rozpisz checkpointy w kategoriach:**
1. **Funkcjonalność** - czy działa podstawowa funkcja
2. **Wygląd/UI** - layout, typography, branding, kolory
3. **Edge cases** - długi tekst, puste dane, polskie znaki
4. **Responsywność** - mobile, tablet, desktop (jeśli dotyczy)
5. **Accessibility** - kontrast, aria-labels, keyboard (jeśli dotyczy)
**⚠️ MINIMUM checkpointów per sekcja:**
- **🔴 MVP funkcja:** minimum 8-12 checkpointów każda
- **🟡 IMPORTANT funkcja:** minimum 5-8 checkpointów każda
- **🟢 NICE TO HAVE:** minimum 3-5 checkpointów każda
**Budujemy plany na dni/tygodnie pracy. Obszerny plik = lepszy plan.**
**Nie oszczędzaj na checkpointach - każdy szczegół to mniej błędów później.**
---
```markdown
# VALIDATION: [Nazwa Projektu]
**Cel:** [cel z wywiadu]
**Status:** IN_PROGRESS
---
## 🔴 MVP (CRITICAL)
### [Kategoria 1 - np. Core Features]
- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
### [Kategoria 2 - np. UI/UX]
- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
---
## 🟡 IMPORTANT (v1.0)
### [Kategoria 3 - np. Quality]
- [ ] [checkpoint]
- [ ] [checkpoint]
### [Kategoria 4 - np. Testing]
- [ ] [checkpoint]
- [ ] [checkpoint]
---
## 🟢 NICE TO HAVE (v2)
### [Kategoria 5 - np. Extras]
- [ ] [checkpoint]
- [ ] [checkpoint]
---
## 📦 Przeniesione z poprzedniego planu (jeśli dotyczy)
> Nieukończone z poprzedniego VALIDATION.md ([data]):
- [ ] [checkpoint - nieukończony]
- [ ] [checkpoint - nieukończony]
---
## DONE Criteria
### MVP Done
- [ ] Wszystkie 🔴 checkboxy ✅
- [ ] [Kryterium z Goal w CONTINUITY]
- [ ] Brak blocking bugs
### Full Done
- [ ] Wszystkie 🔴 + 🟡 checkboxy ✅
- [ ] [Dodatkowe kryterium]
Faza 4.5: DELEGACJA - Rozszerzenie checkpointów (KRYTYCZNE)
Dlaczego delegacja?
Agent główny ma "context fatigue" - robi wywiad + template + pliki.
Dedykowany agent skupiony na JEDNYM zagadnieniu:
- Myśli głęboko o edge cases
- Nie pomija accessibility, responsywności
- Produkuje 3-5x więcej checkpointów
Wynik: 52 checkpointów → 180+ checkpointów (sprawdzone empirycznie)
⚠️ KIEDY DELEGACJA JEST OBOWIĄZKOWA (nie opcjonalna!)
MUSISZ delegować jeśli KTÓRYKOLWIEK warunek jest spełniony:
| Warunek |
Sprawdzenie |
Akcja |
| Checkpointy < minimum |
Sekcja 🔴 MVP ma <8 checkpointów |
→ DELEGUJ tę sekcję |
| Duży projekt |
Złożoność = "complex" (>2 dni) |
→ DELEGUJ wszystkie sekcje MVP |
| UI/Frontend |
Projekt ma interfejs użytkownika |
→ DELEGUJ (accessibility, responsywność) |
| Integracje |
Projekt ma zewnętrzne API/serwisy |
→ DELEGUJ (error handling, edge cases) |
NIE MOŻESZ pominąć delegacji jeśli którykolwiek warunek powyżej jest spełniony.
Możesz pominąć delegację TYLKO jeśli WSZYSTKIE są prawdziwe:
- Projekt prosty (1-2 dni)
- Brak UI (CLI, script, konfiguracja)
- Brak integracji zewnętrznych
- Każda sekcja MVP ma ≥8 szczegółowych checkpointów
4.5.1 Dla KAŻDEJ sekcji 🔴 MVP w VALIDATION.md:
Uruchom osobnego agenta Task(Explore):
Task(subagent_type="Explore"):
"KONTEKST: Rozszerzamy VALIDATION.md dla projektu [nazwa].
Branding: [kolory, fonty z wywiadu].
ZADANIE:
Przeczytaj VALIDATION.md i dla sekcji '[NAZWA SEKCJI]'
rozpisz SZCZEGÓŁOWE, TESTOWALNE checkpointy (minimum 8-12).
Każdy checkpoint musi mieć jasne kryterium PASS/FAIL.
Rozpisz w kategoriach:
1. Funkcjonalność (podstawowe działanie)
2. Wygląd/UI (layout, branding, kolory, typography)
3. Edge cases (długi tekst, puste dane, polskie znaki, błędne dane)
4. Responsywność (mobile 320px, tablet 768px, desktop 1200px)
5. Accessibility (kontrast WCAG AA, focus visible, aria-labels)
6. Error handling (co gdy błąd, timeout, brak danych)
FORMAT: Zwróć TYLKO rozszerzoną sekcję markdown:
### [Nazwa Sekcji]
- [ ] checkpoint 1
- [ ] checkpoint 2
..."
4.5.2 Równoległe uruchomienie agentów
Dla efektywności uruchom 3-4 agentów RÓWNOLEGLE:
# Przykład dla 6 sekcji MVP:
Agent 1: V2 Engine Test + Backend API
Agent 2: Landing Page + Raport UI
Agent 3: PDF Export + Progress UX
Agent 4: i18n + Optimization + Security
Każdy agent dostaje 1-3 sekcje do rozszerzenia.
4.5.3 Zbierz wyniki i zaktualizuj VALIDATION.md
- Poczekaj na wszystkie agenty
- Zbierz rozszerzone sekcje
- Zastąp oryginalne sekcje w VALIDATION.md rozszerzonymi
- Sprawdź czy każda sekcja MVP ma minimum 8 checkpointów
4.5.4 Walidacja końcowa
Po delegacji sprawdź:
Jeśli sekcja ma <8 checkpointów → uruchom agenta ponownie dla tej sekcji.
Faza 5: Potwierdzenie
Pokaż użytkownikowi:
✅ CCv2 Auto-Init Complete (v2.5 + Agent Delegation)
📋 Utworzone pliki:
- logs/CONTINUITY.md - rozbudowany stan sesji (dla resume)
- VALIDATION.md - szczegółowa checklista rozszerzona przez agentów
🤖 Delegacja agentów:
- [X] sekcji rozszerzonych przez dedykowanych agentów
- [Y] checkpointów wygenerowanych (vs ~50 bez delegacji)
---
🎯 Cel: [cel z wywiadu]
📊 Phases:
1. [→] [phase 1] (~Xh)
2. [ ] [phase 2] (~Xh)
3. [ ] [phase 3] (~Xh)
⏱️ Total estimated: ~XXh
---
📈 MVP Scope (🔴):
- [funkcja 1]
- [funkcja 2]
🛑 Blockers:
- [bloker 1] - [status]
⚠️ Risks:
- [risk 1]
---
🚀 Gotowe do pracy!
Powiedz:
- "auto" - rozpocznij pracę autonomiczną
- "status" - pokaż postęp
- "resume" - wznów po /clear
Wskazówki implementacyjne
Wywiad:
- MINIMUM 10 rund - nie kończ wcześniej, nawet jeśli wydaje się że masz dość
- Nie kończ wywiadu przedwcześnie - lepiej za dużo pytań niż za mało
- Zapisuj WSZYSTKO - nawet pozornie nieistotne informacje
- Pytaj "dlaczego" - zrozum motywację, nie tylko wymagania
- Weryfikuj zrozumienie - podsumuj i potwierdź
- CCv2 Philosophy: Więcej szczegółów = wyższe prawdopodobieństwo sukcesu
CONTINUITY.md:
- Rozbudowany - im więcej kontekstu, tym lepszy resume
- Aktualizuj często - co 15-30 min lub po ważnym kroku
[→] marker - ZAWSZE oznacz current task przed /clear
- Zawiera: Goal, Constraints, Phases, State, MVP, Decisions, Questions, Working Set, Blockers, Dependencies, Risks, Context Management
VALIDATION.md:
- SZCZEGÓŁOWE checkpointy - każdy musi być testowalny (PASS/FAIL)
- Priorytety - 🔴 MVP / 🟡 Important / 🟢 Nice
- DONE Criteria - kiedy można powiedzieć "gotowe"
- Bazuj na szablonach z
~/.templates/validation/
- Dodaj checkboxy specyficzne dla projektu (z wywiadu)
Dla każdej funkcji rozpisz:
- Funkcjonalność (czy działa)
- Wygląd/UI (layout, branding, kolory)
- Edge cases (długi tekst, polskie znaki, puste dane)
- Responsywność (jeśli UI)
- Accessibility (jeśli UI)
❌ ZŁE: - [ ] PDF działa
✅ DOBRE: - [ ] Tekst nie ucięty, polskie znaki OK, logo w nagłówku
Istniejące pliki (re-init):
- Jeśli pliki CCv2 istnieją → użytkownik chce NOWY PLAN
- ZAWSZE pytaj co zrobić z nieukończonymi taskami
- Opcje: zastąp całkowicie / przenieś nieukończone / anuluj
- Przy "Przenieś" → dodaj sekcję "Przeniesione z poprzedniego planu"
- Przy "Zastąp" → archiwizuj stare do
logs/archive/
Estimated effort:
- Simple task: 1-2h
- Medium task: 4-8h
- Complex task: 2-5 dni
- Dodaj 20% buffer na nieoczekiwane problemy
Priorytety:
- 🔴 MVP/CRITICAL - bez tego produkt nie działa
- 🟡 IMPORTANT - potrzebne dla v1.0 release
- 🟢 NICE TO HAVE - może poczekać na v2
1---2name: auto-init3description: DO ZADAWANIA PYTAŃ MUSISZ UŻYĆ NARZĘDZIA AskUserQuestion!4---5
6---
7name: auto-init
8description: CCv2 inicjalizacja trybu auto - wywiad + CONTINUITY + VALIDATION. Triggers: auto-init, auto init, inicjuj auto, plan auto
9allowed-tools: AskUserQuestion, Read, Write, Edit, Glob, Grep, Task
10---
11
12# /auto-init - CCv2 Auto Mode Initialization v2.6 (Hybrid + Min10 + MandatoryDelegation)
13
14## ⛔ KRYTYCZNE - PRZECZYTAJ NAJPIERW!
15
16**DO ZADAWANIA PYTAŃ MUSISZ UŻYĆ NARZĘDZIA `AskUserQuestion`!**
17
18```
19AskUserQuestion(
20 questions: [
21 { question: "...", header: "Cel", options: [...], multiSelect: false }
22 ]
23)
24```
25
26- ❌ NIE WOLNO pisać pytań jako zwykły tekst
27- ❌ NIE WOLNO wypisywać opcji A) B) C) D) w wiadomości
28- ✅ MUSISZ użyć tool AskUserQuestion
29- ✅ CZEKAJ na odpowiedź przed kontynuacją
30
31---
32
33Przeprowadź GŁĘBOKI wywiad i utwórz pliki CONTINUITY.md + VALIDATION.md dla trybu autonomicznego.
34
35**FILOZOFIA:**
36- CONTINUITY = maksymalnie rozbudowany (dla resume po /clear)
37- VALIDATION = prosty + priorytety (dla iteracji)
38
39---
40
41## Faza 1: Rozpoznanie kontekstu
42
43### 1.1 Sprawdź istniejące pliki:
44```
45Glob: logs/CONTINUITY.md, VALIDATION.md, README.md, package.json, requirements.txt
46```
47- Czy projekt istnieje? Jaka struktura?
48- Czy są już pliki CCv2?
49
50### 1.2 Jeśli CONTINUITY.md lub VALIDATION.md ISTNIEJĄ:
51
52**WAŻNE:** Użytkownik wywołał /auto-init mimo że pliki istnieją = chce NOWY PLAN.
53
541. **Przeczytaj istniejące pliki** i znajdź:
55 - Nieukończone taski `[ ]` z VALIDATION.md
56 - Nieukończone taski `[ ]` i `[→]` z CONTINUITY.md State
57 - Open Questions bez odpowiedzi
58 - Blokery które nie zostały rozwiązane
59
602. **Zapytaj użytkownika (AskUserQuestion):**
61 ```
62 Znalazłem istniejące pliki CCv2:
63 - logs/CONTINUITY.md (Status: [status])
64 - VALIDATION.md ([X] ukończonych / [Y] total)
65
66 Nieukończone z obecnych plików:
67 - [ ] task 1
68 - [ ] task 2
69 - [→] task 3 (w trakcie)
70
71 Co chcesz zrobić?
72 ```
73
74 **Opcje:**
75 - "Zastąp całkowicie" - nowy plan, stare pliki zarchiwizowane
76 - "Przenieś nieukończone" - nowy plan + nieukończone taski z poprzedniego
77 - "Anuluj" - nie rób nic
78
793. **Jeśli "Zastąp całkowicie":**
80 - Przenieś stare pliki do `logs/archive/CONTINUITY-[data].md`
81 - Kontynuuj wywiad od nowa
82
834. **Jeśli "Przenieś nieukończone":**
84 - Zapisz listę nieukończonych tasków
85 - Kontynuuj wywiad
86 - W Fazie 4 dodaj nieukończone do nowych plików (sekcja "Przeniesione z poprzedniego planu")
87
88### 1.3 Sprawdź dostępne szablony:
89```
90~/.templates/validation/
91├── web-frontend.md
92├── web-backend.md
93├── api-rest.md
94├── android-app.md
95├── cli-tool.md
96├── python-script.md
97├── documentation.md
98├── pwa-capacitor.md
99├── flutter-app.md
100├── go-app.md
101├── rust-app.md
102├── devops.md
103```
104
105---
106
107## Faza 2: GŁĘBOKI WYWIAD (MINIMUM 10 rund, do 20)
108
109### ⚠️ DLACZEGO TAK DUŻO PYTAŃ?
110
111**CCv2 Philosophy:** Im więcej szczegółów w CONTINUITY i VALIDATION:
112- ✅ Lepszy resume po /clear (nie tracimy kontekstu)
113- ✅ Mniej zgadywania podczas pracy autonomicznej
114- ✅ Mniej "nie wiem" i błędnych założeń
115- ✅ Wyższe prawdopodobieństwo poprawnego wyniku końcowego
116
117**5 rund = za mało.** W 5 rundach użytkownik nie przekaże wszystkiego co istotne.
118
119### ⚠️ OBOWIĄZKOWE: Użyj narzędzia AskUserQuestion!
120
121**MUSISZ użyć `AskUserQuestion` tool do zadawania pytań!**
122- NIE pisz pytań jako zwykły tekst
123- NIE zakładaj odpowiedzi
124- CZEKAJ na odpowiedzi użytkownika przed kontynuacją
125- Zadawaj 2-4 pytania na raz (multiSelect gdzie sensowne)
126- **MINIMUM 10 rund** - nie kończ wcześniej nawet jeśli wydaje się że masz dość info
127
128### ZASADY WYWIADU:
129- ✅ Pytaj o CEL BIZNESOWY i EFEKT KOŃCOWY
130- ✅ Pytaj o funkcjonalności z perspektywy UŻYTKOWNIKA
131- ✅ Pytaj o obawy, ryzyka, blokery
132- ✅ Pytaj o priorytety (MVP vs Full)
133- ✅ Pytaj o zależności i integracje
134- ✅ DYNAMICZNIE generuj pytania na podstawie odpowiedzi
135- ❌ NIE pytaj o techniczne szczegóły (frameworki, biblioteki)
136- ❌ NIE zakładaj - PYTAJ
137
138### FORMAT:
1391. Użyj `AskUserQuestion` z 2-4 pytaniami
1402. Przeanalizuj odpowiedzi
1413. Wygeneruj follow-up pytania na podstawie odpowiedzi
1424. Powtarzaj dopóki masz PEŁNY obraz projektu
143
144---
145
146### RUNDA 1: Wizja projektu
1471. "Co dokładnie ma powstać? Opisz efekt końcowy tak jakbyś pokazywał gotowy produkt."
1482. "Jaki problem to rozwiązuje? Dlaczego to budujesz?"
1493. "Kto będzie tego używał? (ty, klient, zespół, publiczność)"
150
151---
152
153### RUNDA 2: Użytkownicy i kontekst
1544. "Opisz typowego użytkownika - kim jest, co robi, czego potrzebuje?"
1555. "W jakim kontekście będą używać produktu? (praca, dom, w ruchu)"
1566. "Czy użytkownicy mają specjalne potrzeby? (dostępność, język, urządzenia)"
157
158**DYNAMICZNE:** Jeśli użytkownik wspomniał o "klientach" → pytaj o ich branżę, wielkość, oczekiwania
159
160---
161
162### RUNDA 3: Funkcjonalności core
1637. "Jakie są 3-5 NAJWAŻNIEJSZYCH funkcji? (te bez których produkt nie ma sensu)"
1648. "Co użytkownik ma móc zrobić krok po kroku? (user journey)"
1659. "Czy są funkcje które MUSZĄ działać offline?"
166
167**DYNAMICZNE:** Dla każdej wymienionej funkcji → "Opisz dokładniej jak ma działać [funkcja X]"
168
169---
170
171### RUNDA 4: Funkcjonalności szczegółowe
17210. "Czy potrzebna jest rejestracja/logowanie użytkowników?"
17311. "Czy są dane do przechowywania? Jakie?"
17412. "Czy potrzebne są powiadomienia? (email, push, SMS)"
17513. "Czy potrzebna jest integracja z innymi systemami?"
176
177**DYNAMICZNE:**
178- Jeśli logowanie → "OAuth, email/hasło, czy oba?"
179- Jeśli dane → "Czy dane są wrażliwe? (GDPR, medyczne, finansowe)"
180- Jeśli integracje → "Z jakimi systemami? Czy mają API?"
181
182---
183
184### RUNDA 5: UI/UX (jeśli ma interfejs)
18514. "Jak ma wyglądać? Masz referencje, mockupy, inspiracje?"
18615. "Czy ma być responsywne? (mobile, tablet, desktop)"
18716. "Czy jest design system / brand guidelines do przestrzegania?"
18817. "Jakie są najważniejsze ekrany/widoki?"
189
190**DYNAMICZNE:**
191- Jeśli mockupy → "Gdzie są? Czy mogę je zobaczyć?"
192- Jeśli brand → "Jakie kolory, fonty, styl?"
193
194---
195
196### RUNDA 6: MVP vs Full scope
19718. "Co MUSI być w pierwszej wersji (MVP)? (bez czego nie ma sensu wypuszczać)"
19819. "Co może poczekać na v2, v3?"
19920. "Gdybyś miał tylko 1 dzień - co byś zbudował?"
20021. "Gdybyś miał tydzień - co dodatkowo?"
201
202**DYNAMICZNE:** Dla każdej funkcji MVP → "Czy ta funkcja ma dependencies?"
203
204---
205
206### RUNDA 7: Kryteria sukcesu
20722. "Po czym poznasz że projekt jest GOTOWY?"
20823. "Jakie metryki będą świadczyć o sukcesie? (użytkownicy, konwersja, czas)"
20924. "Czy są konkretne benchmarki do osiągnięcia? (np. Lighthouse 90%+)"
21025. "Kto będzie akceptował że projekt jest 'done'?"
211
212**DYNAMICZNE:**
213- Jeśli metryki → "Jakie konkretne liczby?"
214- Jeśli akceptacja → "Czy jest formalny proces review?"
215
216---
217
218### RUNDA 8: Ryzyka i obawy
21926. "Co Cię NAJBARDZIEJ martwi w tym projekcie?"
22027. "Co może pójść nie tak? (techniczne, biznesowe, ludzkie)"
22128. "Czy były już próby zbudowania czegoś podobnego? Co poszło nie tak?"
22229. "Jakie są największe unknowns?"
223
224**DYNAMICZNE:** Dla każdego ryzyka → "Jak możemy to zmitigować?"
225
226---
227
228### RUNDA 9: Blokery i zależności
22930. "Czy są rzeczy które mogą ZABLOKOWAĆ pracę? (dostępy, dane, decyzje)"
23031. "Czy czekasz na coś od kogoś? (API, design, content)"
23132. "Czy są zewnętrzne serwisy od których zależysz?"
23233. "Czy potrzebujesz dostępu do czegoś czego nie masz?"
233
234**DYNAMICZNE:**
235- Jeśli blokery → "Kiedy się spodziewasz rozwiązania?"
236- Jeśli zewnętrzne API → "Czy masz dokumentację? Klucze API?"
237
238---
239
240### RUNDA 10: Ograniczenia
24134. "Czy są ograniczenia czasowe? (deadline, milestone)"
24235. "Czy są ograniczenia budżetowe? (hosting, API, licencje)"
24336. "Czy są ograniczenia technologiczne? (musi być X, nie może być Y)"
24437. "Czy są ograniczenia prawne? (GDPR, HIPAA, branżowe)"
245
246**DYNAMICZNE:**
247- Jeśli deadline → "Co się stanie jeśli go nie dotrzymasz?"
248- Jeśli GDPR → "Jakie dane osobowe? Gdzie przechowywane?"
249
250---
251
252### ✅ CHECKPOINT: MINIMUM 10 RUND OSIĄGNIĘTE
253
254**Po rundzie 10 możesz przejść do Fazy 3, ALE:**
255- Rundy 11-20 są ZALECANE dla złożonych projektów
256- Jeśli projekt ma: integracje, płatności, użytkowników, security → KONTYNUUJ
257- Jeśli projekt prosty (1-2 dni pracy) → możesz zakończyć
258
259**Przed zakończeniem wywiadu ZAWSZE zapytaj:**
260> "Czy jest coś o czym nie zapytałem a powinienem wiedzieć?"
261
262---
263
264### RUNDA 11: Środowisko i deployment
26538. "Gdzie ma działać? (chmura, własny serwer, lokalnie)"
26639. "Czy są wymagania dot. hostingu? (region, certyfikaty)"
26740. "Jak ma wyglądać proces wdrożenia?"
26841. "Czy potrzebujesz CI/CD?"
269
270**DYNAMICZNE:**
271- Jeśli chmura → "AWS, GCP, Azure, Vercel, inne?"
272- Jeśli CI/CD → "GitHub Actions, GitLab CI, inne?"
273
274---
275
276### RUNDA 12: Testowanie i jakość
27742. "Jak chcesz testować? (automatyczne, manualne, oba)"
27843. "Czy są krytyczne ścieżki które MUSZĄ być przetestowane?"
27944. "Czy potrzebujesz testów wydajnościowych?"
28045. "Kto będzie robił QA?"
281
282---
283
284### RUNDA 13: Dokumentacja i maintenance
28546. "Czy potrzebna jest dokumentacja? (techniczna, użytkownika, API)"
28647. "Kto będzie utrzymywał projekt po zakończeniu?"
28748. "Czy przewidujesz regularne aktualizacje?"
288
289---
290
291### RUNDA 14: Konkurencja i inspiracje
29249. "Czy są podobne produkty na rynku? Co robią dobrze/źle?"
29350. "Czy masz przykłady które Ci się podobają? (linki, screenshoty)"
29451. "Czym Twój produkt ma się wyróżniać?"
295
296**DYNAMICZNE:** Jeśli konkurencja → "Co chcesz zrobić LEPIEJ niż oni?"
297
298---
299
300### RUNDA 15: Monetyzacja (jeśli dotyczy)
30152. "Czy produkt ma zarabiać? Jak?"
30253. "Czy jest model freemium/premium?"
30354. "Czy potrzebna jest integracja płatności?"
304
305**DYNAMICZNE:**
306- Jeśli płatności → "Stripe, PayPal, inne? Subskrypcje czy jednorazowe?"
307- Jeśli freemium → "Co jest free, co premium?"
308
309---
310
311### RUNDA 16: Analityka i monitoring
31255. "Czy potrzebujesz analityki? (Google Analytics, custom)"
31356. "Jakie metryki chcesz śledzić?"
31457. "Czy potrzebujesz error trackingu? (Sentry)"
31558. "Czy potrzebujesz logów/auditu?"
316
317---
318
319### RUNDA 17: Bezpieczeństwo
32059. "Czy są dane wrażliwe? (hasła, finansowe, medyczne)"
32160. "Czy potrzebna jest szyfrowanie?"
32261. "Czy są wymagania compliance? (SOC2, ISO)"
32362. "Czy potrzebujesz rate limiting / ochrony przed botami?"
324
325---
326
327### RUNDA 18: Skalowanie (jeśli dotyczy)
32863. "Ile użytkowników spodziewasz się? (teraz, za rok)"
32964. "Czy są peak times? (święta, kampanie)"
33065. "Czy system musi się automatycznie skalować?"
331
332---
333
334### RUNDA 19: Komunikacja i współpraca
33566. "Czy pracujesz sam czy w zespole?"
33667. "Jak będziemy się komunikować podczas projektu?"
33768. "Jak często chcesz widzieć postępy?"
33869. "Czy są stakeholderzy do informowania?"
339
340---
341
342### RUNDA 20: Podsumowanie i weryfikacja
34370. "Czy jest coś o czym nie zapytałem a powinienem wiedzieć?"
34471. "Czy moje zrozumienie projektu jest poprawne? [podsumuj]"
34572. "Czy są pytania do mnie zanim zaczniemy?"
346
347---
348
349### DYNAMICZNE PYTANIA FOLLOW-UP:
350
351Dla KAŻDEJ odpowiedzi sprawdź czy wymaga dopytania:
352
353| Jeśli użytkownik mówi... | Zapytaj dodatkowo... |
354|--------------------------|---------------------|
355| "użytkownicy" | Kim są? Ilu? Skąd przyjdą? |
356| "dane" | Jakie? Gdzie? Jak dużo? Wrażliwe? |
357| "integracja" | Z czym? Czy mają API? Dokumentację? |
358| "mobile" | iOS, Android, oba? PWA czy native? |
359| "szybko" | Jaki deadline? Co jeśli później? |
360| "prosty" | Prosty dla kogo? Co to znaczy? |
361| "jak X" | Pokaż X. Co dokładnie z X? |
362| "później" | Kiedy? Co blokuje teraz? |
363| "nie wiem" | Kto wie? Kiedy się dowiesz? |
364| "zależy" | Od czego? Jakie opcje? |
365
366---
367
368## Faza 3: Analiza i wybór szablonu
369
370### 3.1 Na podstawie wywiadu określ:
371- **Typ projektu:** frontend / backend / fullstack / mobile / CLI / script
372- **Złożoność:** simple (1-2 dni) / medium (tydzień) / complex (więcej)
373- **MVP scope:** co jest absolutnie konieczne
374- **Blokery:** co może zatrzymać pracę
375- **Ryzyka:** co może pójść nie tak
376
377### 3.2 Wybierz i dostosuj szablon:
3781. Przeczytaj najbliższy szablon z `~/.templates/validation/`
3792. DODAJ punkty specyficzne dla projektu (z wywiadu)
3803. USUŃ punkty nieistotne dla tego projektu
3814. OZNACZ priorytety (🔴 MVP, 🟡 ważne, 🟢 v2)
382
383---
384
385## Faza 4: Generowanie plików
386
387### 4.1 CONTINUITY.md (logs/CONTINUITY.md) - ROZBUDOWANY
388
389```markdown
390# Continuity Ledger - [Nazwa Projektu]
391
392## Aktywna Sesja
393
394**Urządzenie:** [PC/Android - wykryj z platform]
395**Start:** [YYYY-MM-DD HH:MM]
396**Cel:** [1-2 zdania z wywiadu - CEL BIZNESOWY]
397**Status:** IN_PROGRESS
398**Kontekst:** ~5% (updated: [HH:MM])
399
400---
401
402## Goal (Success Criteria)
403
404Co musi być prawdą, żeby zadanie było DONE:
405- [ ] [Kryterium 1 z wywiadu]
406- [ ] [Kryterium 2 z wywiadu]
407- [ ] [Kryterium 3 z wywiadu]
408
409---
410
411## Constraints (Wymagania techniczne)
412
413- [Constraint 1 z wywiadu - np. "Mobile responsive"]
414- [Constraint 2 z wywiadu - np. "Lighthouse 95%+"]
415- [Constraint 3 z wywiadu - np. "GDPR compliant"]
416
417---
418
419## Phases (z estimated effort)
420
421- [→] **Phase 1: [nazwa]** (~Xh) - [krótki opis]
422- [ ] **Phase 2: [nazwa]** (~Xh) - [krótki opis]
423- [ ] **Phase 3: [nazwa]** (~Xh) - [krótki opis]
424
425**Total estimated:** ~XXh
426
427---
428
429## State (Postęp)
430
431### Phase 1: [nazwa]
432
433- [→] [Pierwszy task - CURRENT]
434- [ ] [Task 2]
435- [ ] [Task 3]
436
437**Znaczniki:** `[x]` = done, `[→]` = CURRENT, `[ ]` = todo
438
439---
440
441## MVP Scope (z wywiadu)
442
443**MUST HAVE (MVP):**
444- [funkcja 1]
445- [funkcja 2]
446
447**SHOULD HAVE (v1.1):**
448- [funkcja 3]
449
450**COULD HAVE (v2):**
451- [funkcja 4]
452
453---
454
455## Key Decisions (z wywiadu)
456
457| Decyzja | Powód | Alternatywy |
458|---------|-------|-------------|
459| [decyzja 1] | [dlaczego] | [co odrzucone] |
460| [decyzja 2] | [dlaczego] | [co odrzucone] |
461
462---
463
464## Open Questions (UNCONFIRMED)
465
466### ❓ BLOCKING (muszę wiedzieć żeby kontynuować)
467- [ ] [pytanie krytyczne]
468
469### 💭 CLARIFICATION (warto wyjaśnić)
470- [ ] [pytanie do wyjaśnienia]
471
472---
473
474## Working Set
475
476**Pliki:**
477- [plik1] - [opis]
478- [plik2] - [opis]
479
480**Branch:** [main/feature-X]
481
482**Komendy testowe:**
483```bash
484[komenda testowa z wywiadu]
485```
486
487---
488
489## Blokery
490
491### 🛑 BLOCKING NOW
492- [ ] [bloker który zatrzymuje pracę TERAZ]
493
494### ⚠️ BLOCKING NEXT PHASE
495- [ ] [bloker dla kolejnej fazy]
496
497---
498
499## Dependencies (z wywiadu)
500
501### External (poza naszą kontrolą)
502- [ ] [API/serwis] - status: [ready/waiting/unknown]
503
504### Internal (nasza decyzja)
505- Phase 2 wymaga Phase 1
506- [inna zależność]
507
508---
509
510## Risks (z wywiadu)
511
512| Risk | Impact | Mitigation |
513|------|--------|------------|
514| [risk 1] | High/Med/Low | [jak zmitigować] |
515
516---
517
518## Notatki
519
520[Ważne informacje z wywiadu które nie pasują do innych sekcji]
521- [notatka 1]
522- [notatka 2]
523
524---
525
526## Przeniesione z poprzedniego planu (jeśli dotyczy)
527
528> Poniższe taski zostały przeniesione z poprzedniego CONTINUITY.md ([data]):
529
530- [ ] [task 1 - nieukończony]
531- [ ] [task 2 - nieukończony]
532
533> Open Questions z poprzedniego planu:
534- [ ] [pytanie bez odpowiedzi]
535
536---
537
538## Context Management
539
540### Thresholds
541- **60%** - zwiększ delegowanie do agentów
542- **70%** - zapisz stan, rozważ /clear
543- **80%** - MUSISZ zapisać i /clear
544- **90%** - KRYTYCZNE, natychmiast /clear
545
546### Przed /clear (OBOWIĄZKOWE)
5471. Zaktualizuj WSZYSTKIE sekcje powyżej
5482. Oznacz current task jako `[→]`
5493. Zapisz Open Questions
5504. Dopiero potem `/clear`
551
552### Po /clear
5531. Powiedz: "resume"
5542. Claude czyta CONTINUITY.md
5553. Weryfikuje stan vs rzeczywistość
5564. Kontynuuje od `[→]`
557```
558
559---
560
561### 4.2 VALIDATION.md (./VALIDATION.md) - SZCZEGÓŁOWE CHECKPOINTY
562
563**⚠️ KRYTYCZNE:** Każdy checkpoint musi być:
564- **TESTOWALNY** - jasne kryterium PASS/FAIL
565- **SZCZEGÓŁOWY** - nie "PDF działa" ale "tekst nie ucięty, logo widoczne, kolory poprawne"
566- **OBEJMUJĄCY EDGE CASES** - polskie znaki, długi tekst, puste dane
567
568**❌ ZŁE checkpointy (zbyt ogólne):**
569```
570- [ ] PDF export działa
571- [ ] Formularz działa
572- [ ] Strona wygląda OK
573```
574
575**✅ DOBRE checkpointy (szczegółowe, testowalne):**
576```
577### PDF Export
578- [ ] PDF generuje się bez błędów
579- [ ] PDF otwiera się w Chrome, Firefox, Adobe
580- [ ] Tekst min 10pt, czytelny
581- [ ] Tekst nie ucięty, nie wychodzi poza marginesy
582- [ ] Polskie znaki (ą,ę,ó) wyświetlają się poprawnie
583- [ ] Logo KMYLPENTER w nagłówku
584- [ ] Kolory brand (#3A90C8) poprawnie renderowane
585- [ ] Tabele/listy nie rozjeżdżają się
586- [ ] Rozmiar PDF < 5MB
587```
588
589**Dla KAŻDEJ funkcji rozpisz checkpointy w kategoriach:**
5901. **Funkcjonalność** - czy działa podstawowa funkcja
5912. **Wygląd/UI** - layout, typography, branding, kolory
5923. **Edge cases** - długi tekst, puste dane, polskie znaki
5934. **Responsywność** - mobile, tablet, desktop (jeśli dotyczy)
5945. **Accessibility** - kontrast, aria-labels, keyboard (jeśli dotyczy)
595
596**⚠️ MINIMUM checkpointów per sekcja:**
597- **🔴 MVP funkcja:** minimum 8-12 checkpointów każda
598- **🟡 IMPORTANT funkcja:** minimum 5-8 checkpointów każda
599- **🟢 NICE TO HAVE:** minimum 3-5 checkpointów każda
600
601**Budujemy plany na dni/tygodnie pracy. Obszerny plik = lepszy plan.**
602**Nie oszczędzaj na checkpointach - każdy szczegół to mniej błędów później.**
603
604---
605
606```markdown
607# VALIDATION: [Nazwa Projektu]
608
609**Cel:** [cel z wywiadu]
610**Status:** IN_PROGRESS
611
612---
613
614## 🔴 MVP (CRITICAL)
615
616### [Kategoria 1 - np. Core Features]
617- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
618- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
619- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
620
621### [Kategoria 2 - np. UI/UX]
622- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
623- [ ] [checkpoint SZCZEGÓŁOWY - testowalny]
624
625---
626
627## 🟡 IMPORTANT (v1.0)
628
629### [Kategoria 3 - np. Quality]
630- [ ] [checkpoint]
631- [ ] [checkpoint]
632
633### [Kategoria 4 - np. Testing]
634- [ ] [checkpoint]
635- [ ] [checkpoint]
636
637---
638
639## 🟢 NICE TO HAVE (v2)
640
641### [Kategoria 5 - np. Extras]
642- [ ] [checkpoint]
643- [ ] [checkpoint]
644
645---
646
647## 📦 Przeniesione z poprzedniego planu (jeśli dotyczy)
648
649> Nieukończone z poprzedniego VALIDATION.md ([data]):
650
651- [ ] [checkpoint - nieukończony]
652- [ ] [checkpoint - nieukończony]
653
654---
655
656## DONE Criteria
657
658### MVP Done
659- [ ] Wszystkie 🔴 checkboxy ✅
660- [ ] [Kryterium z Goal w CONTINUITY]
661- [ ] Brak blocking bugs
662
663### Full Done
664- [ ] Wszystkie 🔴 + 🟡 checkboxy ✅
665- [ ] [Dodatkowe kryterium]
666```
667
668---
669
670## Faza 4.5: DELEGACJA - Rozszerzenie checkpointów (KRYTYCZNE)
671
672### Dlaczego delegacja?
673
674Agent główny ma "context fatigue" - robi wywiad + template + pliki.
675Dedykowany agent skupiony na JEDNYM zagadnieniu:
676- Myśli głęboko o edge cases
677- Nie pomija accessibility, responsywności
678- Produkuje 3-5x więcej checkpointów
679
680**Wynik:** 52 checkpointów → 180+ checkpointów (sprawdzone empirycznie)
681
682---
683
684### ⚠️ KIEDY DELEGACJA JEST OBOWIĄZKOWA (nie opcjonalna!)
685
686**MUSISZ delegować jeśli KTÓRYKOLWIEK warunek jest spełniony:**
687
688| Warunek | Sprawdzenie | Akcja |
689|---------|-------------|-------|
690| **Checkpointy < minimum** | Sekcja 🔴 MVP ma <8 checkpointów | → DELEGUJ tę sekcję |
691| **Duży projekt** | Złożoność = "complex" (>2 dni) | → DELEGUJ wszystkie sekcje MVP |
692| **UI/Frontend** | Projekt ma interfejs użytkownika | → DELEGUJ (accessibility, responsywność) |
693| **Integracje** | Projekt ma zewnętrzne API/serwisy | → DELEGUJ (error handling, edge cases) |
694
695**NIE MOŻESZ pominąć delegacji** jeśli którykolwiek warunek powyżej jest spełniony.
696
697**Możesz pominąć delegację TYLKO jeśli WSZYSTKIE są prawdziwe:**
698- Projekt prosty (1-2 dni)
699- Brak UI (CLI, script, konfiguracja)
700- Brak integracji zewnętrznych
701- Każda sekcja MVP ma ≥8 szczegółowych checkpointów
702
703---
704
705### 4.5.1 Dla KAŻDEJ sekcji 🔴 MVP w VALIDATION.md:
706
707**Uruchom osobnego agenta Task(Explore):**
708
709```
710Task(subagent_type="Explore"):
711 "KONTEKST: Rozszerzamy VALIDATION.md dla projektu [nazwa].
712 Branding: [kolory, fonty z wywiadu].
713
714 ZADANIE:
715 Przeczytaj VALIDATION.md i dla sekcji '[NAZWA SEKCJI]'
716 rozpisz SZCZEGÓŁOWE, TESTOWALNE checkpointy (minimum 8-12).
717
718 Każdy checkpoint musi mieć jasne kryterium PASS/FAIL.
719
720 Rozpisz w kategoriach:
721 1. Funkcjonalność (podstawowe działanie)
722 2. Wygląd/UI (layout, branding, kolory, typography)
723 3. Edge cases (długi tekst, puste dane, polskie znaki, błędne dane)
724 4. Responsywność (mobile 320px, tablet 768px, desktop 1200px)
725 5. Accessibility (kontrast WCAG AA, focus visible, aria-labels)
726 6. Error handling (co gdy błąd, timeout, brak danych)
727
728 FORMAT: Zwróć TYLKO rozszerzoną sekcję markdown:
729 ### [Nazwa Sekcji]
730 - [ ] checkpoint 1
731 - [ ] checkpoint 2
732 ..."
733```
734
735---
736
737### 4.5.2 Równoległe uruchomienie agentów
738
739**Dla efektywności uruchom 3-4 agentów RÓWNOLEGLE:**
740
741```
742# Przykład dla 6 sekcji MVP:
743Agent 1: V2 Engine Test + Backend API
744Agent 2: Landing Page + Raport UI
745Agent 3: PDF Export + Progress UX
746Agent 4: i18n + Optimization + Security
747```
748
749**Każdy agent dostaje 1-3 sekcje do rozszerzenia.**
750
751---
752
753### 4.5.3 Zbierz wyniki i zaktualizuj VALIDATION.md
754
7551. Poczekaj na wszystkie agenty
7562. Zbierz rozszerzone sekcje
7573. Zastąp oryginalne sekcje w VALIDATION.md rozszerzonymi
7584. Sprawdź czy każda sekcja MVP ma minimum 8 checkpointów
759
760---
761
762### 4.5.4 Walidacja końcowa
763
764Po delegacji sprawdź:
765- [ ] Każda sekcja 🔴 MVP ma ≥8 checkpointów
766- [ ] Każda sekcja 🟡 IMPORTANT ma ≥5 checkpointów
767- [ ] Checkpointy są TESTOWALNE (nie ogólne)
768- [ ] Zawierają edge cases, accessibility, responsywność
769
770**Jeśli sekcja ma <8 checkpointów → uruchom agenta ponownie dla tej sekcji.**
771
772---
773
774## Faza 5: Potwierdzenie
775
776Pokaż użytkownikowi:
777
778```
779✅ CCv2 Auto-Init Complete (v2.5 + Agent Delegation)
780
781📋 Utworzone pliki:
782- logs/CONTINUITY.md - rozbudowany stan sesji (dla resume)
783- VALIDATION.md - szczegółowa checklista rozszerzona przez agentów
784
785🤖 Delegacja agentów:
786- [X] sekcji rozszerzonych przez dedykowanych agentów
787- [Y] checkpointów wygenerowanych (vs ~50 bez delegacji)
788
789---
790
791🎯 Cel: [cel z wywiadu]
792
793📊 Phases:
7941. [→] [phase 1] (~Xh)
7952. [ ] [phase 2] (~Xh)
7963. [ ] [phase 3] (~Xh)
797
798⏱️ Total estimated: ~XXh
799
800---
801
802📈 MVP Scope (🔴):
803- [funkcja 1]
804- [funkcja 2]
805
806🛑 Blockers:
807- [bloker 1] - [status]
808
809⚠️ Risks:
810- [risk 1]
811
812---
813
814🚀 Gotowe do pracy!
815
816Powiedz:
817- "auto" - rozpocznij pracę autonomiczną
818- "status" - pokaż postęp
819- "resume" - wznów po /clear
820```
821
822---
823
824## Wskazówki implementacyjne
825
826### Wywiad:
827- **MINIMUM 10 rund** - nie kończ wcześniej, nawet jeśli wydaje się że masz dość
828- **Nie kończ wywiadu przedwcześnie** - lepiej za dużo pytań niż za mało
829- **Zapisuj WSZYSTKO** - nawet pozornie nieistotne informacje
830- **Pytaj "dlaczego"** - zrozum motywację, nie tylko wymagania
831- **Weryfikuj zrozumienie** - podsumuj i potwierdź
832- **CCv2 Philosophy:** Więcej szczegółów = wyższe prawdopodobieństwo sukcesu
833
834### CONTINUITY.md:
835- **Rozbudowany** - im więcej kontekstu, tym lepszy resume
836- **Aktualizuj często** - co 15-30 min lub po ważnym kroku
837- **`[→]` marker** - ZAWSZE oznacz current task przed /clear
838- Zawiera: Goal, Constraints, Phases, State, MVP, Decisions, Questions, Working Set, Blockers, Dependencies, Risks, Context Management
839
840### VALIDATION.md:
841- **SZCZEGÓŁOWE checkpointy** - każdy musi być testowalny (PASS/FAIL)
842- **Priorytety** - 🔴 MVP / 🟡 Important / 🟢 Nice
843- **DONE Criteria** - kiedy można powiedzieć "gotowe"
844- Bazuj na szablonach z `~/.templates/validation/`
845- Dodaj checkboxy specyficzne dla projektu (z wywiadu)
846
847**Dla każdej funkcji rozpisz:**
8481. Funkcjonalność (czy działa)
8492. Wygląd/UI (layout, branding, kolory)
8503. Edge cases (długi tekst, polskie znaki, puste dane)
8514. Responsywność (jeśli UI)
8525. Accessibility (jeśli UI)
853
854**❌ ZŁE:** `- [ ] PDF działa`
855**✅ DOBRE:** `- [ ] Tekst nie ucięty, polskie znaki OK, logo w nagłówku`
856
857### Istniejące pliki (re-init):
858- Jeśli pliki CCv2 istnieją → użytkownik chce NOWY PLAN
859- **ZAWSZE pytaj** co zrobić z nieukończonymi taskami
860- Opcje: zastąp całkowicie / przenieś nieukończone / anuluj
861- Przy "Przenieś" → dodaj sekcję "Przeniesione z poprzedniego planu"
862- Przy "Zastąp" → archiwizuj stare do `logs/archive/`
863
864### Estimated effort:
865- Simple task: 1-2h
866- Medium task: 4-8h
867- Complex task: 2-5 dni
868- Dodaj 20% buffer na nieoczekiwane problemy
869
870### Priorytety:
871- 🔴 **MVP/CRITICAL** - bez tego produkt nie działa
872- 🟡 **IMPORTANT** - potrzebne dla v1.0 release
873- 🟢 **NICE TO HAVE** - może poczekać na v2