GSD Workflow¶

Get Stuff Done (GSD) je strukturirani workflow za AI-assisted razvoj koji osigurava kvalitet, konzistentnost i kontrolu nad cijelim procesom.

Šta je GSD?¶

GSD je set konvencija i komandi za Claude Code koji organizuje rad u jasne faze. Svaka faza ima svoj cilj, alate i verifikaciju. Ključna ideja: čovjek odobrava svaki korak prije izvršenja.

Agenti¶

GSD koristi hijerarhiju specijaliziranih agenata. Vi komunicirate samo sa parent agentom (menadžerom), a on dispečuje posao na sub-agente.

graph TD
    U["👤 Vi (čovjek u petlji)"] -->|komunicirate sa| M["🧠 Parent Agent / Menadžer"]
    M -->|dispečuje| R["🔍 Researcher"]
    M -->|dispečuje| P["📋 Planner"]
    M -->|dispečuje| E["⚙️ Executor"]
    M -->|dispečuje| V["✅ Verifier"]

    R -->|vraća sažetak| M
    P -->|vraća plan| M
    E -->|vraća rezultat| M
    V -->|vraća izvještaj| M

    style U fill:#e1f5fe
    style M fill:#fff3e0
    style R fill:#f3e5f5
    style P fill:#f3e5f5
    style E fill:#f3e5f5
    style V fill:#f3e5f5

Agent	Uloga	Analogija
Parent / Menadžer	Koordinira sve, komunicira sa vama	Project manager
Researcher	Istražuje dokumentaciju, analizira mogućnosti	Analitičar
Planner	Kreira detaljne planove sa task breakdownom	Arhitekta
Executor	Izvršava plan — piše kod, pravi commitove	Vojnik — izvršava, ne razmišlja
Verifier	Poredi plan sa implementacijom	QA inženjer

Čist kontekst

Svaki sub-agent kreće sa čistim kontekstom i ima na raspolaganju do 200k tokena. To znači da svaki agent može primiti veliku količinu informacija bez da "zagadi" kontekst parent agenta.

Hijerarhija: Milestone → Faza → Task¶

GSD organizuje rad u tri nivoa:

graph TD
    MS["🎯 Milestone"] --> F1["📦 Faza 1"]
    MS --> F2["📦 Faza 2"]
    MS --> F3["📦 Faza 3"]

    F1 --> T1["☑️ Task 1.1"]
    F1 --> T2["☑️ Task 1.2"]
    F1 --> T3["☑️ Task 1.3"]

    F2 --> T4["☑️ Task 2.1"]
    F2 --> T5["☑️ Task 2.2"]

    F3 --> T6["☑️ Task 3.1"]
    F3 --> T7["☑️ Task 3.2"]

    style MS fill:#e8eaf6
    style F1 fill:#e0f2f1
    style F2 fill:#e0f2f1
    style F3 fill:#e0f2f1

Nivo	Opis	Primjer
Milestone	Veliki cilj, grupa faza	"Communities modul", "Admin panel"
Faza	Dio milestone-a, ima svoj plan i verifikaciju	"Core RTL komponente", "API integracija"
Task	Atomičan posao unutar faze, jedan commit	"Kreiraj UserCard komponentu"

Pravila¶

Milestone je aktivan dok se ne završi — ne može se skakati između milestone-ova
Faze se izvršavaju sekvencijalno unutar milestone-a
Taskovi unutar faze mogu ići paralelno (wave-based execution)
Dodavanje faza u toku rada: /gsd:add-phase (na kraj) ili /gsd:insert-phase (između postojećih)

Faze rada¶

graph LR
    A["🗺️ Map/Init"] --> B["🔍 Research"]
    B --> C["📋 Plan"]
    C --> D["⚙️ Execute"]
    D --> E["✅ Verify"]
    E -->|sljedeća faza| B

    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#fff3e0
    style D fill:#e8f5e9
    style E fill:#fce4ec

1. Map / Init¶

Inicijalizacija projekta ili mapiranje postojećeg codebase-a.

/gsd:new-project — pokreće novi projekat sa dubokim context gatheringom
/gsd:map-codebase — analizira codebase paralelnim agentima

Rezultat: PROJECT.md i .planning/ direktorij sa strukturiranim informacijama.

2. Research¶

Istraživanje prije planiranja — dohvaćanje dokumentacije, analiza mogućnosti.

/gsd:research-phase — standalone istraživanje (obično se koristi kroz plan-phase)
/gsd:discuss-phase — adaptivno pitanje/odgovor za prikupljanje konteksta

3. Plan¶

Kreiranje detaljnog plana izvršenja sa task breakdownom.

/gsd:plan-phase — kreira PLAN.md sa verifikacionom petljom
/gsd:list-phase-assumptions — prikazuje pretpostavke prije planiranja

