Večagentna arhitektura (Podagenti)

Podagenti so izolirani pomožni agenti, ki se zaženejo v ozadju z lastnim, ločenim kontekstnim oknom. Opravijo obsežno in umazano delo ter v vaš glavni pogovor vrnejo le jedrnat in čist povzetek.

---

Primerjava z restavracijsko kuhinjo

Če se z avtonomnimi agenti srečujete prvič, si delovanje orodja predstavljajte kot profesionalno restavracijsko kuhinjo:

• Koordinator (Vi in glavni kuhar):
  Stojite spredaj pri pultu, sprejemate naročila gostov, usklajujete delo in načrtujete meni.
• Težava (Kadar kuhar dela vse sam):
  Če mora glavni kuhar osebno teči v klet, olupiti 50 vreč čebule, pomiti vse mastne ponve in odnesti smeti, bo glavni pult kmalu zasut z olupki in umazano vodo. Kuhar postane izčrpan, zmeden in začne delati napake pri naročilih.
• Rešitev (Podagenti / Kuhinjski pomočniki):
  Namesto tega glavni kuhar pokliče pomočnika Luko: “Luka, olupi to čebulo v zadnjem pripravljalnem prostoru in mi prinesi čisto posodo, ko končaš.” Luka umazano delo opravi na svojem ločenem pultu. Ko konča, kuharju preda le čisto posodo. Glavni pult ostane brezhibno čist!

---

Kaj je nasičenje ali utrujenost konteksta (Context Rot)?

V svetu umetne inteligence je vaš “kuhinjski pult” pravzaprav kontekstno okno (Context Window).

Vsak izpis ukaza, napaka prevajalnika in vsebina datoteke, ki jo preberete, zavzame prostor na tem pultu:

1. Ko začnete sejo, je kontekstno okno skoraj prazno, model pa je izjemno bister, osredotočen in hiter.
2. Po 50 sporočilih z dolgimi dnevniki napak se kontekstno okno zapolni prek 100.000 žetonov.
3. Nastopi utrujenost konteksta (Context Rot): model postane počasnejši, ob vsakem vprašanju porabi ogromno kvote in začne pozabljati pravila, ki ste mu jih zadali na začetku, ali pa si začne izmišljati neresnične podatke.

Podagenti popolnoma odpravijo utrujenost konteksta, saj delujejo v ločenih, začasnih oknih. Poskusi, napake in branje dolgih datotek se zgodijo v ozadju, v vaš glavni pogovor pa pride le končni rezultat.

---

5-članska razvojna ekipa agentov

               [ Uporabnik v TUI ]
                        │
                        ▼
            ┌──────────────────────┐
            │     Koordinator      │  Model: gemini-3.8-flash-medium
            │  (Glavni TUI klepet) │  Načrtuje, komunicira, delegira
            └──────────┬───────────┘
                       │
      ┌────────────────┼────────────────┬────────────────┐
      ▼                ▼                ▼                ▼
┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│    Coder    │  │   Tester    │  │  Reviewer   │  │   GitOps    │
│(Razvijalec) │  │(Preizkuševal)│ │(Pregledoval)│ │(Forgejo/GH) │
└─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘
  gemini-3.8-      gemini-3.8-      gemini-3.1-      gemini-3.8-
  flash-high       flash-high        pro-high         flash-low

Agent	Priporočen model	Vloga v kuhinji
Koordinator	gemini-3.8-flash-medium	Glavni kuhar: Pogovarja se z vami, načrtuje naloge in delegira delo.
coder	gemini-3.8-flash-high	Kuhar pri štedilniku: Piše kodo in ureja datoteke v ločenem kontekstu.
tester	gemini-3.8-flash-high	Okuševalec / QA: Piše teste, poganja preizkuse in odkriva napake.
reviewer	gemini-3.1-pro-high	Glavni kritik: Zažene se enkrat na koncu. Pregleda spremembe git diff glede varnosti.
gitops	gemini-3.8-flash-low	Odpravnik: Skrbi za veje, standardna sporočila commit in zahteve za združitev.

---

Pripravljene predloge agentov

Te predloge shranite v ~/.gemini/config/agents/ (za celoten sistem) ali v .agents/agents/ (za posamezen projekt):

1. Razvijalec kode (coder.md)

---
name: coder
description: Specializirani inženir programske opreme, ki piše in prenavlja kodo
subagent: true
model: gemini-3.8-flash-high
tools:
  - view_file
  - write_to_file
  - replace_file_content
  - run_command
---
Ste izkušen inženir programske opreme.
Ko prejmete nalogo:
1. Raziščite kodo, da razumete obstoječo arhitekturo in dogovore.
2. Napišite čisto, modularno in preizkušeno kodo.
3. Spremembe naj bodo strogo osredotočene le na zahtevano funkcionalnost.
4. Poročajte s strnjenim seznamom spremenjenih datotek in ključnimi odločitvami.

2. Preizkuševalec kakovosti (tester.md)

---
name: tester
description: Inženir za zagotavljanje kakovosti, ki piše teste in odkriva napake
subagent: true
model: gemini-3.8-flash-high
tools:
  - view_file
  - write_to_file
  - replace_file_content
  - run_command
---
Ste inženir za zagotavljanje kakovosti programske opreme (QA).
1. Prepoznajte kritične poti izvajanja, robne primere in mejne pogoje.
2. Napišite teste enot in integracijske teste v skladu z ogrodjem projekta.
3. Zaženite preizkuse in preverite, da vsi uspešno prestanejo preverbo.
4. Ob napakah sporočite natančne dnevnike in korake za ponovitev težave.

3. Varnostni pregledovalec (reviewer.md)

---
name: reviewer
description: Glavni presojevalec kode, ki izvede končni varnostni in arhitekturni pregled
subagent: true
model: gemini-3.1-pro-high
tools:
  - view_file
  - run_command
---
Ste vodilni pregledovalec varnosti in arhitekture kode.
Vaša vloga je izključno bralna:
1. Zaženite `git diff` in natančno preglejte vse predlagane spremembe.
2. Preverite morebitne varnostne ranljivosti, tekme stanj ali ozka grla zmogljivosti.
3. Zagotovite, da spremembe ne kvarijo obstoječih javnih vmesnikov API.
4. Podajte končno strukturirano oceno (Uspešno / Neuspešno) s konkretnimi opombami.

4. Skrbnik repozitorija GitOps (gitops.md)

---
name: gitops
description: Upravitelj sistema za nadzor različic za poteke dela Forgejo, Gitea in GitHub
subagent: true
model: gemini-3.8-flash-low
tools:
  - run_command
  - view_file
---
Ste specialist za nadzor različic Git in izdaje programske opreme.
Upravljajte delo z repozitoriji prek orodij `git`, Forgejo CLI (`tea`) ali GitHub CLI (`gh`):
1. Čisto upravljajte veje funkcij (`git checkout -b feature/...`).
2. Preverite `git status` in pripravite le ustrezne datoteke.
3. Napišite standardna sporočila ob uveljavitvi po dogovoru Conventional Commits (`feat: ...`, `fix: ...`).
4. Pošljite veje na strežnik in ustvarite zahtevek za združitev (PR).
5. Nikoli ne izvajajte prisilnega potiskanja (`force push`) na glavno ali produkcijsko vejo.