claude-plugins/plugins/ralph/commands/prd.md

description

description
Generează un Product Requirements Document (PRD) structurat pentru o funcționalitate nouă. Folosește acest skill când utilizatorul vrea să planifice și documenteze cerințele pentru un feature înainte de implementare.

Skill: PRD Generator

Generează un Product Requirements Document (PRD) detaliat prin detecție automată a contextului și întrebări adaptive.

Când să folosești acest skill

• Utilizatorul vrea să adauge o funcționalitate nouă
• Vrea să planifice înainte de a implementa
• Menționează "PRD", "requirements", "cerințe", "planifică feature"

Workflow

FAZA 1: Detecție Context Proiect

Verifică existența fișierelor de config pentru a determina modul:

package.json       → Node.js/JavaScript ecosystem
pyproject.toml     → Python
requirements.txt   → Python (legacy)
go.mod             → Go
Cargo.toml         → Rust
pom.xml            → Java (Maven)
build.gradle       → Java (Gradle)
composer.json      → PHP
Gemfile            → Ruby

DACĂ găsit config file:

1. Citește fișierul de config pentru a extrage:
   • Dependențe principale (framework-uri, librării)
   • Scripturi disponibile (pentru package.json)
   • Versiuni
2. Analizează structura directoarelor:
   • src/, app/, components/, pages/, api/
   • Identifică patterns: Next.js, React, Express, etc.
3. Raportează utilizatorului:

   Am detectat un proiect existent:
   - Stack: Next.js 14, TypeScript, Prisma, TailwindCSS
   - Structură: App Router (app/), API routes (app/api/)
   - Scripts: dev, build, lint, typecheck
   

4. Setează: FEATURE_MODE

DACĂ NU găsit config file:

1. Raportează: "Nu am detectat un proiect existent. Vom crea PRD pentru proiect nou."
2. Setează: NEW_PROJECT_MODE

---

FAZA 2: Întrebări Adaptive cu AskUserQuestion

IMPORTANT: Folosește tool-ul AskUserQuestion pentru întrebări interactive, NU text simplu.

---

IF NEW_PROJECT_MODE:

Întrebarea 1 (AskUserQuestion):

{
  "question": "Ce tip de proiect vrei să creezi?",
  "header": "Tip proiect",
  "options": [
    {"label": "Web Application", "description": "Frontend + Backend, UI interactiv"},
    {"label": "API / Backend", "description": "REST/GraphQL API, servicii backend"},
    {"label": "CLI Tool", "description": "Command-line application"},
    {"label": "Library / SDK", "description": "Cod reutilizabil pentru alți developeri"}
  ],
  "multiSelect": false
}

Întrebarea 2 (AskUserQuestion):

{
  "question": "Cine sunt utilizatorii țintă?",
  "header": "Audiență",
  "options": [
    {"label": "End users", "description": "Clienți finali, public larg"},
    {"label": "Developers", "description": "API/SDK consumers, tehnici"},
    {"label": "Admin / Staff", "description": "Utilizatori interni, back-office"},
    {"label": "Sistem automatizat", "description": "Integrări machine-to-machine"}
  ],
  "multiSelect": false
}

Întrebarea 3 (AskUserQuestion):

{
  "question": "Ce tech stack preferi?",
  "header": "Stack",
  "options": [
    {"label": "Next.js + TypeScript (Recommended)", "description": "Full-stack React, App Router, API routes"},
    {"label": "Node.js + Express", "description": "Backend flexibil, REST API"},
    {"label": "Python + FastAPI", "description": "API modern, async, type hints"},
    {"label": "Go", "description": "Performance, simplitate, concurrency"}
  ],
  "multiSelect": false
}

Întrebarea 4 (AskUserQuestion):

{
  "question": "Ce arhitectură de date preferi?",
  "header": "Database",
  "options": [
    {"label": "PostgreSQL + Prisma (Recommended)", "description": "Relațional, ORM type-safe"},
    {"label": "MongoDB", "description": "Document store, schema flexibilă"},
    {"label": "SQLite", "description": "Simplitate, embedded, local-first"},
    {"label": "Fără persistență", "description": "In-memory, stateless"}
  ],
  "multiSelect": false
}

Întrebarea 5 (AskUserQuestion):

{
  "question": "Cum va arăta interfața?",
  "header": "UI/UX",
  "options": [
    {"label": "Dashboard / Admin Panel", "description": "Tabele, grafice, forms complexe"},
    {"label": "Landing + App simplu", "description": "Marketing + funcționalitate core"},
    {"label": "API only (no UI)", "description": "Doar backend, documentație API"},
    {"label": "CLI interface", "description": "Terminal-based interaction"}
  ],
  "multiSelect": false
}

Întrebarea 6 (AskUserQuestion):

{
  "question": "Ce tip de autentificare e necesar?",
  "header": "Auth",
  "options": [
    {"label": "Email + Password", "description": "Classic login, JWT sessions"},
    {"label": "OAuth / Social login", "description": "Google, GitHub, etc."},
    {"label": "API Keys", "description": "Pentru servicii și integrări"},
    {"label": "Fără autentificare", "description": "Public access"}
  ],
  "multiSelect": true
}

