Jakosc kodu generowanego przez AI zalezy niemal calkowicie od tego, o co prosisz i jak to formlujesz. Ten przewodnik opisuje wzorce, ktore konsekwentnie daja lepsze wyniki z Claude Code.
Od zakresu zadan po prompty systemowe, od iteracyjnego doskonalenia po instrukcje wedlug rol. Praktyczne techniki, ktore mozesz zastosowac w nastepnej sesji kodowania.
Kiedy prosisz ludzkiego programiste o 'zbudowanie strony logowania', zadaje on pytania: ktory dostawca uwierzytelniania? Jakie pola? Czy obslugiwac OAuth? Komunikaty bledow? Stany ladowania?
Agenty kodujace AI probuja odpowiedziec na wszystkie te pytania samodzielnie. Czasem trafiaja. Czesto proponuja cos rozsadnego, ale nie to, czego chciales. Luka miedzy 'rozsadnym' a 'dokladnie trafnym' to własnie to, co zamyka inzynieria promptow.
Dobre prompty nie musza byc dlugie. Musza byc konkretne w kwestiach, ktore sa wazne, i milczec o tych, ktore nie sa. Ta rownowaga jest tematem tego przewodnika.
Wzorce, ktore poprawiaja wyniki niezaleznie od zadania.
Zamiast 'utworz komponent React, potem dodaj stan, potem dodaj style', opisz wynik koncowy: 'Zbuduj zwijany panel boczny, ktory wyswietla nazwy projektów, obsluguje przeciąganie do zmiany kolejnosci i uzywa naszego istniejacego motywu Tailwind.' Pozwol agentowi zdecydowac, jak to osiagnac.
Avoid
Utworz komponent. Dodaj useState. Dodaj przycisk przelaczania. Ostyluj za pomoca Tailwind.
Better
Zbuduj zwijany komponent panelu bocznego, ktory wyswietla projekty wedlug nazwy. Powinien obslugiwac przeciąganie do zmiany kolejnosci i pasowac do naszego ciemnego motywu (bg-[#111318], border-[#262b38]). Stan zwiniecia powinien przetrwac przeladowanie strony.
Agenty dzialaja najlepiej, gdy znaja granice. Okresl, ktore pliki modyfikowac (lub unikac), jakie wzorce stosowac i jak wyglada 'gotowe'. Zadania bez granic prowadza do rozleglych zmian, ktore trudno przeglądac.
Avoid
Zrefaktoryzuj system uwierzytelniania.
Better
Zrefaktoryzuj handler logowania w src/api/auth/login.ts, aby uzywal bcrypt zamiast sha256 do hashowania hasel. Nie zmieniaj logiki JWT ani obslugi ciasteczek sesji. Zaktualizuj powiazane testy w tests/auth/.
Claude Code moze czytac pliki twojego projektu, ale nie moze czytac twoich mysli. Jesli stosujesz jakas konwencje, preferujesz jakas biblioteke lub masz juz ustalony wzorzec, powiedz o tym. To oszczedza przerobek.
Avoid
Dodaj walidacje formularza.
Better
Dodaj walidacje formularza rejestracji uzywajac zod (juz uzywamy go w formularzu ustawien w src/forms/settings.ts). Wyswietlaj komunikaty bledow inline pod kazdym polem. Zastosuj ten sam styl bledow co w formularzu logowania.
Zlozone prompty ('zbuduj API, napisz testy, zaktualizuj dokumentacje i wdrozy') zmuszaja agenta do utrzymywania zbyt wielu celow naraz. Podziel zlezone prace na sekwencyjne, skoncentrowane zadania. Kazde bazuje na wyniku poprzedniego.
Avoid
Zbuduj strone profilu uzytkownika, napisz endpointy API, dodaj testy, zaktualizuj README i przy okazji napraw pasek nawigacji.
Better
Zbuduj endpoint GET /api/user/profile. Zwroc pola id, name, email i plan. Uzyj istniejacego middleware uwierzytelniania.
Jesli pierwszy wynik nie jest odpowiedni, dopracuj prompt zamiast zaczynac od zera. Claude zachowuje pełny kontekst rozmowy. Powiedz, co jest nie tak, co zmienic i co zachowac. Iteracja jest szybsza niz tworzenie od nowa.
Avoid
To jest zle. Zacznij od nowa i zbuduj komponent inaczej.
Better
Uklad jest dobry, ale breakpoint mobilny jest zly. Ponizej 768px ukladaj karty pionowo zamiast uzyc grida. Reszta niech zostanie bez zmian.
Prompty systemowe ustawiaja bazowe zachowanie agenta, zanim cokolwiek powiesz. To najbardziej niedoceniane narzędzie w kodowaniu z AI.
Prompt systemowy mowi agentowi, kim jest, na czym powinien sie skupic i czego unikac. Dotyczy kazdej wiadomosci w sesji. Mozna go traktowac jako opis stanowiska agenta.
AgentsRoom zawiera 14 promptow systemowych wedlug rol, po jednym dla kazdego typu agenta. Prompt agenta Frontend mowi mu, zeby skupil sie na komponentach, dostępnosci i responsywnym designie. Prompt agenta QA mowi mu, zeby myslal o przypadkach brzegowych i pisal kompleksowe testy. Mozesz je dostosowac lub napisac własne.
Jestes starszym programista frontend. Skup sie na komponentach React, stylach CSS/Tailwind, dostępnosci (WCAG AA) i responsywnym designie. Uzywaj istniejacej biblioteki komponentow projektu przed tworzeniem nowych. Preferuj kompozycje nad dziedziczenie. Pisz semantyczny HTML. Nigdy nie modyfikuj plików backendowych.
Najskuteczniejszy prompt nie jest wpisywany w czacie. Znajduje sie w twoim repozytorium.
CLAUDE.md to plik markdown w katalogu glownym projektu, ktory Claude Code czyta automatycznie. Zawiera strukture projektu, konwencje, szczegoly stosu technologicznego i wytyczne dotyczace kazdej sesji agenta w projekcie.
Zamiast powtarzac 'uzywamy Tailwind CSS 4, Prisma ORM i Next.js 16' w kazdej rozmowie, napisz to raz w CLAUDE.md. Kazdy agent dziedziczy ten kontekst. AgentsRoom zawiera wbudowany edytor CLAUDE.md, wiec mozesz go aktualizowac bez opuszczania aplikacji.
Dobrze napisany CLAUDE.md jest wart więcej niz dziesiatki starannie opracowanych pojedynczych promptow. Efekt sie kumuluje: kazda sesja z niego korzysta.
Przestant pisac te same instrukcje od nowa. Zapisuj to, co dziala, i uzywaj ponownie.
Jesli zauwazyasz, ze wpisujesz ten sam rodzaj zapytania w różnych projektach ('napisz testy jednostkowe dla tego pliku', 'zrefaktoryzuj to do wzorca repozytorium', 'dodaj obsluge bledow do wszystkich tras API'), zapisz to jako prompt wielokrotnego uzytku.
AgentsRoom zawiera funkcje biblioteki promptow z dwoma poziomami: prompty projektowe dla zadan specyficznych dla projektu oraz prompty globalne (synchronizowane w chmurze) dla wzorcow, ktorych uzywasz wszedzie.
Dobrzy kandydaci do biblioteki: listy kontrolne przeglądu kodu, szablony pisania testow, skrypty migracji, instrukcje tworzenia szkieletow komponentow, kroki audytu bezpieczenstwa. Wszystko, co umieszczlbys w wiki zespolu jako standardowa procedure.
Napisz testy jednostkowe dla [pliku]. Uzyj vitest. Pokryj ścieżke glowna, przypadki brzegowe (puste dane wejsciowe, null, nieprawidlowe typy) i obsluge bledow. Mockuj zewnetrzne zaleznosci. Cel: ponad 90% pokrycia galezi.
Przejrzyj zmiany w biezacym git diff. Sprawdz: nieuzywane importy, brak obslugi bledow, problemy z bezpieczenstwem typow, potencjalne race conditions i niespojnosci w nazewnictwie. Zaproponuj poprawki dla kazdego znalezionego problemu.
Utworz endpoint REST dla [zasobu]. Zawrzyj walidacje danych wejsciowych za pomoca zod, odpowiednie odpowiedzi bledow (400, 401, 404, 500), typy TypeScript dla request/response i komentarz JSDoc opisujacy endpoint. Stosuj istniejacy wzorzec z src/api/.
Techniki do zlozonych zadan wykraczajacych poza pojedyncze prompty.
Podziel duze zadanie na uporzadkowane kroki. Uruchom pierwszego agenta z krokiem pierwszym, poczekaj na zakonczenie, nastepnie uruchom nastepnego agenta z krokiem drugim (odwolujac sie do wyniku kroku pierwszego). Kazdy krok jest mniejszy i bardziej skoncentrowany. Przyklad: Agent 1 projektuje schemat bazy danych, Agent 2 pisze API uzywajac tego schematu, Agent 3 pisze testy dla API.
Po zakonczeniu pracy jednego agenta, skieruj innego agenta na jego wynik. 'Przejrzyj zmiany, ktore agent frontend własnie wprowadzil w src/components/. Sprawdz problemy z dostępnoscia i brakujace stany bledow.' Nowy agent z inna rola wychwytuje rzeczy, ktore oryginalny agent przeoczyl.
Zacznij od szerokiego prompta, aby zobaczyc, jak agent podchodzi do problemu. Nastepnie dodawaj ograniczenia w kolejnych wiadomosciach: 'Dobra struktura, ale uzyj server components zamiast client components.' 'Zachowaj hook, ale usun useEffect i uzyj React Query mutation.' Kazda iteracja przyblizy do rozwiązania, ktorego szukasz.
Skieruj agenta na istniejacy kod: 'Zbuduj strone ustawien wedlug tego samego wzorca co src/pages/profile.tsx. Taki sam uklad, taka sama obsluga formularzy, takie samo wyswietlanie bledow.' Jest to czesto skuteczniejsze niz opisywanie wzorca slowami.
Wzorce, ktore konsekwentnie daja gorsze wyniki.
Mowienie agentowi dokladnie, jakie funkcje napisac, jakie nazwy zmiennych uzyc i w jakiej kolejnosci implementowac. Takie mikrozarzadzanie odbiera agentowi mozliwosc znalezienia lepszego podejscia. Opisuj wynik, nie procedure.
Proszenie agenta o 'poprawienie bazy kodu' bez ograniczen. Bez granic agent moze zrefaktoryzowac pliki, ktorych nie chciales ruszac, zmienic API, od ktorych zalezy inny kod, lub wydac tokeny na poprawki o niskim priorytecie.
Niewspomnienie, ze wzorzec, narzędzie lub komponent juz istnieje w projekcie. Agent utworzy nowy. Proste 'mamy juz hook useAuth w src/hooks/' oszczedza znaczacych przerobek.
Upychanie pieciu zadan w jednej wiadomosci. Agent sprobuje wykonac wszystkie, ale jakosc spada, gdy zarządza konkurujacymi celami. Podziel je na sekwencyjne, skoncentrowane zapytania.
AgentsRoom oferuje wbudowane prompty systemowe, biblioteke promptow i edycje CLAUDE.md. Mniej czasu na tworzenie promptow, więcej czasu na budowanie.
Aplikacja towarzyszaca: monitoruj agentów w podrozy
Użyj Claude, Codex, Gemini CLI lub innego dostawcy AI.
Wysyłaj bugi i prośby bezpośrednio do swojego publicznego backlogu.