# Forget Ralph Loops: The New GSD Framework for Claude Code

**Video:** https://www.youtube.com/watch?v=l94A53kIUB0
**Canal:** Eric (fost inginer la Amazon, AWS, Microsoft)
**Durată:** 20:01
**Salvat:** 2026-01-29
**Tags:** #claude-code #gsd #framework #sub-agents #automation @work

---

## 📋 TL;DR

GSD (Get Shit Done) este un framework open-source pentru Claude Code care orchestrează sub-agenți pentru a completa proiecte urmând spec-driven development. Rezolvă problema "context bloat" prin rularea fiecărui task în sub-agenți cu context proaspăt.

---

## 🎯 Problema Rezolvată

**Context Bloat în Traditional Spec-Driven Development:**
- Tot (planning, research, development, verification) într-o singură fereastră de context
- Mai multe tokeni = acuratețe mai mică
- BMA Method, Spec Kits, TaskMaster - toate suferă de asta

**Soluția GSD:**
- Fiecare task rulează într-un **sub-agent cu context proaspăt**
- GSD = orchestrator care coordonează sub-agenții
- Mai mulți tokeni consumați, dar **acuratețe mult mai mare**

---

## 🔧 Instalare

```bash
# În terminal, în folderul proiectului
npx gsd
```

Opțiuni la instalare:
- Claude Code / Open Code / Both
- Global (pentru toate proiectele) sau local
- Status line personalizat

---

## 📝 Workflow GSD

### 1. Mapare Codebase (pentru proiecte existente)
```
gsd map
```
- Spin up 4 agenți paraleli
- Analizează: tech stack, arhitectură, convenții, concerns
- Salvează în `planning/codebase/`

### 2. Inițializare Proiect
```
gsd init
```
- Întrebări despre feature-uri noi
- Spin up sub-agenți pentru research (security, UX, best practices)
- Identifică gaps în spec
- Generează `project.md`

### 3. Configurare Execuție
**Moduri:**
- **YOLO Mode** - auto-approve, hands-off
- **Interactive** - confirmare la fiecare pas

**Profunzime planning:**
- Quick (3-5 faze, 1-3 planuri fiecare) - shipping fast
- Standard (5-8 faze, 3-5 planuri fiecare) - balanced

**Execuție:**
- **Parallel** - planuri independente simultan
- **Sequential** - unul după altul (recomandat dacă timpul nu e problemă)

### 4. Research
- Sub-agenți cercetează domeniul
- Research Synthesizer combină rezultatele
- Generează research report

### 5. Roadmap
- Generează faze și cerințe
- Mapează toate requirements la faze
- Exemplu: 5 faze, 36 cerințe

### 6. Execuție
```
# Execută toate fazele secvențial cu context proaspăt
GSD executor
```
- Fiecare agent primește **200k context curat**
- Commit după fiecare task completat
- Spin up agent de verificare după fiecare task

---

## 🎨 Structura Fișierelor

```
planning/
├── codebase/           # Mapare codebase
├── config.json         # Configurare GSD
├── project.md          # Spec-ul proiectului
├── research/           # Rapoarte de research
├── roadmap/            # Fazele și planurile
└── phases/
    ├── phase-1/
    ├── phase-2/
    └── ...
```

---

## 💡 Tips & Best Practices

1. **Pregătește un spec detaliat înainte**
   - UX mockups, features, MVP requirements
   - Lasă AI să te ajute să-l draftuiești

2. **Folosește Sequential pentru stabilitate**
   - Dacă rămâi fără credite în Parallel, ambele task-uri incomplete
   - În Sequential, cel puțin unele task-uri sunt complete

3. **Lasă GSD să facă research**
   - Identifică security gaps
   - Best practices
   - Technical implementation issues

4. **Git tracking pentru planning docs**
   - Păstrează istoricul planificării
   - Poți reveni la versiuni anterioare

5. **Model preference**
   - Opus pentru research și roadmap (deeper analysis)
   - Sonnet pentru execution (mai rapid, mai ieftin)

---

## 🔄 Comparație cu alte Framework-uri

| Framework | Context | Sub-agenți | Verificare |
|-----------|---------|------------|------------|
| BMA Method | Single | ❌ | Manual |
| TaskMaster | Single | ❌ | Manual |
| **GSD** | **Fresh per task** | ✅ | **Auto** |

---

## ✅ Ce a construit în demo

Admin Dashboard cu:
- User management (list, search, filter)
- Credit adjustment
- Tier management  
- Audit logs
- Analytics

5 faze, 36 cerințe, totul automat.

---

## 🔗 Resurse

- Video: https://www.youtube.com/watch?v=l94A53kIUB0
- GSD Repository: (link în descriere video)
- Zustand pentru state management (menționat la final)
