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 pentru funcționalități noi prin întrebări clarificatoare și documentație structurată.

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

Pas 1: Întrebări de clarificare

Înainte de a genera PRD-ul, pune 3-5 întrebări pentru a înțelege scopul:

Pentru a genera un PRD bun, am câteva întrebări:

**A) Care este scopul principal?**
1. Funcționalitate nouă pentru utilizatori
2. Îmbunătățire performanță/scalabilitate
3. Refactoring/cleanup cod existent
4. Integrare cu sistem extern

**B) Cine sunt utilizatorii țintă?**
1. End users (clienți finali)
2. Admin/Staff intern
3. Developers (API/SDK)
4. Sistem automatizat

**C) Ce constrângeri tehnice există?**
1. Trebuie să folosească framework/librărie existentă
2. Fără dependențe externe noi
3. Compatibilitate backwards necesară
4. Flexibil

**D) Care e prioritatea?**
1. Urgent (blocant pentru release)
2. Important (următorul sprint)
3. Nice-to-have (când e timp)

**E) Ai specificații vizuale sau mockups?**
1. Da, am wireframes/mockups
2. Am idee generală în minte
3. Flexibil, propune tu

Pas 2: 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]

## 2. Obiective
### Obiectiv Principal
- [Ce problem rezolvă]

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

### Metrici de Succes
- [Cum măsurăm dacă e reușit]

## 3. User Stories

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

**Acceptance Criteria:**
- [ ] Criteriu 1 specific și testabil
- [ ] Criteriu 2 specific și testabil
- [ ] npm run typecheck passes
- [ ] [Pentru UI] Verify in browser that [comportament specific]

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

## 4. 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ă...

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

## 6. Considerații Tehnice
### Stack/Tehnologii
- [Ce framework/librării se folosesc]

### Patterns de Urmat
- [Patterns existente în codebase]

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

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

## 7. Considerații UI/UX
[Dacă e relevant]
- Layout și flow
- Stări (loading, error, empty, success)
- Accesibilitate

## 8. Success Metrics
- [KPI 1]: [target]
- [KPI 2]: [target]

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

Pas 3: Validare cu utilizatorul

După generare, întreabă:

• "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ă?"

Pas 4: Salvare

# Crează directorul tasks dacă nu există
mkdir -p tasks

# Salvează PRD-ul
# Folosește kebab-case pentru nume

Pas 5: 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: "npm run typecheck passes"

• Pentru UI: "Verify in browser that [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

Important

1. NU începe implementarea - acest skill doar generează documentație
2. Întreabă clarificări înainte de a genera
3. Stories atomice - fiecare trebuie să fie independent completabil
4. Acceptance criteria verificabile - nu vagi
5. Kebab-case pentru nume fișiere