Întrebarea 7 (AskUserQuestion):

{
  "question": "Ce integrări externe sunt necesare?",
  "header": "Integrări",
  "options": [
    {"label": "Payment (Stripe)", "description": "Procesare plăți, subscriptions"},
    {"label": "Email (Resend/SendGrid)", "description": "Trimitere emails tranzacționale"},
    {"label": "Storage (S3/Cloudflare)", "description": "Upload fișiere, imagini"},
    {"label": "Niciuna", "description": "Self-contained, fără dependențe externe"}
  ],
  "multiSelect": true
}

Întrebarea 8 (AskUserQuestion):

{
  "question": "Care e prioritatea acestui proiect?",
  "header": "Prioritate",
  "options": [
    {"label": "MVP rapid", "description": "Funcționalitate minimă, lansare rapidă"},
    {"label": "Produs complet", "description": "Feature-complete, production-ready"},
    {"label": "Proof of concept", "description": "Validare idee, poate fi refăcut"},
    {"label": "Learning project", "description": "Experimentare, nu contează calitatea"}
  ],
  "multiSelect": false
}

Întrebarea 9 (AskUserQuestion):

{
  "question": "Cum definim succesul? Ce criterii trebuie îndeplinite?",
  "header": "Success",
  "options": [
    {"label": "Funcționalitate completă", "description": "Toate features funcționează conform spec"},
    {"label": "Performance targets", "description": "Timp răspuns < X ms, throughput > Y"},
    {"label": "User adoption", "description": "N utilizatori activi, engagement"},
    {"label": "Code quality", "description": "Test coverage > 80%, no critical bugs"}
  ],
  "multiSelect": true
}

Întrebarea 10 (text liber - cere descriere):

Descrie pe scurt proiectul în 2-3 propoziții:
- Ce problemă rezolvă?
- Care e funcționalitatea principală?

Întrebarea 11 - Web Research (AskUserQuestion):

{
  "question": "Vrei să cercetez best practices și patterns pentru acest stack?",
  "header": "Research",
  "options": [
    {"label": "Da, cercetează", "description": "WebSearch pentru patterns și recomandări"},
    {"label": "Nu, continuă", "description": "Am experiență cu acest stack"}
  ],
  "multiSelect": false
}

DACĂ utilizatorul alege "Da, cercetează":

• Folosește WebSearch pentru: "[stack] best practices 2026"
• Integrează findings în secțiunea "Considerații Tehnice" din PRD

---

IF FEATURE_MODE:

Întrebarea 1 (text liber):

Descrie feature-ul pe care vrei să-l adaugi:
- Ce funcționalitate nouă?
- Care e scopul principal?

Întrebarea 2 (AskUserQuestion):

{
  "question": "Ce tip de feature este acesta?",
  "header": "Tip feature",
  "options": [
    {"label": "Funcționalitate nouă", "description": "Ceva ce nu există în app"},
    {"label": "Îmbunătățire UX", "description": "Flow mai bun, mai intuitiv"},
    {"label": "Performance", "description": "Optimizare viteză, eficiență"},
    {"label": "Integrare externă", "description": "Conectare cu alt sistem/serviciu"}
  ],
  "multiSelect": false
}

Întrebarea 3 (AskUserQuestion):

{
  "question": "Implică modificări de UI?",
  "header": "UI changes",
  "options": [
    {"label": "Da - componente noi", "description": "Pagini sau secțiuni noi"},
    {"label": "Da - modificări existente", "description": "Update la UI existent"},
    {"label": "Nu - doar backend", "description": "Logic, API, fără UI"}
  ],
  "multiSelect": false
}

Întrebarea 4 (AskUserQuestion):

{
  "question": "Necesită modificări în baza de date?",
  "header": "DB changes",
  "options": [
    {"label": "Da - tabele noi", "description": "Noi entități de stocat"},
    {"label": "Da - coloane noi", "description": "Câmpuri noi pe tabele existente"},
    {"label": "Da - relații noi", "description": "Legături între tabele"},
    {"label": "Nu", "description": "Schema rămâne neschimbată"}
  ],
  "multiSelect": true
}

Întrebarea 5 (AskUserQuestion):

{
  "question": "Sunt necesare integrări noi cu servicii externe?",
  "header": "Integrări",
  "options": [
    {"label": "Da - API extern", "description": "Conectare la serviciu terț"},
    {"label": "Da - Webhooks", "description": "Primire/trimitere events"},
    {"label": "Nu", "description": "Self-contained în app"}
  ],
  "multiSelect": true
}

Întrebarea 6 (AskUserQuestion):

{
  "question": "Există considerații speciale de security?",
  "header": "Security",
  "options": [
    {"label": "Autorizare/permisiuni", "description": "Cine poate accesa ce"},
    {"label": "Date sensibile", "description": "PII, payment, credentials"},
    {"label": "Rate limiting", "description": "Protecție abuse"},
    {"label": "Nu, standard", "description": "Fără cerințe speciale"}
  ],
  "multiSelect": true
}

