Agentski sloj — kako projekt nastaje pod nadzorom

Kontekst, pravila, vještine, nezavisne provjere i tvrde brane oko jednosmjernog podatkovnog lanca

Metodologija
Agentski sloj
Objavljeno

11. kolovoza 2026.

Jezik: Hrvatski · English version →

Uz podatkovni i analitički sloj, DigiKat ima i treći, manje vidljiv sloj, agentski. Dio razvojnog posla (pisanje koda, provjere kvalitete, priprema stranica) obavlja se uz pomoć agenata umjetne inteligencije, ali ne slobodnom rukom. Ova stranica razlaže od čega se taj sloj sastoji i kako je povezan. Sažeti prikaz nalazi se u izvršnom pregledu.

Životni ciklus svakog zahvata

kontekstplanradprovjerabranaučenje

Kontekst koji se učita u svakoj sjednici

CLAUDE.md
Projektni ustav: 8 načela, jednosmjeran tok podataka, nazivlje i pravila direktorija. Vrijedi za sve.
CLAUDE.local.md
Istina o stroju: je li R dostupan, gdje je korpus, koje su putanje. Zato se isti agent ponaša ispravno na različitim računalima.
MEMORY.md
Zajednički dnevnik naučenog ([LEARN]). Bilježi incidente i ispravke; dijeli ga cijeli tim.

Učitava se automatski, prije svakog zadatka — agent zna projekt, stroj i dosadašnje pouke.

Agentski sloj nadgleda svaki prijelaz u jednosmjernom lancu

