troubleshooting

Diagnose and resolve common issues during spec-driven development and implementation. Learn strategies for handling spec-reality divergence, dependency blocks, unclear requirements, and other execution challenges.

1. Zainstaluj umiejętność w swoim edytorze (Claude Code, Cursor, VS Code lub Windsurf), dodając plik troubleshooting do katalogu skills.

2. Zidentyfikuj problem, który blokuje Twoją pracę: kod nie zgadza się ze specyfikacją, API jest niedostępne, wymagania są niejasne, testy nie przechodzą, wydajność nie spełnia oczekiwań lub pojawiają się problemy z integracją.

3. Dla rozbieżności między specyfikacją a rzeczywistością: najpierw dokumentuj dokładnie, gdzie pojawił się problem, a następnie oceń, czy to drobna zmiana czy fundamentalna kwestia. Jeśli to detal — zaktualizuj sekcję design w specyfikacji i kontynuuj. Jeśli to poważny problem — wróć do fazy projektowania i ponownie przeanalizuj założenia.

4. W przypadku niejasnych wymagań lub blokad zależności: zatrzymaj się i wyjaśnij implikacje przed dalszą implementacją. Zdokumentuj, dlaczego obecne wymagania mogą być niemożliwe do spełnienia, zaproponuj alternatywę i uzyskaj akceptację interesariuszy.

5. Stosuj strategię odpowiednią do skali problemu: dla zmian kosmetycznych wystarczy aktualizacja specyfikacji, dla zmian architektonicznych powróć do projektowania, a dla niemożliwych do spełnienia wymagań negocjuj zmianę zakresu z zespołem.

6. Po rozwiązaniu problemu zaktualizuj całą specyfikację, podziel pracę na nowe zadania i wznów implementację z poprawnym planem.