Domyślny workflow programistyczny

Speedwave domyślnie organizuje proces wytwarzania oprogramowania w uporządkowany, wieloetapowy cykl pracy zamiast bezpośredniego wprowadzania zmian w kodzie. Poniższy artykuł omawia poszczególne fazy pracy oraz punkty kontrolne wymagające akceptacji użytkownika. Pełne zestawienie wbudowanych wtyczek i skilli zawiera rozdział Wbudowane skille i wtyczki.

Doprecyzowanie wymagań i projektowanie

Gdy zlecasz wdrożenie nowej funkcji lub refaktoryzację, Claude rozpoczyna pracę od uszczegółowienia wymagań. Krótka faza analityczna pozwala na ustalenie celów biznesowych i technicznych, po czym model tworzy architekturę rozwiązania podzieloną na modułowe sekcje. Każdy fragment projektu jest przedstawiany do akceptacji przed przejściem do kolejnego kroku.

Odizolowane środowisko pracy

Po zaakceptowaniu koncepcji technicznej Speedwave przygotowuje odizolowaną gałąź Git lub środowisko worktree. Przed wprowadzeniem zmian środowisko wykonuje istniejące testy jednostkowe, tworząc zweryfikowany punkt odniesienia.

Szczegółowy plan wdrożenia

Speedwave dzieli zaakceptowany projekt na niewielkie, precyzyjnie zdefiniowane zadania implementacyjne. Każdy krok określa modyfikowane pliki, cele wdrożeniowe oraz kryteria weryfikacji. Użytkownik ma pełny wgląd w plan przed rozpoczęciem pisania kodu, co pozwala na wczesne korekty założeń.

Realizacja zadań przez subagentów

Każde zadanie z planu jest przypisywane do odrębnego subagenta zoptymalizowanego pod kątem konkretnego fragmentu pracy. Każdy wykonany etap podlega dwuetapowej weryfikacji: zgodności z założeniami planu oraz jakości i czystości wytworzonego kodu.

Podejście Test-Driven Development (TDD)

Przy realizacji zadań Speedwave stosuje dyscyplinę TDD: najpierw przygotowuje test jednostkowy lub integracyjny kończący się niepowodzeniem, następnie implementuje minimalny kod spełniający ten test, a na końcu przeprowadza refaktoryzację.

Automatyczny przegląd kodu

Po zakończeniu implementacji Speedwave analizuje wprowadzone zmiany względem pierwotnego planu, klasyfikując ewentualne rozbieżności według stopnia ważności.

Do bieżącej analizy zmian lokalnych lub przeglądu merge requestów na GitHubie i GitLabie służy polecenie /code-review (zobacz Przegląd kodu z AI). W przypadku zaawansowanego audytu polecenie /speedwave-code-review uruchamia równolegle czternastu wyspecjalizowanych recenzentów sprawdzających m.in. bezpieczeństwo, wydajność, pokrycie testami i redundancję kodu.

Finalizacja gałęzi

Po zakończeniu pracy i pozytywnym przejściu testów Speedwave pyta o preferowany sposób finalizacji: scalenie gałęzi (merge), utworzenie pull/merge requesta lub wyczyszczenie zmian. Żadne modyfikacje nie trafiają do głównego repozytorium bez Twojej wyraźnej zgody.

Ciągła weryfikacja i analiza przyczyn źródłowych

W przypadku napotkania błędów środowisko przeprowadza ustrukturyzowaną analizę przyczyn źródłowych (root-cause analysis) zamiast losowego poprawiania kodu. Każda informacja o pomyślnym zakończeniu zadania jest poprzedzona automatyczną weryfikacją testów.

Integracja z systemami zarządzania zadaniami

Workflow opisuje realizację zadań w ramach aktywnej sesji. Wymagania i user stories zarejestrowane w systemach Jira, Confluence lub Redmine integrują się bezpośrednio z krokami planu, jak opisano w rozdziale Planowanie i user stories.

Elastyczność i pomijanie planowania

W przypadku drobnych poprawek, jednolinijkowych zmian lub prostych zadań wystarczy poinstruować Claude bezpośrednio w prompcie, aby pominął szczegółową fazę planowania i od razu przeszedł do realizacji.