Iskreno, ovaj Claude Code repozitorijum sa 34.9k Star-a je korisniji od bilo kog tutoriala za promptove

Prošle nedelje uradio sam jednu stvar: prelistao sam shanraisshan/claude-code-best-practice repozitorijum od početka do kraja.

Iskreno, usput sam skoro odustao.

Ovaj projekat, u vreme pisanja ovog teksta, već ima 34.9k Star i 3.3k Fork. U README-u samo Beta funkcija ima 16.

https://github.com/shanraisshan/claude-code-best-practice

Takođe sadrži 10 glavnih razvojnih radnih tokova, 152 subagent-a, 194 komande, 352 skilla.

Zajedno sa 69 izabranih saveta, količina informacija je zastrašujuća.

01. Gustina sadržaja iza 34.9k Star-a

To što open source projekat ima oliko zvezda, samo po sebi pokazuje koliko je potreba za inženjeringom Claude Code-a tolika.

Struktura celog README-a je podeljena u četiri bloka.

• CONCEPTS osnovni koncepti
• Hot napredne Beta funkcije
• DEVELOPMENT WORKFLOWS poređenje razvojnih radnih tokova
• Zatim tips, implementation, tutorial nekoliko poddirektorijuma

Grubim prebrojavanjem, ima 152 subagent-a, 194 slash komande, 352 skilla.

U root direktorijumu se nalazi fascikla .claude/ spremna za upotrebu. Konfiguracije agents, commands, skills se mogu direktno prekopirati.

Ovo je posebno pogodno za lenjije kao ja.

02. 10 radnih tokova

Najvredniji deo ovog repozitorijuma, po mom mišljenju, je development-workflows direktorijum. Autor je prikupio 10 najpopularnijih Claude Code radnih tokova iz zajednice.

Svaki je raščlanjen po dimenzijama agent, command, skill.

Everything Claude Code je na prvom mestu. 148k Star. 47 agenta, 82 komande, 182 skilla.

Ide pristupom "želim sve".

Odmah za njim sledi Superpowers. 143k Star. Ali je iznenađujuće minimalan. 5 agenata, 3 komande, 14 skilova. Osnovna ideja je TDD-first i tzv. Iron Laws. Jednostavno rečeno, "dokle god testovi nisu gotovi, ne smeš pisati implementaciju". To je pravcima vođen pristup.

Spec Kit 87k Star. Ide putem spec-driven constitution-based. Prvo pišete spec dokumentaciju, pa onda kod. Pogodno za timove koji zahtevaju visoku konzistenciju.

gstack 68k Star. Fokusira se na role personas i parallel sprints. Dodeljuje Claudeu uloge "product manager", "architect", "frontend developer". Omogućava mu da se prebacuje između različitih uloga.

03. Testiranje 16 Beta funkcija

Zatim, deo repozitorijuma koji me je najviše okupirao, Hot sekcija.

Ovde su prikupljene sve funkcije Claude Code-a koje su trenutno u Beta fazi. Ukupno 16.

Božanski trio: Auto Mode, Git Worktrees, Agent Teams.

Korisno ali sa pragom: Claude Code Web, Scheduled Tasks, Agent SDK.

Neupotrebljivo: Voice Dictation, Computer Use.

Computer Use dozvoljava Claudeu da kontroliše naš ekran, automatski otvara aplikacije, klikće, kuca, radi screenshot. Koncept je veoma impresivan. U praksi, iskustvo je prilično neprijatno. Claude radi pet puta sporije od čoveka. I čim se interfejs malo promeni, izgubi se.

Daleko je od svakodnevne produktivnosti.

04. Auto Mode + Worktrees

Auto Mode. Svi koji su koristili Claude Code znaju o čemu se radi. Nakon svake komande, morate kliknuti "agree/cancel". Pri pisanju svakog fajla, morate potvrditi. Posle jednog dugog taska, samo klikutanje može izazvati grčeve u prstima.

Dizajn je prvobitno bio motivisan sigurnošću. Ali iskustvo je zaista neljudsko.

Posebno kada se u agent modu pokrene dugi zadatak. Usput iskoči desetinu potvrda, što nije mnogo drugačije od ručnog rada.

Auto Mode uvodi bezbednosni klasifikator. On u realnom vremenu procenjuje nivo rizika svake akcije.

Akcije niskog rizika, kao što su čitanje fajla, pokretanje testova, izmena biznis koda, se automatski puštaju. Akcije visokog rizika, kao što su brisanje fajlova, izmena CI konfiguracije, push na remote, tek tada traže potvrdu.

Zatim Git Worktrees.

Ova funkcija, strogo govoreći, nije nova stvar. Git sam podržava worktree već godinama. Ali kada ga je Claude Code integrisao, to je potpuno druga priča.

Scenarijo je ovakav. Često istovremeno radim na dve povezane ali nezavisne funkcije.

Tradicionalni pristup: kada završite jednu funkciju, prebacite se na granu druge. Usput morate stash, commit, pull. To veoma prekida tok.

I često, Claude radi dugi zadatak na grani A. A ja želim da napravim malu izmenu na grani B. Ove dve stvari se blokiraju.

Git Worktrees mi omogućava da u jednom repozitorijumu imam više radnih kopija. Svaka kopija odgovara nezavisnoj grani. Ne ometaju se.

Još bolje, repozitorijum nudi skripte koje prate. Omogućava više Claude instanci da rade u različitim worktree-ima.

To jest, možemo naterati Claude A da piše autentifikaciju na grani feature-login. Istovremeno Claude B da piše modul za notifikacije na grani feature-notification.

