Książka kucharska programisty pracującego z AI

Książka kucharska programisty pracującego z AI to zbiór promptów do skopiowania dla Claude Code, Codeksa i Cursora, pogrupowanych według stosu: frontend, backend, bazy danych, inżynieria danych, DevOps, aplikacje mobilne i obsługa błędów. Każda receptura łączy prompt z maszynowym sprawdzeniem, które dowodzi wyniku: testem czerwonym przed zmianą, kontrolą typów albo buildem, dzięki czemu weryfikuje się zachowanie zamiast czytać każdą linię.

Ta strona jest dla programistów i liderów zespołów, którzy mają już zainstalowanego agenta (zacznij od ścieżki programisty) i potrzebują gotowych sformułowań do konkretnego zadania. Znasz ten schemat: agent pisze „gotowe”, diff ma 600 linii i nie wiesz, czy to działa, dopóki nie przeczytasz całości. Receptury rozwiązują to, bo od początku żądają od agenta dowodów.

Która sekcja książki kucharskiej pasuje do twojego zadania?

Wybierz sekcję dla swojego stosu. Strona główna każdej sekcji ma tabelę, która przypisuje frameworki do stron z recepturami.

Twoje zadanie	Sekcja	Czym receptury dowodzą wyniku
UI w React, Next.js, Vue, Nuxt, Angular	Receptury frontendowe	Bramki typów, testów, dostępności i zrzutów ekranu
API i usługi w Node.js, Pythonie, Go, Javie, .NET, Rails, PHP, Rust, Elixirze, serverless	Receptury backendowe	Testy integracyjne na prawdziwej bazie, detektory wyścigów danych (race detector), porównanie kontraktów
Migracje, ORM-y, strojenie SQL, NoSQL	Receptury bazodanowe	Zmiana uruchomiona na prawdziwym silniku, plany zapytań przed i po
Modele dbt, potoki SQL, notatniki	Receptury inżynierii danych	dbt build z testami danych na środowisku deweloperskim
Docker, Kubernetes, CI/CD, IaC, monitoring	Receptury DevOps	Lintery, uruchomienia próbne (dry run) i wynik plan, zanim cokolwiek zostanie zastosowane
Expo, React Native, Flutter, natywne iOS i Android	Programowanie mobilne	Uruchomienia w symulatorze i emulatorze, dowody z testów UI
Debugowanie, logowanie, odzyskiwanie po błędach	Receptury obsługi błędów	Test reprodukujący, który pada przed poprawką i przechodzi po niej

Każda receptura ma ten sam układ: scenariusz, prompt w wyróżnionej ramce, sprawdzenie, które potwierdza wynik, i to, co się psuje. Receptury są samodzielne, więc możesz je czytać w dowolnej kolejności.

Przygotuj narzędzie przed pierwszą recepturą

Receptury zakładają, że agent zna twoje polecenia budowania, testów i lintera. Bez nich „uruchom testy” staje się zgadywaniem. Najpierw daj agentowi plik z instrukcjami:

Claude Code

Uruchom claude w katalogu głównym repozytorium, a potem /init, żeby wygenerować szkic CLAUDE.md. Receptury wklejasz w prompt. Przy dużych zmianach zacznij w trybie planowania (/plan) i zatwierdź plan, zanim zmieni się jakikolwiek plik.

Codex

Uruchom codex w katalogu głównym repozytorium, a potem /init, żeby wygenerować szkic AGENTS.md. Codex czyta AGENTS.md przed rozpoczęciem pracy, ale od wersji 0.150.0 niezaufany projekt go nie dostarcza, więc zaufaj repozytorium, gdy Codex o to zapyta. /plan działa tak samo jak w Claude Code.

Cursor

Otwórz panel agenta i wklej tam recepturę. Polecenia zapisz w regule projektu; format i sposób, by reguła obowiązywała przy każdym żądaniu, opisuje strona o regułach projektu w Cursorze. Przy zmianach w wielu plikach użyj Plan Mode.

Zacznij od domyślnego modelu swojego narzędzia. Według stanu na 2026-10-12 to Claude Opus 5.5 w Claude Code od wersji 2.1.280 (oba kanały wydań) i GPT-6.1 Sol w Codeksie (domyślny model dołączony do CLI od wersji 0.159.1). Zanim zmienisz model, najpierw podnieś poziom wysiłku (effort): w Claude Code poleceniem /effort, w Codeksie poleceniem /model, które ustawia zarówno model, jak i poziom rozumowania (reasoning effort). Kiedy zmiana modelu się opłaca, sprawdzisz na stronie o modelach.

Prompt do skopiowania: przekaż agentowi bramki przed jakąkolwiek recepturą

Read the build files, lockfile, CI workflows and test config of this repository.
Write a "Commands" section for the agent instruction file with the exact
type-check, lint, test, single-test and build commands this repo uses today,
and a "Definition of done" section: all of them pass and your reply ends with
the last lines of each. Then run every command you listed and report which
ones failed or need a service (Docker, a database) that is not running. Do not
change any source file in this step.

Jak zweryfikować wynik receptury bez czytania każdej linii?

Proś o dowód, a nie o kod. Wynikowi receptury możesz ufać, gdy spełnione są trzy warunki:

1. Test padał przed zmianą i przechodzi po niej. Test napisany po kodzie często sprawdza tylko to, co kod akurat robi.
2. Bramki z pliku z instrukcjami przechodzą, a agent wkleja ich wynik.
3. CI uruchamia te same polecenia na pull requeście jako wymagane sprawdzenie. Plik z instrukcjami jest radą, decyduje CI. Zobacz potoki CI/CD.

Dwie rzeczy nadal zatwierdzasz sam: kryteria akceptacji, zanim agent zacznie, i nieodwracalne kroki, gdy skończy, na przykład migrację, która usuwa kolumnę. Oba zatwierdzenia trafiają do pakietu dowodów pull requesta.

Prompt do skopiowania: obuduj dowolną recepturę wymogiem dowodu

Before you change any code for the task above, write the tests that define
"done" and run them to show they fail. Then implement until they pass. Do not
edit or delete an existing test to make it pass; ask me first. Finish with a
summary that lists: each new test and what it proves, the last lines of every
command in the Definition of done, and anything you could not verify.

Co się psuje, gdy wklejasz recepturę?

• Prompt wymienia stos, którego nie używasz. Agent wymyśla pliki, żeby do niego pasowały. Jak naprawić: przed wklejeniem podmień framework, ścieżki i polecenia na swoje, a kroki dowodowe zostaw bez zmian.
• Agent mockuje to, co ma być testowane. Testy przechodzą na fałszywej bazie albo zaślepionej przeglądarce. Jak naprawić: wpisz prawdziwy silnik do definicji ukończenia, tak jak w testach integracyjnych.
• Agent poprawia test, aż zrobi się zielony. Jak naprawić: zabroń tego w pliku z instrukcjami, przeglądaj diff testów osobno i przeczytaj o ochronie wyroczni.
• Kod używa API ze starszej wersji frameworka. Jak naprawić: daj agentowi aktualną dokumentację przez Context7 albo własny serwer MCP frameworka, jeśli receptura go wymienia.
• Agent melduje „gotowe”, nie uruchamiając bramek. Jak naprawić: ustaw zadanie CI jako wymagane sprawdzenie, a w Claude Code dodaj hook Stop, który uruchamia testy (automatyzacja hooków).

Dokąd dalej z książką kucharską

Receptury backendowe

Receptury frontendowe

Wykonywalne kryteria akceptacji

Jak przygotować repozytorium do pracy agentów

Ścieżka dewelopera