PRD do planu do todo: Ustrukturyzowany rozwój w Claude Code

Twój PM wrzuca na Slacka dwustronicowy dokument wymagań produktowych. Opisuje nowy system powiadomień — digest emailowy, alerty w aplikacji, zarządzanie preferencjami, całość. Mógłbyś zacząć kodować od razu i ogarniać w trakcie. Albo mógłbyś pozwolić Claude Code rozłożyć to na plan architektoniczny, rozdzielić na dyskretne zadania, a następnie implementować każde systematycznie, śledząc postęp. Drugie podejście dostarcza szybciej i z mniejszą liczbą przepisek.

Ten przewodnik pokazuje workflow specyficzny dla Claude Code do przejścia od dokumentu wymagań do działającego, przetestowanego kodu.

Co wyniesiesz z tego przewodnika

• Powtarzalny trzyfazowy workflow: analiza PRD, generowanie planu, implementacja zadanie po zadaniu
• Prompty, które produkują ustrukturyzowane plany zamiast natychmiastowego (często błędnego) kodu
• Zrozumienie systemu śledzenia zadań Claude Code
• Plik planu, którym możesz podzielić się z zespołem do przeglądu przed napisaniem jednej linii

Trzyfazowy workflow

Faza 1: Daj Claude wymagania

Zacznij od podania Claude wymagań i wyraźnego poproszenia o analizę, nie implementację:

Wskazówka

Gotowy do skopiowania prompt do analizy PRD:

I have a product requirement to implement. Before writing any code,
I need you to:

1. Read and summarize the requirements
2. Identify ambiguities or missing details
3. List technical decisions that need to be made
4. Suggest an architecture approach

Here are the requirements:

[paste your PRD or describe the feature]

Kluczowa instrukcja to “before writing any code.” Bez niej Claude często przeskakuje od razu do implementacji. Bycie wyraźnym co do tego, że chcesz najpierw analizę, daje dramatycznie lepsze wyniki.

Faza 2: Wygeneruj plan

Gdy Claude zrozumie wymagania, poproś go o utworzenie ustrukturyzowanego planu implementacji:

Wskazówka

Gotowy do skopiowania prompt do generowania planu:

Based on your analysis, create a detailed implementation plan.
For each step:
- What files need to be created or modified
- What the changes involve
- Dependencies on other steps
- Estimated complexity (small/medium/large)

Number each step. I want to review this plan before any code is written.

Claude wyprodukuje ponumerowany plan ze szczegółami na poziomie plików. Przejrzyj go, kwestionuj cokolwiek co nie wygląda dobrze i dopracuj przed ruszeniem dalej.

Faza 3: Wykonaj ze śledzeniem zadań

Claude Code ma wbudowany system śledzenia zadań. Poproś Claude o przekonwertowanie planu na zadania i przepracowanie ich:

Convert this plan into tasks and start implementing step 1.
After completing each step, update the task status and move
to the next one. Wait for my approval after each major step.

Claude utworzy zadania, zaimplementuje każdy krok, oznaczy je jako ukończone i przejdzie do następnego. Możesz sprawdzić postęp w dowolnym momencie:

Show me the current task list with statuses.

Tryb planowania: Wymuszone planowanie

Claude Code ma dedykowany tryb Plan, który zmusza Claude do planowania przed działaniem. W trybie Plan Claude opisuje co zamierza zrobić i czeka na twoje wyraźne zatwierdzenie przed dokonaniem jakichkolwiek zmian.

W rozszerzeniu VS Code: Kliknij wskaźnik trybu na dole pola promptu i wybierz “Plan.”

W CLI: Użyj komendy /config do przełączenia na tryb planowania lub uruchom z:

claude --permission-mode plan

W trybie Plan Claude będzie:

1. Analizować twoje zadanie
2. Produkować szczegółowy plan wymieniający wszystkie pliki i zmiany
3. Czekać na twoje zatwierdzenie, modyfikacje lub odrzucenie
4. Dopiero wtedy rozpocznie implementację

Jest to szczególnie przydatne dla dużych funkcji, gdzie chcesz przejrzeć podejście zanim jakikolwiek kod zostanie napisany.

Praca z zewnętrznymi plikami PRD

Jeśli twój PRD jest w oddzielnym dokumencie, odwołaj się do niego bezpośrednio:

