Rozpoczynanie nowego projektu używając Cursor Agent

Twój PM rzuca wiadomość na Slack: “Potrzebujemy czegoś jak Trello, ale prostszego, skupionego na codziennych standupach. Możesz mieć prototyp do czwartku?” Żadnej specyfikacji. Żadnych wireframe’ów. Żadnego dokumentu architektury. Tylko zdanie i deadline. Masz dwa dni i pusty katalog.

To jest moment, w którym większość developerów zaczyna googlować repozytoria boilerplate i spędza pół popołudnia debatując, czy użyć Next.js czy Remix. Z Cursor możesz pominąć bikeshedding i mieć działającą aplikację — z uwierzytelnianiem, bazą danych, aktualizacjami w czasie rzeczywistym i testami — w jednej skupionej sesji. Kluczem jest wiedza, po które funkcje Cursor sięgnąć na każdym etapie.

Co wyniesiesz

• Powtarzalny workflow do przekształcania niejasnych wymagań w ustrukturyzowany PRD używając trybu Ask
• Prompt do tworzenia rusztowania projektu, który generuje pliki konfiguracyjne, strukturę folderów i początkową konfigurację jednym strzałem
• Plik .cursor/rules, który utrzymuje AI spójnym przez dziesiątki kolejnych promptów
• Dyscyplinę checkpointów, która pozwala swobodnie eksperymentować bez obawy o utratę postępu
• Technikę używania trybu Plan do dekompozycji złożonych funkcji zanim Agent napisze jedną linię

Workflow

Krok 1: Wydobycie wymagań z trybem Ask

Zanim napiszesz kod, użyj trybu Ask, aby przekształcić tę niejasną wiadomość Slack w coś, przeciw czemu faktycznie możesz budować. Tryb Ask jest tylko do odczytu — nie może edytować plików ani uruchamiać poleceń — co czyni go odpowiednim narzędziem do planowania. Naciśnij Cmd+., aby przełączyć tryby.

Wskazówka

Prompt do skopiowania — Wydobycie wymagań:

Muszę zbudować aplikację do zarządzania zadaniami “jak Trello, ale prostszą, skupioną na codziennych standupach” dla zespołu 8-12 osób. Zanim napiszę jakikolwiek kod, pomóż mi zdefiniować wymagania:

1. Jakie są 5 najbardziej krytycznych funkcji dla MVP, które wysyłamy za 2 dni?
2. Co możemy wyraźnie wyciąć, aby dotrzymać harmonogramu?
3. Jaki stos technologiczny daje nam najszybszą ścieżkę do działającego prototypu, pozostając jednocześnie zdatnym do produkcji?
4. Jakie są najbardziej ryzykowne niewiadome, które powinienem najpierw rozwiązać?

Bądź opiniujący. Chcę decyzji, nie list opcji.

Model będzie kwestionować zakres i sugerować kompromisy. To jest dokładnie to, czego chcesz. Dobra sesja planowania AI przypomina rozmowę z senior engineerem, który zbudował już ten rodzaj aplikacji. Zadawaj pytania uzupełniające, aż będziesz miał jasny obraz tego, jak wygląda “zrobione”.

Zapisz wynik. Będziesz się do niego odwoływać przez cały projekt.

Krok 2: Wygeneruj PRD jako plik

Przełącz się do trybu Agent (Cmd+. ponownie) i pozwól Cursor stworzyć ustrukturyzowany dokument, do którego możesz się później odwoływać za pomocą symboli @.

Wskazówka

Prompt do skopiowania — Generowanie PRD:

Na podstawie naszej dyskusji o wymaganiach, utwórz plik w docs/prd.md z ustrukturyzowanym PRD zawierającym:

• Stwierdzenie problemu (2-3 zdania)
• Docelowi użytkownicy i ich workflow
• Lista funkcji MVP z kryteriami akceptacji dla każdej
• Wyraźne elementy poza zakresem
• Decyzja dotycząca stosu technologicznego z uzasadnieniem
• Model danych (tabele, kluczowe relacje)
• Endpointy API (metoda, ścieżka, cel)

Utrzymaj to poniżej 500 słów. To jest prototyp 2-dniowy, nie specyfikacja enterprise.

Tryb Agent utworzy plik i katalog docs/. Teraz każdy przyszły prompt może odwoływać się do @docs/prd.md dla kontekstu, co zapobiega dryfowaniu AI od Twoich wymagań, gdy rozmowa się wydłuża.

