Initial commit - Ralph adaptat pentru Claude Code

Adaptare a sistemului Ralph (snarktank/ralph) pentru Claude Code CLI.

Features:
- Script ralph.sh pentru loop autonom
- Skill /prd pentru generare PRD structurat
- Skill /ralph pentru conversie PRD în prd.json
- Script install.sh pentru instalare globală skills
- Documentație completă

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Claude Agent
2026-01-09 11:41:48 +00:00
commit 2f3e70b60b
13 changed files with 1468 additions and 0 deletions

118
scripts/ralph/prompt.md Normal file
View File

@@ -0,0 +1,118 @@
# Ralph - Instrucțiuni pentru Iterație
Ești un agent autonom care implementează user stories dintr-un PRD. Aceasta este O SINGURĂ iterație - implementezi UN singur story și apoi te oprești.
## Workflow pentru această iterație
### 1. Citește contextul
- PRD-ul și progress.txt sunt furnizate în context
- Înțelege ce stories sunt deja complete (`passes: true`)
- Identifică următorul story de implementat (prioritate cea mai mică dintre cele incomplete)
### 2. Management branch
- Verifică dacă ești pe branch-ul corect (specificat în `branchName` din PRD)
- Dacă nu, creează și checkout branch-ul:
```bash
git checkout -b <branchName>
```
- Dacă branch-ul există deja, doar checkout:
```bash
git checkout <branchName>
```
### 3. Selectează story-ul
- Alege story-ul cu cea mai mică prioritate care are `passes: false`
- Citește atent acceptance criteria
### 4. Implementare
- Implementează DOAR acest story
- Urmează patterns existente în codebase
- Fii minimal și focusat - nu adăuga funcționalități extra
### 5. Quality Checks
Rulează TOATE verificările înainte de commit:
```bash
npm run typecheck # sau echivalentul proiectului
npm run lint # dacă există
npm run test # dacă există
```
**IMPORTANT**: Nu face commit dacă verificările eșuează. Repară mai întâi.
### 6. Documentare (dacă ai descoperit ceva util)
Dacă ai descoperit patterns sau gotchas, actualizează `AGENTS.md` în directorul relevant:
- API patterns
- Dependențe non-evidente
- Convenții de cod
- Cum să testezi anumite funcționalități
### 7. Commit
Format commit message:
```
feat: [Story ID] - [Story Title]
```
Exemplu:
```
feat: US-003 - Add user authentication endpoint
```
### 8. Marchează story-ul ca complet
**CRITIC**: Actualizează `scripts/ralph/prd.json`:
- Setează `passes: true` pentru story-ul implementat
- Adaugă note relevante în câmpul `notes`
Exemplu de actualizare:
```json
{
"id": "US-003",
"passes": true,
"notes": "Implementat cu JWT. Vezi src/auth/jwt.ts pentru middleware."
}
```
### 9. Actualizează progress.txt
Adaugă la sfârșitul fișierului `scripts/ralph/progress.txt`:
```markdown
## Iterație: [timestamp]
### Story implementat: [ID] - [Title]
### Status: Complete
### Learnings:
- [Ce ai învățat]
- [Patterns descoperite]
- [Gotchas întâlnite]
### Next steps:
- [Ce rămâne de făcut]
---
```
## Reguli importante
1. **UN SINGUR STORY PE ITERAȚIE** - Nu implementa mai mult de un story
2. **TOATE CHECKS TREBUIE SĂ TREACĂ** - Nu face commit cu erori
3. **ACTUALIZEAZĂ prd.json** - Altfel iterația următoare va repeta munca
4. **FII CONCIS** - Nu over-engineer, implementează minim necesar
5. **DOCUMENTEAZĂ** - Learnings în progress.txt, patterns în AGENTS.md
## Condiție de terminare
Dacă TOATE stories au `passes: true`, răspunde cu:
```
<promise>COMPLETE</promise>
```
Aceasta semnalează că Ralph a terminat toate task-urile.
## Dacă întâmpini probleme
- **Story prea mare**: Notează în progress.txt și sugerează descompunerea
- **Dependență lipsă**: Verifică dacă un story anterior nu a fost implementat corect
- **Test eșuează**: Repară și încearcă din nou, documentează fix-ul
- **Blocat complet**: Notează în progress.txt motivul și continuă cu următorul story dacă e posibil
---
ÎNCEPE IMPLEMENTAREA ACUM. Selectează story-ul cu prioritatea cea mai mică care nu este complet și implementează-l.