romfast/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3d52ac696c9cbf7dfc455aa255e04176e874bd4c
claude-plugins/plugins/ralph/README.md
Claude Agent 3d52ac696c feat(ralph): Add ralph plugin for autonomous PRD implementation 
- Add /ralph:prd command for PRD generation with clarifying questions
- Add /ralph:convert command to convert PRD to executable JSON
- Include templates: ralph.sh, prompt.md, prd-template.json
- Include example PRD (prd-hello-api.json)
- Update marketplace.json with ralph plugin v1.0.0
- Update README with ralph documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 21:37:03 +00:00

3.7 KiB
Raw Blame History

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