Dubinska analiza repozitorija
Na ovoj stranici
Lekcija ažurirana 3. studenoga 2026. na temelju Codex priručnika: „Dubinsko istraživanje za GitHub“ nije značajka Codexa. Analiza repozitorija provodi se s Codexom u načinu samo za čitanje, dok je dubinsko istraživanje značajka ChatGPT Worka, čija dostupnost ovisi o tvojem računu i radnom prostoru. Tablica usporedbe trajanja bez izvora iz prethodne verzije uklonjena je. Izvori: Codex CLI · Neinteraktivni način.
Dubinska analiza repozitorija
Prije modificiranja koda, često ga prvo moraš razumjeti: arhitekturu zastarjelog projekta, njegove ovisnosti i tehnički dug. Dva alata služe toj svrsi. Codex analizira repozitorij iznutra – čita datoteke, ispituje Git povijest i pokreće dijagnostičke naredbe – ne vršeći nikakve promjene. Dubinsko istraživanje ChatGPT Worka provodi istrage kroz više izvora i isporučuje izvješće s izvorima; to je pravi alat za pitanja koja nadilaze repozitorij, poput evaluacije vanjske knjižnice.
Analiziraj bez modificiranja bilo čega
Standardni Codex zadatak izvršava radnju: pisanje koda, ispravljanje greške ili generiranje testova. Za analizu, zatraži od Codexa da sintetizira bez modificiranja bilo čega i daj mu sredstva da se drži tog ograničenja. Postavi sesiju u način samo za čitanje (/permissions, način read-only) ili pokreni analizu s codex exec, koji prema zadanim postavkama koristi sandbox samo za čitanje. Može skenirati stotine datoteka, ispitati Git povijest i proizvesti detaljno izvješće. Ta se razlika odmah očituje u tvojem upitu, koji bi se trebao usredotočiti na razumijevanje, a ne na modificiranje:
"Analyze the architecture of this project without modifying any files.
How does data flow from the API to the database? What patterns are
used? Where are the fragility points?"
Rezultat nije commit, već strukturirani dokument koji sadrži reference na relevantne datoteke i preporuke. Ti ga pregledavaš, raspravljaš o njemu na tehničkom sastanku i ispravljaš gdje god je pogrešan.
Ubrzaj tehničko uključivanje
Kada se programer pridruži timu, obično provede prva dva tjedna mentalno rekonstruirajući kartu koju nitko nikada nije zapisao: koji servis poziva što, zašto modul ima ime koje više ne odgovara njegovom sadržaju ili gdje se krije logika naplate. Codex može nacrtati tu kartu za njega:
"Analyze this repository and generate an onboarding guide
for a new developer. Cover:
- General architecture and layers
- Naming and structure conventions
- End-to-end flow of a typical request
- The most important files to read first
- Common pitfalls and project-specific quirks"
Nastali dokument služi kao referenca tijekom prvih nekoliko tjedana i ispravlja se kako tim pruža povratne informacije. Ta vježba ispravljanja ima neočekivanu korist: otkriva slijepa mjesta koja se nitko nije potrudio dokumentirati jer „svi znaju kako to radi“.
Revizija ovisnosti i tehničkog duga
Drugi prirodni slučaj uporabe je inventar. Kôdna baza stara tri godine akumulira napuštene knjižnice, funkcionalne duplikate i mrtve uvoze koje se nitko ne usuđuje izbrisati zbog nedostatka pregleda:
"Analyze all project dependencies (package.json
and lock file). Identify:
- Obsolete packages (last update > 1 year ago)
- Known vulnerabilities
- Duplicate packages (same functionality)
- Unused packages (imported nowhere)
- Packages with incompatible licenses"
Ova analiza unakrsno referencira package.json, datoteku zaključavanja (lock file) i uvoze koji su stvarno prisutni u kodu. Za poznate ranjivosti i status održavanja paketa potrebni su javni podaci, stoga moraš eksplicitno dopustiti mrežni pristup ili koristiti alate za reviziju svog upravitelja paketa (poput npm audit). Evaluacija tehničkog duga slijedi istu logiku, s jednim dodatnim zahtjevom – posljednjom linijom upita. Bez kriterija sortiranja, dobit ćeš popis od četrdeset problema bez ideje gdje početi.
"Evaluate the technical debt of this project. Analyze:
- Cyclomatic complexity of core modules
- Most frequently modified files (Git hotspots)
- Code duplication patterns
- Unresolved TODOs and FIXMEs
- Test coverage by module
Rank problems by impact and effort to fix."
Vrijednost ovih analiza leži u omjeru uloženog vremena i dobivenih rezultata: nekoliko preciznih uputa zamjenjuje dane čitanja. Izmjeri to na svojim vlastitim projektima umjesto da se oslanjaš na generičke procjene i uvijek pregledaj izvješće: agent može pogriješiti, posebno oko onoga što repozitorij ne sadrži.
Evaluiraj vanjski projekt prije usvajanja
Za open-source knjižnicu koju razmatraš usvojiti, pitanje nadilazi repozitorij: učestalost izdanja, aktivnost oko problema i reputacija. To je domena dubinskog istraživanja ChatGPT Worka. U aplikaciji za računalo prijeđi na Work, otvori Plugins i odaberi Deep research; na webu otvori izbornik + u Work razgovoru. Dostupnost ovisi o tvojem računu i radnom prostoru:
"Analyze the repository github.com/org/library.
Evaluate its maturity:
- Release frequency and maintenance
- Documentation quality
- Community activity (issues, PRs)
- Test coverage
- Recommendation: Is it safe to adopt in production?"
Ovo je korak verifikacije koji gotovo uvijek preskočimo jer ne možemo izdvojiti pola dana za njega, no njegov nas izostanak košta dvije godine kasnije: knjižnica se više ne održava, njezin jedini održavatelj je nestao, a ti ostaješ s ovisnošću koju moraš hitno prepisati.
Dobij izvješća spremna za akciju
Kvaliteta izvješća izravno ovisi o preciznosti upita. „Gdje su točke krhkosti?“ daje daleko korisniji rezultat od „Analiziraj projekt“ jer prva formulacija nameće kut gledanja i prisiljava hijerarhiju. Također zatraži eksplicitan format – „rangiraj po prioritetu“, „organiziraj po modulu“ – kako bi dobio dokument koji možeš brzo pregledati, a ne čitati od korice do korice. Zatim nastavi s konkretnim Codex zadacima koji popravljaju identificirane probleme. U tom trenutku analiza prestaje biti samo još jedno izvješće i postaje polazište za plan rada. Naposljetku, podijeli ova izvješća sa svojim timom, jer njihova vrijednost raste s brojem ljudi koji se na njih svakodnevno pozivaju.
Ključne točke
- Za analizu repozitorija pokreni Codex u načinu samo za čitanje (
/permissionsilicodex exec, koji je prema zadanim postavkama samo za čitanje) - Idealno za uključivanje novih članova, revizije i evaluaciju tehničkog duga
- Dubinsko istraživanje ChatGPT Worka prikladno je za pitanja iz više izvora, poput evaluacije vanjske knjižnice
- Rezultati se ulijevaju u konkretne Codex zadatke za rješavanje identificiranih problema
- Pregledaj svako izvješće: agent može pogriješiti, posebno oko sadržaja koji nedostaje