wiring

Umiejętność weryfikacji połączeń (wiring) w infrastrukturze Claude. Zapewnia, że każdy zbudowany moduł ma jasny punkt wejścia i jest faktycznie osiągalny z kodu. Przewodnik obejmuje czterokrokową kontrolę: potwierdzenie punktu wejścia, śledzenie grafu wywołań, testy end-to-end oraz eliminację martwego kodu. Pomaga uniknąć fałszywego poczucia bezpieczeństwa z powodu nieużywanego kodu, który tworzy obciążenie konserwacyjne.

1. Przed oznaczeniem infrastruktury jako gotowej, sprawdź cztery elementy: czy istnieje punkt wejścia (hook, rejestracja, skrypt, import), czy potrafisz prześledzić ścieżkę od wejścia do wykonania, czy test end-to-end obejmuje tę ścieżkę, oraz czy każdy zbudowany komponent jest rzeczywiście osiągalny. 2. Zweryfikuj punkt wejścia, szukając rejestracji w .claude/settings.json, aktywacji umiejętności w .claude/skill-rules.json, pliku skryptu w scripts/ oraz importów modułu w kodzie źródłowym. 3. Śledzenie grafu wywołań: zacznij od hooka (np. .claude/hooks/pre-tool-use.sh), przejdź przez wrapper (npx tsx), następnie do skryptu Pythona (spawn), importu modułu i ostatecznie wykonania funkcji. 4. Testuj pełną ścieżkę invokacji, a nie tylko testy jednostkowe modułu — uruchom test integracyjny, który ćwiczy cały łańcuch od hooka do wykonania. 5. Udokumentuj wiring w pliku README: wymień punkt wejścia, rejestrację, pełną ścieżkę wywołania i test integracyjny, który to weryfikuje. 6. Unikaj budowania bez weryfikacji — kod, który nikt nie importuje ani nie wywołuje, staje się obciążeniem konserwacyjnym i źródłem fałszywej pewności.