fixing-bugs-systematically

Diagnose and fix bugs through systematic investigation, root cause analysis, and targeted validation. Use when something is broken, errors occur, performance degrades, or unexpected behavior manifests.

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.