Budowanie z Cursorem: od czatu z agentem do sprawdzonej zmiany

Sekcja budowania w Cursorze to 22 przewodniki dla programistów i tech leadów, którzy agentem Cursora zamieniają zaakceptowany plan w działający kod. Obejmuje funkcje edytora, czat z agentem, agentów równoległych, duże bazy kodu i pracę na wielu repozytoriach oraz dziewięć scenariuszy. Każdy przewodnik kończy się dowodami (testy, sprawdzanie typów, linter), że zmiana działa, bez czytania kodu linijka po linijce.

Poprosiłeś agenta Cursora o handler webhooków Stripe. Zmienił sześć plików, zgłosił „wszystkie testy przechodzą”, a ty nie wiesz, czy handler weryfikuje podpisy ani czy agent ruszał testy. Ta sekcja jest dla programisty, który pisze taki prompt, i dla tech leada, który decyduje, czego taki pull request musi dowieść, zanim ktokolwiek go zatwierdzi.

Którego przewodnika po budowaniu w Cursorze potrzebujesz?

Twoja sytuacja	Zacznij od
Chcesz poznać codzienne funkcje, po jednej wskazówce	Podstawowe funkcje, Autouzupełnianie Tab, Edycja inline
Zlecasz agentowi całe funkcjonalności	Praca z czatem agenta, potem tryby agenta
Musisz cofnąć turę agenta albo cały eksperyment	Checkpointy i gałęzie
Repozytorium jest duże albo rozciąga się na kilka repozytoriów	Strategie dla dużych baz kodu, Praca z wieloma repozytoriami
Chcesz, żeby kilku agentów pracowało naraz	Okno Agents
Ciągle przepisujesz te same instrukcje	Szablony promptów, Zarządzanie snippetami, Oszczędności czasu
Przebudowujesz kod, który ma testy	Strategie refaktoryzacji

Przewodniki scenariuszowe prowadzą jeden rodzaj pracy od prośby do udowodnionej zmiany:

Scenariusz	Przewodnik
Kod bez testów, pełen callbacków, który musi dalej działać	Refaktoryzacja kodu legacy
Zewnętrzne API z ponowieniami, idempotencją i webhookami	Integracje API
Ramki z Figmy, które stają się komponentami React	Frontend UI z projektów
Dokumentacja, diagramy i notatki migracyjne sprawdzane w CI	Dokumentacja
Granice serwisów i kontrakty	Mikroserwisy
Przemyślenie projektu razem z agentem	Pair programming
Aplikacje React Native i wieloplatformowe	Aplikacje mobilne
Zadania ETL z uzgadnianiem danych	Potoki danych
Przejście na inny framework lub nową wersję główną	Migracja frameworka

Zanim zaczniesz tę sekcję, przygotuj kontekst agenta według zarządzania kontekstem i reguł projektu, a zaakceptowany plan przynieś z planowania z Cursorem.

Jak przebiega zadanie budowania w Cursorze?

Przewodniki, w których pracuje agent, trzymają się tej kolejności i to ona pozwala sprawdzić wynik zamiast go czytać.

Zacznij od zaakceptowanego planu. Jeśli nie umiesz jeszcze podać kryteriów akceptacji, najpierw przygotuj plan w Plan Mode, który według dokumentacji Cursora tworzy szczegółowy plan implementacji, zanim powstanie jakikolwiek kod.
Najpierw napisz testy, które nie przechodzą, i je zatwierdź. Zacommituj je przed implementacją, żeby każda późniejsza zmiana testu była widoczna w git diff.
Implementuj pod nazwane bramki. Prompt wymienia dokładne polecenia testów, sprawdzania typów i lintera, a agent uruchamia je, dopóki nie przejdą.
Commituj każdą zieloną turę. Commit to punkt powrotu, który przetrwa sesję; punkty powrotu między commitami opisuje przewodnik checkpointy i gałęzie.
Zbierz dowody i poproś o niezależny przegląd. Agent raportuje wynik bramek. Bugbot sprawdza pull request, a nowy czat z agentem uruchamia poniższy prompt z raportem dowodów względem kryteriów akceptacji.