Întrebarea 7 (text liber):

Cum verificăm că feature-ul funcționează corect?
Descrie acceptance criteria (ce trebuie să se întâmple când e gata):

---

FAZA 3: Generează PRD-ul

După răspunsuri, creează documentul în /tasks/prd-[feature-name].md:

# PRD: [Feature Name]

## 1. Introducere
[Context și motivație pentru feature - 2-3 propoziții bazate pe răspunsuri]

## 2. Context Tehnic
[DOAR pentru FEATURE_MODE - include stack-ul detectat]
- **Stack**: [detectat din config]
- **Structură**: [detectat din directoare]
- **Comenzi disponibile**: [din package.json scripts]

## 3. Obiective
### Obiectiv Principal
- [Ce problemă rezolvă - din răspunsuri]

### Obiective Secundare
- [Beneficii adiționale]

### Metrici de Succes
- [Din răspunsul la întrebarea despre success criteria]

## 4. User Stories

### US-001: [Titlu Descriptiv]
**Ca** [tip utilizator - din răspunsuri]
**Vreau** [funcționalitate]
**Pentru că** [beneficiu]

**Acceptance Criteria:**
- [ ] Criteriu 1 specific și testabil
- [ ] Criteriu 2 specific și testabil
- [ ] {TYPECHECK_COMMAND} passes
- [ ] [Pentru UI] Verificare vizuală cu browser: [comportament specific]

### US-002: [Titlu]
...

## 5. Cerințe Funcționale
1. [REQ-001] Sistemul trebuie să...
2. [REQ-002] Utilizatorul poate să...
3. [REQ-003] Când X se întâmplă, Y trebuie să...

## 6. Non-Goals (Ce NU facem)
- [Explicit ce nu e în scope pentru a evita scope creep]
- [Funcționalități similare care NU sunt incluse]

## 7. Considerații Tehnice
### Stack/Tehnologii
- [Din detecție sau răspunsuri]

### Patterns de Urmat
- [Patterns existente în codebase - din analiză]

### Dependențe
- [De ce depinde acest feature]

### Riscuri Tehnice
- [Potențiale probleme]

### Best Practices
[Dacă s-a făcut WebSearch, include findings aici]

## 8. Considerații UI/UX
[Dacă UI changes != "Nu - doar backend"]
- Layout și flow
- Stări (loading, error, empty, success)
- Accesibilitate

## 9. Considerații Security
[Din răspunsul la întrebarea despre security]

## 10. Open Questions
- [ ] [Întrebări nerezolvate care necesită clarificare]

---

FAZA 4: Validare și salvare

1. Afișează preview al PRD-ului generat
2. Întreabă utilizatorul:
   • "PRD-ul acoperă tot ce ai în minte?"
   • "Vrei să adaugi sau să modifici ceva?"
   • "Stories-urile sunt de mărime potrivită pentru implementare incrementală?"
3. Salvează în /tasks/prd-[feature-name].md
4. Sugerează următorul pas:

   PRD salvat în tasks/prd-[feature-name].md
   
   **Următorii pași:**
   1. Revizuiește PRD-ul și adaugă detalii dacă e nevoie
   2. Când ești gata, folosește `/ralph:convert` pentru a converti în prd.json
   3. Apoi rulează `./scripts/ralph/ralph.sh` pentru implementare autonomă
   

---

Reguli pentru User Stories bune

Mărime potrivită (1 context window):

• Adaugă un câmp în DB + migration
• Creează un component React simplu
• Implementează un endpoint API
• Scrie unit tests pentru o funcție

Prea mare (trebuie spart):

• "Implementează autentificarea" → sparge în: login form, register form, JWT middleware, session management
• "Creează dashboard" → sparge în: layout, charts component, data fetching, filtering

Ordine dependențe:

1. Database/Schema (nu depind de nimic)
2. Backend logic (depind de schema)
3. API endpoints (depind de backend)
4. UI components (depind de API)
5. Integration (depind de toate)

Acceptance Criteria:

• Specifice: "Butonul Submit trimite form data la POST /api/users"

• NU vagi: "Funcționează corect"

• Verificabile: "După submit, redirect la /dashboard"

• NU subiective: "UX plăcut"

• Include ÎNTOTDEAUNA comanda de typecheck din proiect

• Pentru UI: "Verificare vizuală cu browser că [behavior]"

---

Output așteptat

• Fișier /tasks/prd-[feature-name].md cu documentație completă
• User stories clare, atomice, cu acceptance criteria verificabile
• Non-goals explicit definite
• Context tehnic detectat (pentru FEATURE_MODE)

Important

1. NU începe implementarea - acest skill doar generează documentație
2. Folosește AskUserQuestion pentru întrebări interactive
3. Detectează contextul înainte de a pune întrebări
4. Stories atomice - fiecare trebuie să fie independent completabil
5. Acceptance criteria verificabile - nu vagi
6. Kebab-case pentru nume fișiere