Read @docs/prd-notification-system.md and create an implementation
plan for the notification system described there. Do not write any
code yet -- I want to review the plan first.

Lub wklej wymagania inline — Claude obsługuje oba podejścia równie dobrze.

Przechowywanie planów do przeglądu zespołowego

Claude Code może zapisywać plany do plików do przeglądu zespołowego:

Save this implementation plan to ./plans/notification-system.md
so my team can review it before we start coding.

Możesz skonfigurować niestandardowy katalog planów w ustawieniach:

{
  "plansDirectory": "./plans"
}

Jest to przydatne dla zespołów, które chcą przeglądać plany implementacji w pull requestach przed właściwą implementacją.

Wskazówka

Gotowy do skopiowania prompt do kompletnego workflow PRD-do-planu:

I need to implement the following feature. Walk me through it using
this exact workflow:

1. ANALYZE: Summarize the requirements and identify gaps
2. ARCHITECTURE: Propose the technical approach with file changes
3. TASKS: Break it into numbered implementation steps
4. RISKS: List what could go wrong and how to mitigate it

Do NOT write any code until I approve the plan.

Feature: [describe your feature here]

Prawdziwy przykład: System powiadomień

Oto jak workflow wygląda dla prawdziwej funkcji:

Ty:

I need to add an email notification system. Users should be able to:
- Set notification preferences (email frequency: immediate, daily digest, weekly)
- Receive notifications for: new comments, mentions, task assignments
- Unsubscribe from specific notification types
- View notification history in the app

We use Next.js with Drizzle ORM and Resend for email.

Claude produkuje:

1. Analizę identyfikującą, że potrzebujesz tabeli powiadomień, tabeli preferencji, szablonów email i zadania cron dla digestów
2. Plan architektoniczny z konkretnymi plikami do utworzenia i modyfikacji
3. Listę zadań:
   • Zadanie 1: Schemat bazy danych (tabele notifications, notification_preferences)
   • Zadanie 2: Endpointy API preferencji (GET/PUT /api/notifications/preferences)
   • Zadanie 3: Serwis tworzenia powiadomień
   • Zadanie 4: Szablony email (natychmiastowy, codzienny digest, tygodniowy digest)
   • Zadanie 5: Zadanie cron digestu
   • Zadanie 6: Komponent UI historii powiadomień
   • Zadanie 7: Handler rezygnacji z subskrypcji
   • Zadanie 8: Testy dla każdego komponentu

Przeglądasz, zatwierdzasz, a Claude zaczyna implementować zadanie po zadaniu.

Iterowanie planów

Plany nie są wyryte w kamieniu. Typowe korekty podczas przeglądu:

Move task 5 (cron job) to a later phase. For now, only implement
immediate notifications. Also, add input validation to task 2.

Task 3 looks too big. Break it into separate tasks for each
notification type (comments, mentions, task assignments).

Claude odpowiednio dostosowuje plan i listę zadań.

Kiedy coś idzie nie tak

Claude przeskakuje do kodu zamiast planować — Nie byłeś wystarczająco wyraźny. Zawsze dołączaj frazy takie jak “do not write any code yet” lub “I want to review the plan first.” Tryb Plan również temu zapobiega z definicji.

Plan jest zbyt ogólnikowy — Poproś o więcej szczegółów: “For task 3, tell me exactly which functions you will create, what their signatures will be, and how they connect to existing code.”

Zadania wchodzą poza kolejność — Jeśli Claude zaczyna implementować zadanie, które zależy od nieukończonego, przerwij i przekieruj: “Stop. Task 4 depends on task 2 which is not complete. Go back and finish task 2 first.”

Plan nie pasuje do twojej architektury — To zwykle oznacza, że twój CLAUDE.md nie zawiera szczegółów architektonicznych. Dodaj wzorce takie jak “all database queries go through the repository pattern” lub “use server actions, not API routes”, aby kierować planem.

Co dalej

Dla złożonych decyzji architektonicznych w twoim planie użyj rozszerzonego myślenia, aby uzyskać najgłębsze rozumowanie Claude.

Głębokie rozumowanie Użyj /think i rozszerzonego myślenia do trudnych problemów

Workflow deweloperski Zbuduj swoją pierwszą funkcję z Claude Code