Agentski sloj · nadgleda svaki prijelaz PravilaVještineProvjereZaštite
  1. Prikupljanjevendorski xlsx → akumulator
  2. Filtriranje119 pojmova + model ≥0,70
  3. Službeni korpus413.985 × 54gitignore · izveden
  4. AgregatiR/03_aggregate.Rjavno · CC BY 4.0
  5. Stranicepages/**.qmd → docs živa stranica

Petlja se zatvara: naučeno se vraća u MEMORY.md — pravila se s vremenom poboljšavaju. Brojke u tekstu moraju biti izračunate iz agregata, nikad upisane rukom.

Četiri organa sloja — pravila, vještine, provjere, zaštite

Pravila

standing orders
6 pravila · učitavaju se sama
  • plan-first uvijekPlan prije svake netrivijalne izmjene; tvrda brana na operacije nad korpusom.
  • data-pipeline R · data/Štiti akumulator, dvostupanjsko pravilo uključivanja i izvedeni korpus; backup i delta-izvještaj.
  • quarto-verification .qmdRenderiraj prije „gotovo"; render ne smije mijenjati podatke.
  • voice-and-style pages/Kućni glas, nazivlje, hrvatski format brojki.
  • croatian-encoding tekstUTF-8 disciplina; č ć ž š đ kroz cijeli lanac.
  • exploration-protocol explorations/Pravila pješčanika; ne piše u data/, pages/, docs/.

Pasivno znanje: neka pravila vrijede uvijek, druga se aktiviraju prema tome koje datoteke dodiruješ.

Vještine

skills
14 vještina · pokreće korisnik
  • Objavljivanje i podaci 4/deploy · /render-page · /refresh-data · /commit
  • Analiza 3/data-analysis · /check-lexicon · /disclosure-check
  • Recenzija 2/review-page · /review-paper
  • Istraživanje 3/new-study · /lit-review · /research-ideation
  • Održavanje 2/capture-environment · /context-status

Kodirani postupci za operacije koje se ponavljaju — orkestriraju pravila i agente za jedan zadatak.

Provjere

review agents
5 agenata · samo čitaju
  • verifier haikuJe li render/skripta stvarno uspjela; nije li render dirnuo podatke.
  • numeric-claim sonnetSvaku objavljenu brojku ponovno izvodi iz javnih agregata.
  • r-reviewer sonnetR kod: putanje, sjeme, tihi gubitak redaka, brzina na 413.985 objava.
  • croatian-nlp opusKodiranje, morfologija, spoj leksikona, uzorkovanje.
  • religion-media opusKonstrukti, tvrdnja↔podatak, tipologija, recenzent-protivnik.

Agent koji je radio posao nije onaj koji ga provjerava — svaka provjera kreće iz svježeg konteksta.

Zaštite

hard guards
hook · deny-lista · plan-gate
  • git_data_guard.py pretoolusePresreće svaku naredbu; blokira brisanje korpusa i backupa.
  • docs-wipe branaZaustavlja commit koji bi obrisao ≥3 stranice žive stranice.
  • git add — bez „-A"Nema nekontroliranog stage-anja; samo izričite putanje.
  • deny-listaforce-push · reset --hard · clean -f · rm -rf — tvrdo zabranjeno.
  • defaultMode: planSvaka sjednica kreće u načinu plana, ne u izmjeni.

Determinističke — običan Python, ne model. Agent ih ne može nagovoriti ni zaobići.

Tvrda brana — čovjek u petlji

Najrizičnije, nepovratne operacije agent ne izvodi sam: voditelj projekta ih osobno odobrava — prebrisavanje korpusa · pokretanje R/03_aggregate.R · puni render preko docs/ · prepisivanje git povijesti. Agentski sloj ubrzava rad; odgovornost i tumačenje ostaju ljudski.

Pravila su javna· CLAUDE.md u repozitoriju· .claude/ (rules · agents · skills · hooks)· DigiKat· CC BY 4.0

Kako čitati sliku

Slika prati jedan zahvat kroz njegov životni ciklus. Najprije se učita kontekst, tri projektne datoteke koje agentu govore što je projekt, na kojem stroju radi i što je tim dosad naučio. Zatim jednosmjeran lanac vodi podatke od sirovih izvoza do objavljenih stranica. Strelice idu samo u jednom smjeru i nizvodni se artefakt nikad ne uređuje ručno. Iznad lanca stoji agentski sloj, koji nadgleda svaki prijelaz između faza. Naposljetku se petlja zatvara. Ono što se pri radu nauči vraća se u zajednički dnevnik, pa se pravila s vremenom poboljšavaju.

Pet dijelova sloja

Kontekst su tri datoteke koje se učitavaju u svakoj sjednici. CLAUDE.md je projektni ustav s načelima, tokom podataka i nazivljem koji vrijede za sve. CLAUDE.local.md opisuje pojedini stroj (je li dostupan R, gdje je korpus), pa se isti agent ispravno ponaša i na računalu bez podataka. MEMORY.md je zajednički dnevnik naučenoga.

Pravila su stalni nalozi koji oblikuju svaku izmjenu. Šest ih je. Neka vrijede uvijek (plan prije netrivijalnog posla), a druga se aktiviraju prema tome koje se datoteke diraju, pa tako postoje protokol podatkovnog cjevovoda za R/ i data/, provjera renderiranja za .qmd, kućni glas i stil za stranice, te disciplina hrvatskog kodiranja za svaki tekst.

Vještine su kodirani postupci, njih četrnaest, koje korisnik pokreće naredbom za operacije koje se ponavljaju. Grupiraju se u pet obitelji, a to su objavljivanje i podaci (/deploy, /render-page, /refresh-data, /commit), analiza (/data-analysis, /check-lexicon, /disclosure-check), recenzija (/review-page, /review-paper), istraživanje (/new-study, /lit-review, /research-ideation) i održavanje (/capture-environment, /context-status). Svaka vještina za jedan zadatak povezuje prava pravila i prave agente, primjerice za sigurno dodavanje novih podataka ili objavljivanje stranice sa svim provjerama uključenima.

Provjere obavlja pet nezavisnih agenata koji samo čitaju. To su mehanička provjera da je render ili skripta stvarno uspjela, ponovno izvođenje svake objavljene brojke iz javnih agregata, recenzija R koda te dvije domenske recenzije, računalne lingvistike i sociologije religije i medija. Ključno je načelo da agent koji je radio posao nije onaj koji ga provjerava.

Zaštite su tvrde brane koje ne izvodi model, nego obična skripta. Prije svake naredbe hook presreće rad i blokira brisanje korpusa ili sigurnosnih kopija, nekontrolirano dodavanje u git te commit koji bi obrisao objavljene stranice. Uz to, popis zabrana onemogućuje najopasnije naredbe, a svaka sjednica kreće u načinu plana.

Kako je sve povezano

Sloj se može čitati na tri načina, a sva su tri istovremeno točna.

Podjela ovlasti. Kontekst i pravila su zakon. Glavni agent je izvršna vlast koja djeluje, agenti-provjeritelji su nezavisno sudstvo koje ne uređuje nego prosuđuje, a hookovi i popis zabrana ustavne su granice koje se u radu ne mogu ukinuti. Voditelj projekta je pritom posljednja instanca i nepovratne operacije traže njegovo osobno odobrenje.

Obrana u dubinu. Oko nezamjenjive jezgre, korpusa i žive stranice, stoje četiri koncentrična prstena. To su meko usmjeravanje (pravila), kodirani postupak (vještine), nezavisna recenzija (provjere) i deterministička brana (zaštite). Izmjena mora proći kroz sve. Vanjski prsten nije model, pa se ne može nagovoriti.

Upravljana petlja. Agentski sloj zrcali jednosmjeran tok podataka, ali za nadzor. Čuva svaki prijelaz i zatvara krug tako da naučeno vraća u MEMORY.md. Time se sam ustav s vremenom poboljšava.

Što agentski sloj ne radi

Sloj čuva postupak, a ne istinu. Jamči da su brojke izračunate, a ne upisane rukom, da je render provjeren i da korpus ima sigurnosnu kopiju, ali oznake, tumačenja i konačne odluke ostaju ljudske. Riječ je o disciplinirajućoj skeli, ne o samostalnom istraživaču. Zato su najosjetljiviji koraci (promjena pravila uključivanja, prebrisavanje korpusa, objava cijele stranice) izuzeti iz automatizma i vezani uz izričito odobrenje voditelja projekta.

Sve je javno

Cijeli je sloj dio otvorenog repozitorija. Pravila, agenti, vještine i zaštite žive u mapi .claude/, a projektni ustav u datoteci CLAUDE.md. I ova je stranica nastala u tom sloju, s planom pohranjenim u repozitoriju i uz automatske kontrole.