Aurora AIOpisz swój przypadek

Oferta

UsługiProduktyRealizacje

Dla kogo

Private EquityEnterpriseMŚP
UsługiProduktyRealizacjeO nasBlogKontakt

Baza wiedzy

Start tutajWikiSłownikPrzewodniki

Praca z Claude Baza wiedzy

Zmuś Claude Code do procesu — dyscyplina zamiast jednego promptu

Claude Code daje lepsze i tańsze wyniki, gdy przeprowadzisz go przez etapy: dopytaj, zaprojektuj, zaplanuj, zakoduj, sprawdź. Oto jak wymusić tę dyscyplinę.

Pojedyncza linia światła przechodzi przez pięć uporządkowanych bramek i na końcu wyłania się jako dopracowana, świetlista forma — zdyscyplinowany, wieloetapowy proces.
Pojedyncza linia światła przechodzi przez pięć uporządkowanych bramek i na końcu wyłania się jako dopracowana, świetlista forma — zdyscyplinowany, wieloetapowy proces.
Praca z Claude#claude-code #workflow #planowanie #tokeny #dyscyplina-procesu

Najdroższy sposób korzystania z narzędzi AI do kodowania to ten, który wygląda na najszybszy: piszesz jedno zdanie, model rusza budować od razu i po chwili dostajesz coś, co „prawie” jest tym, o co prosiłeś. Potem zaczynają się poprawki — runda druga, trzecia, czwarta — i nagle pozornie tania prośba zjada więcej czasu i tokenów niż gdybyś od początku zmusił model do namysłu. Pokażę ci proces, który to odwraca: pięć etapów, przez które warto przeprowadzić każde większe zadanie, oraz gotowy sposób, by model trzymał się ich sam.

Dlaczego jeden prompt zawodzi przy trudnym zadaniu

Najpierw dwa pojęcia, bo cały tekst krąży wokół nich. Claude Code to narzędzie, w którym Claude pracuje przy zadaniach programistycznych i operacyjnych — działa w terminalu (oknie, w którym wpisuje się komendy zamiast klikać przyciski), czyta pliki i wykonuje kroki. Token to fragment tekstu, którym model operuje — z grubsza kawałek słowa; za tokeny się płaci i to nimi mierzy się zużycie sesji.

Domyślne zachowanie takiego narzędzia jest proste: prosisz o zbudowanie czegoś, a ono zaczyna budować. Przy drobiazgu to dobrze. Przy zadaniu choć trochę złożonym — raporcie, automatyzacji, niewielkim systemie — kończy się to znajomym zgrzytem. Model dowozi coś, co na pierwszy rzut oka wygląda sensownie, a ty patrzysz i myślisz: „to w ogóle nie o to mi chodziło”. Wtedy zaczynają się rundy poprawek, a każda z nich kosztuje kolejne tokeny i kolejny zniecierpliwiony moment.

Sednem problemu jest to, że model zgadł, czego chcesz, zamiast to ustalić. Nie dopytał o luki w twojej prośbie, nie pokazał, jak rozumie zadanie, nie rozłożył go na części. Po prostu ruszył. Moim zdaniem to najczęstszy i najdroższy błąd w pracy z narzędziami agentowymi (czyli takimi, które same wykonują zadania krok po kroku) — i nie wynika z tego, że model jest słaby. Wynika z tego, że pozwoliłeś mu pominąć etap, którego nie pominąłby żaden doświadczony wykonawca.

Pięć etapów dobrego wykonawcy

Pomyśl o różnicy między dwoma wykonawcami, którym zlecasz tę samą pracę. Jeden bierze twoją prośbę i od razu zaczyna budować. Drugi najpierw robi porządne rozpoznanie: dopytuje, rysuje plan, uzgadnia go z tobą, a dopiero potem sięga po narzędzia. Pierwszy bywa szybszy na starcie i wolniejszy na mecie, bo połowę pracy trzeba przerabiać. Drugi pracuje metodycznie i kończy raz.

