claude-plugins/plugins/ralph

Ralph Plugin

Ralph este un loop autonom de agent AI care rulează Claude Code în mod repetat până când toate task-urile dintr-un PRD sunt complete.

Adaptat din snarktank/ralph pentru Claude Code CLI.

Comenzi disponibile

Comandă	Descriere
/ralph:prd	Generează PRD structurat cu întrebări clarificatoare
/ralph:convert	Convertește PRD markdown în prd.json pentru execuție

Workflow

1. /ralph:prd       → Generează PRD markdown cu întrebări clarificatoare
2. /ralph:convert   → Convertește PRD în prd.json pentru execuție
3. ./ralph.sh       → Rulează loop-ul autonom

Ciclul Ralph

┌──────────────────────────────────────────────────────────────────┐
│                      CICLUL RALPH                                │
├──────────────────────────────────────────────────────────────────┤
│  1. Citește prd.json → selectează story cu prioritate minimă     │
│  2. Lansează instanță fresh Claude Code (context curat)          │
│  3. Implementează story-ul selectat                              │
│  4. Rulează quality checks (typecheck, tests, lint)              │
│  5. Commit dacă trece → marchează story ca "passes: true"        │
│  6. Salvează learnings în progress.txt                           │
│  7. Repetă până toate story-urile sunt complete                  │
└──────────────────────────────────────────────────────────────────┘

Utilizare

Pas 1: Generează PRD

/ralph:prd

Vreau să adaug funcționalitate de export CSV pentru dashboard.

Claude va pune întrebări clarificatoare și va genera PRD în /tasks/prd-export-csv.md.

Pas 2: Convertește în JSON

/ralph:convert

Convertește PRD-ul din tasks/prd-export-csv.md

Claude va crea structura scripts/ralph/ și genera prd.json.

Pas 3: Rulează Ralph

./scripts/ralph/ralph.sh 20  # 20 iterații max

Pas 4: Monitorizare

jq '.userStories[] | {id, title, passes}' scripts/ralph/prd.json
cat scripts/ralph/progress.txt

Structura proiectului

your-project/
├── scripts/ralph/
│   ├── ralph.sh          # Script principal
│   ├── prompt.md         # Instrucțiuni per iterație
│   ├── prd.json          # Task-uri și status (generat)
│   ├── progress.txt      # Learnings (generat)
│   └── logs/             # Logs per iterație
└── tasks/
    └── prd-*.md          # PRD-uri markdown

Templates incluse

Template	Descriere
ralph.sh	Scriptul principal de loop autonom
prompt.md	Instrucțiuni pentru fiecare iterație
prd-template.json	Schema JSON pentru PRD

Reguli pentru stories bune

Mărime corectă (1 context window)

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

Ordinea priorităților

1. Schema/Database (priority: 1-10)
2. Backend logic (priority: 11-20)
3. API endpoints (priority: 21-30)
4. UI components (priority: 31-40)
5. Integration/polish (priority: 41-50)

Cerințe

• Claude Code CLI instalat și autentificat
• jq pentru procesare JSON
• Git repository

Credite

• snarktank/ralph - Ralph original pentru Amp