Krok 3: Skonfiguruj reguły projektu przed jakimkolwiek kodem

To jest krok, który większość ludzi pomija, i kosztuje ich godziny później. Przed wygenerowaniem jednej linii kodu, utwórz katalog .cursor/rules z instrukcjami specyficznymi dla projektu. Te reguły są automatycznie dołączane do każdej interakcji Agent i Ask.

Wskazówka

Prompt do skopiowania — Konfiguracja reguł projektu:

@docs/prd.md

Utwórz następujące pliki reguł cursor:

1. .cursor/rules/code-style.mdc — TypeScript ze strict mode, komponenty funkcyjne, named exports, Tailwind do stylowania, żadnych default exports poza stronami
2. .cursor/rules/architecture.mdc — Next.js App Router, komponenty serwerowe domyślnie, komponenty klienckie tylko gdy potrzebne do interaktywności, Drizzle ORM dla bazy danych, Zod do walidacji
3. .cursor/rules/conventions.mdc — Nazewnictwo plików (kebab-case), kolokacja testów (*.test.ts obok źródła), obsługa błędów (wzorzec Result zamiast try-catch dla logiki biznesowej), format wiadomości commit

Każdy plik powinien używać formatu frontmatter z polami description i globs. Bądź konkretny — niejasne reguły produkują niejasny kod.

Katalog .cursor/rules z plikami .mdc jest obecnym standardem Cursor dla reguł projektu. Każdy plik reguł może określać, do jakich wzorców plików się stosuje poprzez pole frontmatter globs, więc Twoje reguły TypeScript aktywują się tylko przy edycji plików .ts.

Krok 4: Utwórz rusztowanie projektu z trybem Agent

Teraz pozwól trybowi Agent zrobić ciężką pracę. Odwołaj się zarówno do PRD, jak i reguł, aby wygenerowany kod był spójny od początku.

Wskazówka

Prompt do skopiowania — Rusztowanie projektu:

@docs/prd.md @.cursor/rules

Zainicjuj ten projekt:

1. Uruchom npx create-next-app@latest . --typescript --tailwind --app --src-dir --no-import-alias (zaakceptuj domyślne)
2. Zainstaluj zależności: drizzle-orm, drizzle-kit, better-sqlite3, zod, next-auth
3. Skonfiguruj schemat bazy danych w src/db/schema.ts dopasowany do modelu danych z PRD
4. Utwórz konfigurację Drizzle i początkową migrację
5. Dodaj skrypty dev do package.json dla db:migrate i db:seed
6. Utwórz skrypt seed, który wypełnia dane testowe dla deweloperki

Uruchom każde polecenie i zweryfikuj, że się udaje przed przejściem dalej. Nie pomijaj outputu błędów.

Tryb Agent wykona polecenia terminala, utworzy pliki i będzie iterować, jeśli coś się nie uda. Z włączonym auto-run w Twoich ustawieniach Cursor (Settings > Cursor Settings > Agents > Auto-Run), agent może uruchamiać narzędzia build i naprawiać błędy bez pytania o pozwolenie za każdym razem.

Checkpoint teraz. Po tym jak rusztowanie się uda i serwer dev wystartuje, to jest Twój pierwszy bezpieczny punkt przywracania. Cursor tworzy checkpointy automatycznie, ale powinieneś także commitować do git:

git add -A && git commit -m "Initial project scaffolding with database schema"

Krok 5: Buduj funkcje z trybem Plan

Dla złożonych funkcji, użyj trybu Plan zanim pozwolisz Agent pisać kod. Tryb Plan bada Twoją bazę kodu, zadaje pytania wyjaśniające i generuje przeglądowy plan implementacji. Naciśnij Shift+Tab z inputu czatu, aby przełączyć się do trybu Plan.

Jest to szczególnie wartościowe dla pierwszej głównej funkcji, ponieważ tryb Plan wyłapie decyzje architektoniczne, które możesz przegapić — jak to, czy tablica zadań potrzebuje połączeń WebSocket czy SSE jest wystarczające, lub czy stan drag-and-drop powinien żyć w URL czy w stanie lokalnym.

@docs/prd.md @src/db/schema.ts

Zaplanuj implementację funkcji tablicy zadań:
- Kolumny w stylu Kanban (Do zrobienia, W trakcie, Zrobione)
- Przeciąganie i upuszczanie kart między kolumnami
- Aktualizacje w czasie rzeczywistym, gdy inny użytkownik przesuwa kartę
- Optymistyczne aktualizacje UI z wycofaniem przy błędzie serwera