Dyscyplina, którą warto wymusić na Claude Code, to dokładnie ten drugi tryb, rozbity na pięć etapów:

  1. Dopytaj. Zanim cokolwiek powstanie, model zadaje ci kilka konkretnych pytań, żeby wyciągnąć z twojej głowy to, czego nie napisałeś wprost. Dobrze poprowadzony etap to nie jedno pytanie, lecz kilka — celujących w te miejsca, w których twoja prośba miała luki.
  2. Zaprojektuj. Model proponuje, jak chce to zrobić — czasem kilka wariantów z plusami i minusami każdego. To moment, w którym widzisz kierunek, zanim zapadnie w kod.
  3. Zaplanuj. Powstaje szczegółowy plan: zadanie rozbite na małe kroki, każdy do wykonania w kilka minut, z dokładnym wskazaniem, gdzie i co się zmieni. Plan zostaje zapisany, więc można do niego wrócić.
  4. Zakoduj. Dopiero teraz model buduje — krok po kroku, według planu, zatrzymując się od razu, gdy natrafi na przeszkodę, zamiast zgadywać i brnąć dalej.
  5. Sprawdź. Na końcu następuje weryfikacja: model sprawdza, czy to, co powstało, faktycznie robi to, co miało robić, zanim ogłosi zadanie skończonym.

Cała wartość tej kolejności leży w jednym: większość kosztownych pomyłek powstaje na początku, a ujawnia się na końcu. Jeśli model źle zrozumiał zadanie w pierwszej minucie, dowiesz się o tym dopiero po godzinie pracy — i dopiero wtedy zaczniesz płacić za poprawki. Etapy „dopytaj” i „zaprojektuj” przesuwają ten moment prawdy na sam początek, gdy korekta jest tania.

Pięć uporządkowanych węzłów połączonych z lewej do prawej jedną akcentową linią — czysty, równomierny diagram procesu z pięciu etapów.
Pięć uporządkowanych węzłów połączonych z lewej do prawej jedną akcentową linią — czysty, równomierny diagram procesu z pięciu etapów.

Etapy „dopytaj” i „zaprojektuj” robią największą różnicę

Najłatwiej zlekceważyć dwa pierwsze etapy, bo wyglądają, jakby tylko opóźniały „prawdziwą” pracę. W praktyce to one decydują o wyniku.

Zacznę od dopytywania. Dobrze poprowadzone nie polega na jednym ogólnym „co dokładnie masz na myśli?”. Polega na kilku celnych pytaniach, które wydobywają z twojej głowy obraz, jaki nosisz w wyobraźni, ale nigdy go nie zapisałeś. Sam zauważasz wtedy rzeczy, których byś nie ujął w pierwotnej prośbie. To nie strata czasu — to przeniesienie nieporozumienia z końca procesu na jego początek.

Etap projektu idzie krok dalej. Zamiast opisywać plan słowami, model potrafi pokazać ci go w przeglądarce: kilka wariantów rozwiązania obok siebie, z plusami i minusami każdego, czasem nawet z poglądowym wyglądem tego, co ma powstać. Wybierasz wariant, który najlepiej odpowiada temu, o co ci chodziło — a jeśli żaden nie trafia, mówisz to teraz. To różnica między „nie, nie o to chodziło” wypowiedzianym przed budową a tym samym zdaniem wypowiedzianym po niej, gdy poprawka oznacza przerobienie całości. Zwróć uwagę, że ten tryb jest z natury rozmową: model pyta, ty odpowiadasz, on pokazuje, ty korygujesz. To dobre, dopóki jesteś przy klawiaturze — wymaga twojej obecności w pętli, nie nadaje się do puszczenia bez nadzoru.

Gotowy sposób, by model trzymał się procesu sam

Tę dyscyplinę można wpisać do Claude Code na stałe. Służy do tego darmowy, otwarty dodatek o nazwie Superpowers — zestaw „umiejętności” (gotowych instrukcji postępowania), które sprawiają, że przy złożonym zadaniu model sam przechodzi przez opisane etapy, zamiast od razu rzucać się do kodu.