Čovjek u petlji — OBAVEZNO

Uvijek pregledajte plan prije odobrenja. Kad nismo čitali planove, AI bi nastavio na lošoj arhitekturi i "zakukuljio" — pravio greške koje se gomilaju fazu za fazom. Plan je vaša jedina prilika da ispravite smjer.

Šta gledati:

Scope — radi li ono što ste tražili?
Arhitektura — koristi li prave paterne?
Veličina taskova — previše mali ili preveliki?
Nedostaci — edge cases, validacija, error handling?

4. Execute¶

Izvršenje plana sa atomičnim commitovima.

/gsd:execute-phase — izvršava plan sa wave-based paralelizacijom
/gsd:quick — za brze zadatke sa GSD garancijama (atomic commits, state tracking)

5. Verify¶

Validacija da je faza postigla svoj cilj.

/gsd:verify-work — konverzacijski UAT (User Acceptance Testing)
/gsd:audit-milestone — audit milestone-a prije arhiviranja

Scope disciplina¶

Ne širite scope u toku faze

Ako tokom izvršenja shvatite da treba nešto dodatno — ne dodajte to u trenutnu fazu. Umjesto toga:

Zapišite zahtjev (Jira, bilješka)
Pustite fazu da se završi
Koristite /gsd:add-phase ili /gsd:insert-phase

Dodavanje zahtjeva u sredini faze vodi u nekontrolisano širenje scope-a. Plan više ne odgovara implementaciji, a verifikacija ne pokriva nove zahtjeve.

Ključne komande¶

Komanda	Opis
`/gsd:new-project`	Inicijalizacija novog projekta
`/gsd:plan-phase`	Planiranje faze sa verifikacijom
`/gsd:execute-phase`	Izvršenje plana
`/gsd:verify-work`	Validacija rezultata
`/gsd:progress`	Provjera napretka i sljedeći korak
`/gsd:pause-work`	Kreiranje context handoffa pri pauzi
`/gsd:resume-work`	Nastavak rada iz prethodne sesije
`/gsd:add-phase`	Dodavanje faze na kraj milestone-a
`/gsd:insert-phase`	Umetanje hitnog rada između faza
`/gsd:debug`	Sistematski debugging sa persistentnim stanjem

Za kompletnu listu svih komandi pogledajte Cheat Sheet.

Context Management¶

`.planning/` folder — Mozak projekta¶

GSD čuva kompletno stanje projekta u .planning/ direktoriju:

Fajl	Sadržaj
`state.md`	Trenutni milestone, faza, status taskova
`roadmap.md`	Pregled svih milestone-ova i faza
`PLAN.md`	Detaljan plan trenutne faze
`research/`	Rezultati istraživanja
`VERIFICATION.md`	Izvještaji verifikacije

Tabula rasa — Metafora udžbenika¶

Zamislite da AI čita udžbenik i markerom podvlači bitne dijelove. Tokom rada, kontekst se puni informacijama. Kad pokrenete /clear:

Kontekst se briše (prazna tabla)
Ali "podvučeni dijelovi" ostaju u .planning/ folderu
Kad pokrenete novu fazu, AI učita samo podvučeno — čist, fokusiran kontekst

Zašto je `/clear` bitan¶

Claude Code ima ograničen context window. Kada radite na velikom projektu:

Koristite /clear između faza da oslobodite kontekst
GSD automatski čuva stanje u .planning/ direktoriju
/gsd:resume-work restaurira kontekst iz sačuvanog stanja

Zašto parent agent ne smije preći limit¶

Parent agent koordinira sve sub-agente. Ako potroši kontekst na istraživanje ili detaljan rad:

Nema prostora za nove rezultate od sub-agenata
Gubi pregled nad cijelim projektom
Kvalitet koordinacije drastično pada

Zato: delegirajte na sub-agente ("pošalji malog"), a parent agent neka samo koordinira.

Token counter¶

Koristite token counter plugin da pratite potrošnju konteksta:

Progress bar — vizualni indikator popunjenosti
Upozorenje — kad kontekst prelazi 80% kapaciteta
Kad vidite upozorenje → završite trenutni zadatak → /clear → nastavite

Primjer kompletnog toka rada¶

# 1. Inicijalizacija projekta
/gsd:new-project
# → AI pokreće research agente, kreira roadmap

# 2. Planiranje prve faze
/gsd:plan-phase
# → Pročitajte plan → Odobrite ili korigujte

# 3. Izvršenje
/gsd:execute-phase
# → AI kreira taskove, pravi atomične commitove

# 4. Verifikacija
/gsd:verify-work
# → UAT — provjerite da sve radi

# 5. Čišćenje i nastavak
/clear
/gsd:progress
# → Automatski predlaže sljedeći korak