Rozważ: Czy powinniśmy używać WebSockets, SSE czy polling? Jakie jest minimalne praktyczne podejście dla prototypu 2-dniowego?

Przejrzyj plan. Edytuj go, jeśli nie zgadzasz się z podejściem. Następnie kliknij “Build”, aby pozwolić Agent go wykonać.

Krok 6: Iteruj ze skupionymi follow-upami

Gdy główna funkcja działa, iteruj z małymi, skupionymi promptami. Każdy prompt powinien robić jedną rzecz dobrze, zamiast pytać o pięć funkcji naraz.

@src/components/task-board.tsx @src/db/schema.ts

Przeciąganie i upuszczanie działa, ale nie ma wizualnej informacji zwrotnej podczas przeciągania.
Dodaj cień i lekką rotację do przeciąganej karty, przyciemnij
kolumnę źródłową i pokaż podświetloną strefę upuszczania w kolumnie docelowej.
Używaj tylko klas Tailwind -- żadnego CSS-in-JS.

Utrzymuj rozmowy krótkie. Gdy rozmowa przekracza 15-20 wymian, kontekst się degraduje. Rozpocznij nowy czat, odwołaj się do konkretnych plików z symbolami @, i kontynuuj stamtąd.

Krok 7: Dodaj uwierzytelnianie i przygotowanie do wdrożenia

@docs/prd.md @src/db/schema.ts

Dodaj NextAuth.js z GitHub OAuth:
1. Utwórz konfigurację auth w src/lib/auth.ts
2. Dodaj route API w src/app/api/auth/[...nextauth]/route.ts
3. Utwórz middleware.ts, który chroni wszystkie route'y poza /login
4. Dodaj stronę logowania w src/app/login/page.tsx
5. Zaktualizuj tablicę zadań, aby pokazywała nazwę obecnego użytkownika
6. Dodaj tabelę users do schematu, jeśli nie istnieje

Użyj adaptera Drizzle dla NextAuth. Zmienne środowiskowe idą do .env.local.example
(nie .env.local -- nigdy nie commituj sekretów).

Kiedy to się psuje

Agent generuje przestarzały stos technologiczny. Model czasami sugeruje wzorce routera pages/ lub przestarzałe API NextAuth v4. Napraw to wyraźnymi ograniczeniami wersji w swoim prompcie: “Użyj Next.js 15 App Router” lub “Użyj Auth.js v5 (NextAuth v5).” Jeszcze lepiej, dodaj przypinanie wersji do swoich .cursor/rules.

Projekt staje się niespójny po 20+ promptach. Długie rozmowy tracą kontekst. Gdy zauważysz, że AI generuje kod, który zaprzecza wcześniejszym wzorcom (różne konwencje nazewnictwa, różna obsługa błędów), rozpocznij świeży czat. Odwołaj się do plików reguł i kluczowych plików źródłowych z symbolami @, aby przywrócić kontekst.

Agent tworzy pliki w złych lokalizacjach. Dzieje się to, gdy Twoja struktura projektu nie jest oczywista z drzewa plików. Dodaj plik reguł structure.mdc, który opisuje Twój układ katalogów: “Komponenty idą do src/components/, zapytania do bazy danych idą do src/db/queries/, route’y API idą do src/app/api/.”

Agent uruchamia polecenie, które psuje Twoją konfigurację. Użyj checkpointów do przywrócenia. Kliknij przycisk “Restore Checkpoint” przy dowolnej poprzedniej wiadomości w czacie Agent. Dla bezpieczeństwa na poziomie git, commituj po każdej udanej fazie.

Tryb Plan generuje zbyt złożoną architekturę. Model czasami over-engineeruje prototypy z mikroserwisami, kolejkami wiadomości lub skomplikowanymi warstwami cachowania. Dodaj ograniczenia: “To jest prototyp 2-dniowy dla 12 użytkowników. Optymalizuj pod kątem szybkości dostarczenia, nie skali. Użyj SQLite, nie Postgres. Monolit, nie mikroserwisy.”

Co dalej

Legacy Code Refactoring Zastosuj te same techniki do istniejącej bazy kodu, która wymaga modernizacji.

Project Rules Deep Dive Opanuj konfigurację .cursor/rules dla spójnego outputu AI w Twoim zespole.

Test-Driven Development Dodaj kompleksowe pokrycie testami do swojego nowego projektu od pierwszego dnia.