fixing-bugs-systematically

Umiejętność Claude'a do strukturalnego rozwiązywania problemów w kodzie. Prowadzi Cię przez odtworzenie błędu, zbadanie kodu, identyfikację przyczyny głównej i wdrożenie naprawy. Używaj gdy coś się psuje, pojawiają się błędy, spada wydajność lub zachowanie aplikacji jest nieoczekiwane. Obsługuje zarówno proste problemy z oczywistym źródłem, jak i złożone błędy rozproszone w wielu modułach.

1. Przygotuj kontekst błędu — zbierz dokumentację dotyczącą uszkodzonej funkcji, w tym specyfikacje funkcji (docs/feature-spec/), historie użytkownika (docs/user-stories/), kontrakty API (docs/api-contracts.yaml) i architekturę systemu (docs/system-design.md).

2. Udokumentuj problem — opisz oczekiwane zachowanie (powołując się na kryteria akceptacji lub specyfikację), rzeczywiste zachowanie, kroki do odtworzenia błędu oraz identyfikatory funkcji (F-##) i historii (US-###) jeśli je znasz.

3. Dla błędów oczywistych — użyj bezpośredniego śledztwa: wyszukaj komunikaty błędów w kodzie (grep), przeczytaj podejrzane pliki, śledź wywołania funkcji i transformacje danych, sprawdź powiązaną logikę w innych plikach.

4. Dla błędów złożonych — deleguj badanie do równoległych agentów: wyznacz senior-engineer do śledzenia przepływu błędu przez konkretny podsystem, wyznacz Explore do mapowania przepływu danych między plikami i lokalizacji wszystkich obsług błędów.

5. Przeanalizuj wyniki — zbierz wnioski z równoległych badań, zidentyfikuj wspólny punkt awarii i przyczynę główną.

6. Wdrażaj naprawę — zaimplementuj ukierunkowaną poprawkę na podstawie zidentyfikowanej przyczyny i zwaliduj rozwiązanie poprzez testy odtworzenia i sprawdzenie powiązanych funkcji.