Implement the Stripe webhook handler described in @docs/plans/stripe-webhooks.md.

Definition of done:
- The tests in tests/webhooks/ (committed, currently failing) pass.
- npm run typecheck and npm run lint pass with no new warnings.
- Do not edit, skip or delete any file under tests/. If a test looks wrong,
  stop and tell me why instead of changing it.

Follow the handler pattern in @src/routes/billing.ts. Verify the Stripe
signature before parsing the body. Run the three commands after each change.
When you finish, list every file you changed with one line on why.

Do not change any file. Prepare the evidence for this branch:
1. Run npm test, npm run typecheck and npm run lint. Paste the last 10 lines
   of each output.
2. Run git diff --stat main... and flag any changed file under tests/.
3. Map each acceptance criterion in @docs/plans/stripe-webhooks.md to the
   test that proves it. Mark any criterion with no test as UNPROVEN.
4. List anything you assumed that the plan does not state.

Jak ufać kodowi od agenta bez czytania każdej linii?

Kod czytaj tylko tam, gdzie dowodów brakuje albo coś zaskakuje. Pull request z etapu budowania jest gotowy do przeglądu, gdy zawiera:

Testy, które najpierw nie przechodziły. Zacommitowane przed implementacją, czerwone na starym kodzie.
Nietknięte testy. git diff --stat dla commitów z implementacją nie pokazuje plików testów. Jak to wymusić, opisuje ochrona wyroczni.
Zielone bramki w CI, nie tylko w raporcie agenta.
Każde kryterium akceptacji przypisane do testu dzięki drugiemu promptowi. Kryterium oznaczone UNPROVEN to miejsce, w którym człowiek czyta kod.

Za dowody odpowiada programista, który uruchomił agenta. Recenzent zatwierdza, gdy wszystkie punkty są na miejscu. Zobacz czytanie dowodów zamiast kodu i wspólny dla zespołu pakiet dowodów.

Co się psuje, gdy budujesz z agentem Cursora?

Objaw	Prawdopodobna przyczyna	Jak wyjść
Agent zgłasza sukces, a CI jest czerwone	Uruchomił tylko część bramek albo żadnej	Wymień w prompcie każde polecenie i poproś o wklejony wynik
Test, który nie przechodził, zrobił się zielony po zmianie w teście	Agent dopasował test do swojego kodu	Przywróć plik testu, napisz „The test is correct; fix the implementation” i ponownie sprawdź `git diff --stat`
Kod działa, ale ignoruje twoje konwencje	W kontekście nie ma reguły ani przykładu	Wskaż jeden plik wzorcowy przez `@` i dopisz wzorzec do reguł projektu
Każda poprawka pogarsza czat	Kontekst jest zapchany nieudanymi próbami	Wróć do ostatniego zielonego commita i otwórz nowy czat z planem i testem, który nie przechodzi (czat z agentem)
Równolegli agenci edytują te same pliki	Zadań nie podzielono według własności plików	Daj każdemu agentowi osobny worktree i zadanie, a potem scalaj po kolei (okno Agents)

Dokąd dalej po budowaniu z Cursorem

Praca z czatem agenta w Cursorze Podstawowa pętla: testy jako definicja ukończenia, bramki w prompcie i moment na restart.

Testowanie i debugowanie z Cursorem Testy, które łapią prawdziwe błędy, i przyczyna przed poprawką.

Code review i wdrożenie z Cursorem Code review, Bugbot i bramki CI przed wydaniem.

Ten sam etap w innych narzędziach: Claude Code i Codex. Praktyki niezależne od narzędzia opisuje sekcja wzorców pracy na etapie budowania.