feat(ralph): v1.1.0 - Context detection, adaptive questions, browser verification
Major improvements inspired by coleam00/ai-agents-masterclass: - prd.md: Auto-detect project context (package.json, pyproject.toml, etc.) - NEW_PROJECT_MODE: ~10 questions for new projects - FEATURE_MODE: ~5-7 questions for existing projects - Uses AskUserQuestion for interactive UX - Optional WebSearch for best practices - convert.md: Extended functionality - Generates .claude/settings.json with allow-list per tech stack - Extracts real commands from package.json scripts - Adds techStack info to prd.json - Creates screenshots/ directory - prompt.md: Browser verification with agent-browser CLI - Compact refs (@e1, @e2) for minimal token usage - requiresBrowserCheck flag per story - Screenshot saving for UI verification - ralph.sh: Screenshots directory + agent-browser check - README.md: Complete rewrite with new features Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Claude Agent
@@ -29,13 +29,145 @@ Citește fișierul PRD și identifică:
|
||||
- User stories cu acceptance criteria
|
||||
- Dependențe între stories
|
||||
|
||||
### Pas 3: Creează structura Ralph
|
||||
### Pas 3: Detectează Tech Stack
|
||||
|
||||
```bash
|
||||
mkdir -p scripts/ralph/logs scripts/ralph/archive
|
||||
**Verifică fișierele de config pentru a determina stack-ul:**
|
||||
|
||||
```
|
||||
package.json → Node.js/JavaScript
|
||||
pyproject.toml → Python
|
||||
go.mod → Go
|
||||
Cargo.toml → Rust
|
||||
pom.xml → Java
|
||||
```
|
||||
|
||||
### Pas 4: Generează prd.json
|
||||
**Extrage comenzi din config:**
|
||||
|
||||
Pentru `package.json`:
|
||||
```javascript
|
||||
// Citește scripts section:
|
||||
{
|
||||
"scripts": {
|
||||
"dev": "next dev", // → START_COMMAND
|
||||
"build": "next build", // → BUILD_COMMAND
|
||||
"lint": "eslint .", // → LINT_COMMAND
|
||||
"typecheck": "tsc --noEmit" // → TYPECHECK_COMMAND
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Mapare comenzi standard:**
|
||||
|
||||
| Stack | Start | Build | Lint | Typecheck |
|
||||
|-------|-------|-------|------|-----------|
|
||||
| Next.js | npm run dev | npm run build | npm run lint | npm run typecheck |
|
||||
| Node/Express | npm start | npm run build | npm run lint | npm run typecheck |
|
||||
| Python/FastAPI | uvicorn main:app --reload | - | ruff check . | mypy . |
|
||||
| Go | go run . | go build | golangci-lint run | - |
|
||||
| Rust | cargo run | cargo build | cargo clippy | - |
|
||||
|
||||
### Pas 4: Creează structura Ralph
|
||||
|
||||
```bash
|
||||
mkdir -p scripts/ralph/logs scripts/ralph/archive scripts/ralph/screenshots
|
||||
```
|
||||
|
||||
### Pas 5: Generează .claude/settings.json
|
||||
|
||||
**IMPORTANT**: Generează configurația pentru permissions allow-list bazat pe tech stack detectat.
|
||||
|
||||
```bash
|
||||
mkdir -p .claude
|
||||
```
|
||||
|
||||
**Template settings.json per stack:**
|
||||
|
||||
#### Next.js / TypeScript:
|
||||
```json
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"npm run dev",
|
||||
"npm run build",
|
||||
"npm run lint",
|
||||
"npm run typecheck",
|
||||
"npx prisma generate",
|
||||
"npx prisma migrate dev",
|
||||
"npx prisma db push",
|
||||
"npm test",
|
||||
"npm run test:*"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### Node.js / Express:
|
||||
```json
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"npm start",
|
||||
"npm run dev",
|
||||
"npm run build",
|
||||
"npm run lint",
|
||||
"npm test",
|
||||
"npm run test:*"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### Python / FastAPI:
|
||||
```json
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"uvicorn * --reload",
|
||||
"python -m pytest",
|
||||
"ruff check .",
|
||||
"ruff format .",
|
||||
"mypy .",
|
||||
"pip install *",
|
||||
"alembic upgrade head",
|
||||
"alembic revision *"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### Go:
|
||||
```json
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"go run .",
|
||||
"go build",
|
||||
"go test ./...",
|
||||
"golangci-lint run",
|
||||
"go mod tidy"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### Generic (fără config detectat):
|
||||
```json
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"npm run *",
|
||||
"npm test",
|
||||
"npm start"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Verifică și merging:**
|
||||
- Dacă `.claude/settings.json` există deja, citește-l și merge permissions
|
||||
- Nu suprascrie setări existente, doar adaugă cele lipsă
|
||||
|
||||
### Pas 6: Generează prd.json
|
||||
|
||||
Convertește user stories în format JSON cu următoarea structură:
|
||||
|
||||
@@ -44,6 +176,17 @@ Convertește user stories în format JSON cu următoarea structură:
|
||||
"projectName": "feature-name",
|
||||
"branchName": "ralph/feature-name",
|
||||
"description": "Descriere din PRD",
|
||||
"techStack": {
|
||||
"type": "nextjs",
|
||||
"commands": {
|
||||
"start": "npm run dev",
|
||||
"build": "npm run build",
|
||||
"lint": "npm run lint",
|
||||
"typecheck": "npm run typecheck",
|
||||
"test": "npm test"
|
||||
},
|
||||
"port": 3000
|
||||
},
|
||||
"userStories": [
|
||||
{
|
||||
"id": "US-001",
|
||||
@@ -54,6 +197,7 @@ Convertește user stories în format JSON cu următoarea structură:
|
||||
"Criteriu specific și verificabil",
|
||||
"npm run typecheck passes"
|
||||
],
|
||||
"requiresBrowserCheck": true,
|
||||
"passes": false,
|
||||
"notes": ""
|
||||
}
|
||||
@@ -61,7 +205,13 @@ Convertește user stories în format JSON cu următoarea structură:
|
||||
}
|
||||
```
|
||||
|
||||
### Pas 5: Validează mărimea stories
|
||||
**Câmpuri noi:**
|
||||
- `techStack` - informații despre stack-ul detectat
|
||||
- `techStack.commands` - comenzile reale din proiect
|
||||
- `techStack.port` - portul pentru dev server
|
||||
- `requiresBrowserCheck` - true dacă story-ul are UI
|
||||
|
||||
### Pas 7: Validează mărimea stories
|
||||
|
||||
**CRITIC**: Fiecare story trebuie să fie completabil într-un singur context window.
|
||||
|
||||
@@ -78,7 +228,7 @@ Convertește user stories în format JSON cu următoarea structură:
|
||||
|
||||
Dacă găsești stories prea mari, sparge-le în sub-stories mai mici.
|
||||
|
||||
### Pas 6: Setează prioritățile
|
||||
### Pas 8: Setează prioritățile
|
||||
|
||||
Ordinea recomandată:
|
||||
1. Schema/Database changes (priority: 1-10)
|
||||
@@ -89,35 +239,92 @@ Ordinea recomandată:
|
||||
|
||||
Stories care depind de altele trebuie să aibă prioritate mai mare (număr mai mare).
|
||||
|
||||
### Pas 7: Verifică acceptance criteria
|
||||
### Pas 9: Verifică acceptance criteria
|
||||
|
||||
Fiecare story TREBUIE să aibă:
|
||||
- Criterii specifice și verificabile (NU vagi ca "funcționează bine")
|
||||
- `npm run typecheck passes` (sau echivalent)
|
||||
- Pentru UI: `Verify in browser that [specific behavior]`
|
||||
- Comanda reală de typecheck: `{TYPECHECK_COMMAND} passes`
|
||||
- Pentru UI: `Verificare vizuală browser: [specific behavior]`
|
||||
|
||||
### Pas 8: Copiază fișierele Ralph
|
||||
### Pas 10: Copiază și actualizează fișierele Ralph
|
||||
|
||||
Dacă nu există deja, copiază template-urile din plugin:
|
||||
**Copiază template-urile din plugin:**
|
||||
- `scripts/ralph/ralph.sh` - scriptul principal (din templates/ralph.sh)
|
||||
- `scripts/ralph/prompt.md` - instrucțiunile per iterație (din templates/prompt.md)
|
||||
|
||||
### Pas 9: Inițializează progress.txt
|
||||
**Actualizează prompt.md cu comenzile reale:**
|
||||
|
||||
Înlocuiește placeholder-ii din prompt.md:
|
||||
```
|
||||
{START_COMMAND} → npm run dev (sau comanda reală)
|
||||
{BUILD_COMMAND} → npm run build
|
||||
{LINT_COMMAND} → npm run lint
|
||||
{TYPECHECK_COMMAND}→ npm run typecheck
|
||||
{TEST_COMMAND} → npm test
|
||||
{PORT} → 3000 (sau portul real)
|
||||
```
|
||||
|
||||
**Template prompt.md actualizat:**
|
||||
|
||||
În secțiunea Quality Checks, înlocuiește:
|
||||
```markdown
|
||||
### 5. Quality Checks
|
||||
Rulează TOATE verificările înainte de commit:
|
||||
```bash
|
||||
{TYPECHECK_COMMAND} # Type checking
|
||||
{LINT_COMMAND} # Linting
|
||||
{TEST_COMMAND} # Tests (dacă există)
|
||||
```
|
||||
```
|
||||
|
||||
### Pas 11: Inițializează progress.txt
|
||||
|
||||
```bash
|
||||
echo "# Ralph Progress Log" > scripts/ralph/progress.txt
|
||||
echo "Started: $(date)" >> scripts/ralph/progress.txt
|
||||
echo "Project: [project-name]" >> scripts/ralph/progress.txt
|
||||
echo "Stack: [detected-stack]" >> scripts/ralph/progress.txt
|
||||
echo "---" >> scripts/ralph/progress.txt
|
||||
```
|
||||
|
||||
### Pas 10: Instrucțiuni finale
|
||||
### Pas 12: Verificare finală
|
||||
|
||||
**Verifică că toate fișierele sunt create:**
|
||||
|
||||
```
|
||||
scripts/ralph/
|
||||
├── ralph.sh # Script principal
|
||||
├── prompt.md # Instrucțiuni (cu comenzi reale)
|
||||
├── prd.json # Task-uri și status
|
||||
├── progress.txt # Log inițializat
|
||||
├── logs/ # Director pentru logs
|
||||
├── archive/ # Director pentru arhivare
|
||||
└── screenshots/ # Director pentru verificări vizuale
|
||||
|
||||
.claude/
|
||||
└── settings.json # Permissions allow-list
|
||||
```
|
||||
|
||||
### Pas 13: Instrucțiuni finale
|
||||
|
||||
După completare, informează utilizatorul:
|
||||
|
||||
```
|
||||
PRD convertit în scripts/ralph/prd.json
|
||||
|
||||
Structură creată:
|
||||
scripts/ralph/ - Fișiere Ralph
|
||||
scripts/ralph/screenshots/ - Pentru verificări vizuale
|
||||
.claude/settings.json - Permissions pentru comenzi
|
||||
|
||||
Tech stack detectat: {stack}
|
||||
Comenzi configurate:
|
||||
Start: {START_COMMAND}
|
||||
Build: {BUILD_COMMAND}
|
||||
Typecheck: {TYPECHECK_COMMAND}
|
||||
Lint: {LINT_COMMAND}
|
||||
Test: {TEST_COMMAND}
|
||||
|
||||
Pentru a rula Ralph:
|
||||
cd [project-directory]
|
||||
./scripts/ralph/ralph.sh [max_iterations]
|
||||
@@ -125,18 +332,29 @@ Pentru a rula Ralph:
|
||||
Monitorizare:
|
||||
cat scripts/ralph/prd.json | jq '.userStories[] | {id, title, passes}'
|
||||
cat scripts/ralph/progress.txt
|
||||
|
||||
IMPORTANT:
|
||||
- Ralph va folosi agent-browser pentru verificări vizuale UI
|
||||
- Screenshots se salvează în scripts/ralph/screenshots/
|
||||
- Asigură-te că ai agent-browser instalat: npm install -g agent-browser && agent-browser install
|
||||
```
|
||||
|
||||
## Output așteptat
|
||||
|
||||
- `scripts/ralph/prd.json` - task-urile în format JSON
|
||||
- `scripts/ralph/prd.json` - task-urile în format JSON cu tech stack info
|
||||
- `scripts/ralph/progress.txt` - log inițializat
|
||||
- `scripts/ralph/prompt.md` - cu comenzile reale ale proiectului
|
||||
- `scripts/ralph/screenshots/` - director pentru verificări vizuale
|
||||
- `.claude/settings.json` - permissions allow-list pentru tech stack
|
||||
- Structura de directoare completă
|
||||
|
||||
## Reguli importante
|
||||
|
||||
1. **NU începe implementarea** - acest skill doar convertește PRD-ul
|
||||
2. **Validează mărimea stories** - sparge-le dacă sunt prea mari
|
||||
3. **Prioritizează corect** - dependențele trebuie respectate
|
||||
4. **Criterii verificabile** - nu vagi, ci specifice
|
||||
5. **Inițializează `passes: false`** pentru toate stories
|
||||
2. **Detectează tech stack** - pentru comenzi și settings.json
|
||||
3. **Validează mărimea stories** - sparge-le dacă sunt prea mari
|
||||
4. **Prioritizează corect** - dependențele trebuie respectate
|
||||
5. **Criterii verificabile** - nu vagi, ci specifice
|
||||
6. **Inițializează `passes: false`** pentru toate stories
|
||||
7. **Generează settings.json** - pentru allow-list permissions
|
||||
8. **Actualizează prompt.md** - cu comenzile reale ale proiectului
|
||||
|
||||
@@ -4,7 +4,7 @@ description: Generează un Product Requirements Document (PRD) structurat pentru
|
||||
|
||||
# Skill: PRD Generator
|
||||
|
||||
Generează un Product Requirements Document (PRD) detaliat pentru funcționalități noi prin întrebări clarificatoare și documentație structurată.
|
||||
Generează un Product Requirements Document (PRD) detaliat prin detecție automată a contextului și întrebări adaptive.
|
||||
|
||||
## Când să folosești acest skill
|
||||
|
||||
@@ -14,43 +14,305 @@ Generează un Product Requirements Document (PRD) detaliat pentru funcționalit
|
||||
|
||||
## Workflow
|
||||
|
||||
### Pas 1: Întrebări de clarificare
|
||||
### FAZA 1: Detecție Context Proiect
|
||||
|
||||
Înainte de a genera PRD-ul, pune 3-5 întrebări pentru a înțelege scopul:
|
||||
**Verifică existența fișierelor de config pentru a determina modul:**
|
||||
|
||||
```markdown
|
||||
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
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
### Pas 2: Generează PRD-ul
|
||||
**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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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):
|
||||
```json
|
||||
{
|
||||
"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`:
|
||||
|
||||
@@ -58,49 +320,55 @@ 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]
|
||||
[Context și motivație pentru feature - 2-3 propoziții bazate pe răspunsuri]
|
||||
|
||||
## 2. Obiective
|
||||
## 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ă]
|
||||
- [Ce problemă rezolvă - din răspunsuri]
|
||||
|
||||
### Obiective Secundare
|
||||
- [Beneficii adiționale]
|
||||
|
||||
### Metrici de Succes
|
||||
- [Cum măsurăm dacă e reușit]
|
||||
- [Din răspunsul la întrebarea despre success criteria]
|
||||
|
||||
## 3. User Stories
|
||||
## 4. User Stories
|
||||
|
||||
### US-001: [Titlu Descriptiv]
|
||||
**Ca** [tip utilizator]
|
||||
**Ca** [tip utilizator - din răspunsuri]
|
||||
**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]
|
||||
- [ ] {TYPECHECK_COMMAND} passes
|
||||
- [ ] [Pentru UI] Verificare vizuală cu browser: [comportament specific]
|
||||
|
||||
### US-002: [Titlu]
|
||||
...
|
||||
|
||||
## 4. Cerințe Funcționale
|
||||
## 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ă...
|
||||
|
||||
## 5. Non-Goals (Ce NU facem)
|
||||
## 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]
|
||||
|
||||
## 6. Considerații Tehnice
|
||||
## 7. Considerații Tehnice
|
||||
### Stack/Tehnologii
|
||||
- [Ce framework/librării se folosesc]
|
||||
- [Din detecție sau răspunsuri]
|
||||
|
||||
### Patterns de Urmat
|
||||
- [Patterns existente în codebase]
|
||||
- [Patterns existente în codebase - din analiză]
|
||||
|
||||
### Dependențe
|
||||
- [De ce depinde acest feature]
|
||||
@@ -108,47 +376,43 @@ După răspunsuri, creează documentul în `/tasks/prd-[feature-name].md`:
|
||||
### Riscuri Tehnice
|
||||
- [Potențiale probleme]
|
||||
|
||||
## 7. Considerații UI/UX
|
||||
[Dacă e relevant]
|
||||
### 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
|
||||
|
||||
## 8. Success Metrics
|
||||
- [KPI 1]: [target]
|
||||
- [KPI 2]: [target]
|
||||
## 9. Considerații Security
|
||||
[Din răspunsul la întrebarea despre security]
|
||||
|
||||
## 9. Open Questions
|
||||
## 10. 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ă?"
|
||||
### FAZA 4: Validare și salvare
|
||||
|
||||
### Pas 4: 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
|
||||
|
||||
```bash
|
||||
# Crează directorul tasks dacă nu există
|
||||
mkdir -p tasks
|
||||
**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ă
|
||||
```
|
||||
|
||||
# Salvează PRD-ul
|
||||
# Folosește kebab-case pentru nume
|
||||
```
|
||||
|
||||
### Pas 5: Sugerează următorul pas
|
||||
|
||||
```markdown
|
||||
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
|
||||
|
||||
@@ -176,19 +440,23 @@ PRD salvat în tasks/prd-[feature-name].md
|
||||
- Verificabile: "După submit, redirect la /dashboard"
|
||||
- NU subiective: "UX plăcut"
|
||||
|
||||
- Include ÎNTOTDEAUNA: "npm run typecheck passes"
|
||||
- Pentru UI: "Verify in browser that [behavior]"
|
||||
- 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. **Î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
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user