Dva procesa paralelno. Na kraju svaki svoj PR.

05. Agent Teams

Treća božanska funkcija je Agent Teams.

Ova funkcija omogućava više agenata da paralelno sarađuju na istom codebase-u.

Ima ugrađen mehanizam koordinacije zadataka. Zvuči slično onome što obično zovemo multi-agent.

Direktorijum agent-teams u repozitorijumu daje kompletan primer orkestracije.

Osnovna ideja je da se veliki zadatak raščlani u DAG, odnosno usmereni aciklični graf.

Svaki čvor se dodeljuje specijalizovanom agentu. Čvorovi koriste fajl sistem kao magistralu poruka. Na primer, za izradu kompletne funkcije, orkestracija izgleda ovako:

agent za analizu zahteva -> agent za arhitekturu -> [frontend agent + backend agent + baza agent] -> agent za integracione testove -> agent za generisanje dokumentacije

Svaki agent ima svoj nezavisni kontekstni prozor. Fokusira se samo na svoj deo. Ne ometaju se.

Podešavanja 152 subagenta prikupljena u ovom repozitorijumu su uglavnom definicioni fajlovi ovakvih specijalizovanih agenata. Ako ih prekopirate, uglavnom možete uštedeti pola godine muke.

Još jedna napomena.

Agent Teams potrošnja kontekst tokena raste linearno.

5 agenata paralelno, u osnovi 5 puta veća potrošnja.

06. 5 najpotresnijih od 69 saveta

Na kraju da probamo tips direktorijum. Autor je ovde prikupio 69 izabranih saveta, podeljenih u 13 kategorija. Izabrao sam 4 koja su na mene ostavila najjači utisak.

Prvi, CLAUDE.md neka bude ispod 200 linija

Stavite CLAUDE.md fajl u root direktorijum projekta, Claude Code će ga automatski pročitati i zapamtiti sadržaj.

Šta ovo znači?

Ranije, svaki put kada otvorite Claude Code, morate ručno da kažete: "Ovo je Spring Boot projekat, koristi MyBatis kao ORM okvir, kod konvencija zahteva camelCase, testovi koriste JUnit 5..."

Sada sve to zapišite u CLAUDE.md, i Claude Code odmah zna arhitekturu projekta, tech stack, kod konvencije, zahteve testiranja. Ne morate svaki put iznova da objašnjavate, pamtiće "karakter" vašeg projekta kao što pamti sklonosti starog prijatelja.

Naravno, ne morate ručno da menjate ovaj fajl, samo pokrenite komandu /init.

Šta jedno dobar CLAUDE.md treba da sadrži?

Pregled projekta: jednom rečenicom opišite čime se projekat bavi, šta je ključna funkcija, ko su ciljni korisnici.

Lista tech stack-a: koji frontend okvir, koji backend jezik, koja baza, koji middleware. Da bi Claude imao jasnu predstavu o tehničkim granicama.

Kod konvencije: konvencije imenovanja, struktura direktorijuma, zahtevi za komentare, način obrade izuzetaka. Ovi detalji određuju kvalitet generisanog koda.

Strategija testiranja: koji okvir za jedinične testove, koji je zahtev za pokrivenošću, kako se pokreću integracioni testovi. Claude će pri pisanju koda automatski razmišljati o testabilnosti.

Česte zamke: koje zamke postoje u projektu, na primer problem kompatibilnosti verzija neke third-party biblioteke, neočekivana podrazumevana vrednost nekog konfiguracionog parametra.

Drugi savet: obavezno squash merge

Mnogo timova voli da koristi merge commit da bi sačuvali kompletnu istoriju.

Autorova teza je: intermedijalni commit-ovi na ličnoj grani nemaju značaj za glavnu granu.

Nakon squash, svaki unos u git log glavne grane odgovara jednoj rollable biznis jedinici. To je mnogo vrednije od gomile WIP commit-ova.

Treći, podrazumeva commit na nivou sati.

Autor zahteva da se čim mali zadatak završi, odmah komituje. Ne gomilajte do večeri.

Četvrti savet: description skill-a napišite kao "okidač", a ne "rezime".

Ovo je veoma kontraintuitivno.

Ranije sam description skill-a uvek pisao kao "ova veština služi za X".

Autor kaže, pravilan način je "kada treba okinuti ovaj skill". Na primer "kada korisnik pomene generisanje README-a, koristi ovaj skill".

Razlog je što Claude Code, kada odlučuje da li da pozove neki skill, radi match po uslovima okidanja, a ne po opisu funkcije.

Promenom načina pisanja, moj hit rate za custom skill-e je sa ispod 50% porastao na preko 90%.

ending

Ranije sam mislio da je ključ za dobro korišćenje Claude Code-a u dobro napisanim promptovima.

Sada znam da je pravi ključ inženjering.

• Dobro napisan CLAUDE.md.
• Odgovarajući okidači za skill.
• Paralelni klonovi u worktree-u.
• Uz Auto Mode, pustite ga da radi.

Gornja granica alata nikada nije određena samim alatom.

Mnogi koriste Claude Code mesec dana i pomisle "ništa posebno".

Promenite model, i dalje je "skoro isto".

Ali oni koji ga zaista dobro koriste, izdvoje vreme da doteruju svoj radni tok.

Ponavljajuće stvari se pakuju kao skill.

Opasne stvari se prepuste hook-u.

Paralelni zadaci se prepuste worktree-u.

Orkestracija se prepusti agent timu.