Działa to dzięki jednej nadrzędnej umiejętności, która uruchamia się na początku każdej rozmowy i pełni rolę dyspozytora. Najpierw ogląda dostępne umiejętności — jest ich kilkanaście — i decyduje, których użyć do twojego zadania. Część dotyczy fazy projektu (burza mózgów, poglądowy podgląd w przeglądarce), część fazy wykonania (przejście planu krok po kroku z przystankami bezpieczeństwa, rozdzielanie niezależnych części na osobnych pomocniczych agentów), a część kontroli jakości (pisanie testów przed kodem, uporządkowane szukanie przyczyny błędu, weryfikacja przed zamknięciem zadania). Najważniejsze w praktyce jest to, że nie musisz tych umiejętności znać ani pamiętać — instalujesz dodatek raz i działa w tle. Jeśli chcesz mieć pewność, możesz na końcu prośby dopisać jedno zdanie: „skorzystaj z odpowiednich umiejętności, jeśli pasują tutaj”.

Jeden centralny węzeł spokojnie kieruje kilkoma mniejszymi, wyspecjalizowanymi węzłami satelitarnymi — motyw powściągliwej orkiestracji.
Jeden centralny węzeł spokojnie kieruje kilkoma mniejszymi, wyspecjalizowanymi węzłami satelitarnymi — motyw powściągliwej orkiestracji.

Jeden detal o instalacji warto znać. Taki dodatek najlepiej włączyć globalnie, na poziomie użytkownika, a nie osobno w każdym projekcie — wtedy nie musisz pamiętać, by dokładać go za każdym razem; po prostu jest obecny w każdej sesji Claude Code.

Mit drogiego procesu

Najczęstsza obawa brzmi: skoro model robi tyle dodatkowych kroków, musi spalać znacznie więcej tokenów. Brzmi logicznie, ale mija się z tym, gdzie naprawdę uciekają tokeny.

Warto spojrzeć na to trzeźwo. Przy zadaniach naprawdę prostych proces faktycznie zużywa więcej tokenów — całe to dopytywanie jest wtedy zbędne, bo prośba i tak jest jednoznaczna. Ale przy zadaniach średnich i złożonych zwykle bywa odwrotnie: przebiegi z procesem potrafią wyjść taniej niż jednostrzałowy prompt, mimo dodatkowych kroków na starcie. Nie chodzi przy tym o konkretny procent — pojedyncze pomiary niewiele znaczą — lecz o mechanizm, który za tym stoi.

Mechanizm jest jednak czytelny i to on jest tu lekcją, nie konkretny procent. Wartość procesu nie bierze się z dodatkowych kroków, lecz z tego, czemu te kroki zapobiegają: kosztownym powtórkom i cofaniu się. Tokeny, które „zaoszczędzasz” na pominięciu dopytywania, wydajesz potem z nawiązką na czterech rundach poprawek. Drugi, mniej oczywisty zysk to przewidywalność — przebiegi bez procesu bywają znacznie mniej przewidywalne, a ich zużycie tokenów potrafi się mocno wahać, podczas gdy proces trzyma je ciaśniej. Jakość kodu też wypadała wyraźnie lepiej tam, gdzie był proces: poprawność, struktura, obsługa błędów. Co warte uczciwego zaznaczenia, proces nie poprawia tego, czego model po prostu nie wie o twojej dziedzinie — wiedza merytoryczna pozostaje po stronie modelu i twojej.

Co z tego wynika

Najprostszy wniosek jest taki: dla zadań naprawdę prostych proces pomiń — kilkuprocentowy narzut nic ci nie da, a tylko spowolni oczywistą prośbę. Cała korzyść ujawnia się przy zadaniach złożonych, i rośnie wraz z ich złożonością.

Trwała zasada jest jednak szersza niż jakikolwiek dodatek. Z narzędziami AI do kodowania opłaca się pracować tak, jak pracuje dobry wykonawca: najpierw ustal, co dokładnie ma powstać, pokaż kierunek, rozłóż rzecz na kroki, a dopiero potem buduj i sprawdź wynik. Dodatek w rodzaju Superpowers jedynie wpisuje tę dyscyplinę na stałe, żebyś nie musiał jej pilnować ręcznie przy każdej prośbie. Następnym razem, gdy zlecisz modelowi coś poważniejszego, spróbuj jednej rzeczy przed naciśnięciem entera: dopisz, że ma najpierw zadać ci pytania i pokazać plan, zanim cokolwiek zbuduje. To jedno zdanie często oszczędza całą rundę poprawek.