Claude Code wtyczki: TDD i śledzenie git

Optymalizacja Claude Code: trzy wtyczki zamiast 39 agentów

Programista z ponad 3000 godzin doświadczenia w pracy z Claude Code zrezygnował z monolitycznego systemu składającego się z 39 agentów, 38 umiejętności i 25 poleceń na rzecz trzech wtyczek. Dzięki temu znacznie uprościł utrzymanie rozwiązania oraz jego adaptację do aktualizacji Anthropic — w tym rozszerzenia okna kontekstowego do 1 miliona tokenów. Takie podejście minimalizuje nadmierną inżynierię i skupia się na integracji sprawdzonych narzędzi.

Wcześniej Orchestrator Kit rozwiązywał problem degradacji kontekstu poprzez izolację podagentów. Każdy z nich działał w osobnym kontekście i zwracał wynik, zachowując czystość głównej sesji. Jednak częste aktualizacje API, nowe wzorce działania agentów oraz rosnące okno kontekstowe uczyniły ten system niepotrzebnie skomplikowanym.

Problemy monolitycznych systemów agentów

Utrzymanie 39 agentów wymagało ręcznej aktualizacji po każdej nowej wersji Claude Code. Umiejętności i polecenia z czasem przestarzały, tracąc optymalizację pod nowe możliwości. Kluczowym czynnikiem był przejście od 100 tys. dostępnych tokenów do 900 tys.: izolacja kontekstu straciła swoje uzasadnienie.

Główne wady:

• Przestarzałe wzorce: agenty napisane w październiku 2025 r. nie wykorzystywały nowego interfejsu API Agent tool w styczniu 2026 r.,
• Ręczna weryfikacja: testowanie 25 poleceń po każdej aktualizacji zajmowało godziny,
• Nadmierna infrastruktura: nacisk przesunął się z tworzenia kodu na jego utrzymanie.

To klasyczna pułapka: rozwiązanie wczorajszych problemów staje się dziś wąskim gardłem.

Superpowers: wymuszona metodologia TDD

Superpowers autorstwa Jesse’a Vincenta wprowadza rygorystyczny proces rozwoju w Claude Code. Zamiast chaotycznego pisania kodu — ścisła sekwencja: burza mózgów, planowanie, TDD, przeglądy kodu i weryfikacja.

Dla zadania „Dodaj autoryzację JWT”:

• Claude uruchamia brainstorming: doprecyzowuje wymagania i proponuje opcje,
• Przechodzi do writing-plans: dekomponuje zadanie na podzadania trwające po 2–5 minut,
• Wymuszany cykl TDD: RED (test kończący się błędem), GREEN (minimalny działający kod), REFACTOR (czytelnosc i optymalizacja).

Zasada TDD jest bezwzględna: kod produkcyjny pisany jest wyłącznie po utworzeniu testu kończącego się błędem, który potwierdza brak danej funkcjonalności. To skutecznie zapobiega halucynacjom modelu.

Weryfikacja przed zakończeniem

Umiejętność verification-before-completion wymaga:

• Określenia polecenia do zweryfikowania wyniku,
• Nowego uruchomienia (bez użycia pamięci podręcznej),
• Analizy pełnego wyjścia,
• Potwierdzenia sukcesu.

Bez tego Claude często deklarował „gotowe”, opierając się na założeniach, a nie faktach.

Beads: śledzenie zadań wspierane przez Git

Beads autorstwa Steve’a Yegge przechowuje zadania jako pliki w repozytorium Git, zapewniając trwałość między sesjami. Podstawowe polecenia:

• bd create -t feature "Autoryzacja JWT" — tworzy zadanie z natychmiastowym commitem,
• bd ready — wyświetla zadania gotowe do realizacji (bez blokad),
• bd prime — przywraca stan projektu przy starcie nowej sesji.

Zalety:

• Obsługa wielu terminali: wyłączne blokady zapobiegają konfliktom,
• Wykres zależności: automatyczne zarządzanie kolejnością zadań,
• Historia w Git: pełna kronika decyzji bez ryzyka utraty danych przy kompresji kontekstu.

To zastępuje rosnące pliki specyfikacji i plan.json, znacznie upraszczając nawigację.

Template Bridge: integracja i katalog szablonów

Własna wtyczka Template Bridge integruje Superpowers i Beads poprzez umiejętność unified-workflow. Proces wygląda następująco:

• Tworzenie epika: bd create -t epic "Autoryzacja JWT",
• Burza mózgów i opracowanie planu,
• Podzadania z zależnościami:

bd create "Schemat tabeli tokens"
bd create "Middleware weryfikacyjny"
bd dep add middleware tokens

• bd ready aktualizuje widok gotowości na froncie.

template-catalog udostępnia dostęp do ponad 413 agentów z repozytorium davila7/claude-code-templates w 26 kategoriach. Instalacja: npx claude-code-templates@latest --agent security/security-auditor --yes. Agenty są pobierane na żądanie i usuwane po użyciu.

Co ma kluczowe znaczenie

• Skalowalność: trzy wtyczki zamiast 102 komponentów — aktualizacje są automatyczne i dostarczane przez twórców,
• Wymuszanie TDD: cykl czerwony–zielony–refaktoring jako obowiązkowy etap znacznie zmniejsza błędy spowodowane halucynacjami,
• Trwałość: śledzenie zadań w Git gwarantuje zachowanie kontekstu sesji i historii projektu,
• Elastyczność: dynamiczne ładowanie szablonów bez konieczności ich lokalnego przechowywania,
• Efektywność: nacisk na metodologię, a nie na infrastrukturę.

Porównanie podejść

| Aspekt | Orchestrator Kit | Nowe wtyczki |

|--------|------------------|---------------|

| Komponenty | 39 agentów + 38 umiejętności + 25 poleceń | 3 wtyczki + 2 umiejętności + 1 polecenie |

| Aktualizacje | Ręczne | Automatyczne |

| Kontekst | Izolacja podagentów | 900 tys. tokenów + trwałość w Git |

| Metodologia | Opcjonalna | Wymuszana TDD + weryfikacja |

Nowy stos rozwiązuje te same problemy przy znacznie mniejszym nakładzie na utrzymanie i lepiej adaptuje się do ewolucji Claude Code.

— Editorial Team