Best Practices¶

Pravila i savjeti naučeni iz prakse i radionice. Ove smjernice pomažu da izbjegnete česte greške i maksimalno iskoristite AI-assisted workflow.

Čitajte planove¶

Najvažnije pravilo

Uvijek pročitajte plan prije nego ga odobrite. Kad nismo čitali planove, AI bi "zakukuljio" — nastavio raditi na lošoj arhitekturi i pravio greške koje se gomilaju. Plan je vaša jedina prilika da ispravite smjer prije nego se krene u implementaciju.

Šta gledati u planu:

Da li je scope ispravan — radi li AI ono što ste tražili?
Da li je arhitektura logična — koristi li prave paterne i biblioteke?
Da li su taskovi razumne veličine — previše mali ili preveliki?
Da li nedostaje nešto — edge case, validacija, error handling?

Držite se scope-a faze¶

Ne dodajte zahtjeve u sredini faze. Ako tokom izvršenja shvatite da treba nešto dodatno:

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

Anti-pattern

"Čekaj, dodaj mi i dark mode dok radiš ovu formu" — ovo vodi u nekontrolisano širenje scope-a. AI gubi fokus, plan više ne odgovara implementaciji, a verifikacija ne pokriva nove zahtjeve.

"Pošalji malog" — Delegirajte na sub-agente¶

Nikad ne trošite kontekst parent agenta na istraživanje ili dugi rad. Umjesto toga, delegirajte:

"Pošalji malog da istraži kako radi Stripe webhook integracija"

Zašto:

Parent agent = menadžer. Koordinira, odobrava, prati progress
Sub-agent = vojnik. Dobija čist kontekst (200k tokena), uradi posao, vrati sažetak
Ako parent agent potroši kontekst na istraživanje, nema prostora za koordinaciju

Tabula rasa — Čist kontekst¶

Zamislite udžbenik: AI markerom podvuče ono što je bitno. Kad pokrenete /clear, AI učita samo podvučene dijelove iz .planning/ foldera.

Praktično:

/clear nije gubitak — sve bitno je sačuvano u state.md, roadmap.md, PLAN.md
Čist kontekst = bolji rezultati (manje šuma, manje konfuzije)
Koristite /clear između svake faze

# Završi fazu → Commituj → Clear → Nova faza
/gsd:verify-work
/commit
/clear
/gsd:plan-phase

Skills prije inicijalizacije¶

Ako znate da ćete raditi u specifičnoj tehnologiji, učitajte relevantne skillove prije /gsd:new-project:

# Primjer: Next.js projekt sa Google Maps
"Učitaj Context7 dokumentaciju za Next.js"
"Učitaj Google Maps skill"

# Tek onda:
/gsd:new-project

AI će odmah imati dokumentaciju u kontekstu i dati kvalitetnije rezultate tokom research faze.

Node.js RAM alokacija¶

Node.js ima poznati memory leak problem koji se manifestira kod dugih sesija ili velikih projekata.

Preporuka — alocirajte dovoljno RAM-a:

# Dodaj u ~/.bashrc ili ~/.zshrc
export NODE_OPTIONS="--max-old-space-size=16384"

Ovo alocira 16 GB RAM-a za Node.js proces. Monitoring:

Pratite RAM korištenje u Activity Monitor (macOS) ili htop (Linux)
Ako primjetite da Claude Code postaje spor, restartujte sesiju

Povjerljivost¶

Interno znanje

Interni workflow, konfiguracije, i alati koje koristimo su povjerljivi. Ne dijeli detalje o našem setupu, alatima, ili procesima van firme. Ovo uključuje:

Specifičnu konfiguraciju CCR-a i routing pravila
Interne skillove i custom promptove
Detalje o modelima i provajderima koje koristimo
Workflow i procese specifične za naš tim