# KAOS Multi-Agent Arhitektura

**Verzija:** 0.1.0
**Poslednje ažuriranje:** 2026-02-20

---

## Princip

Jedan mastermind orkestrira, specijalizovani agenti izvršavaju.
Mastermind NIKADA ne kodira. Agenti znaju SAMO svoj deo.
Agenti NE komuniciraju međusobno — samo sa mastermindom.

---

## Agenti

| Agent | Uloga | Model | Cena/M tokena |
|-------|-------|-------|---------------|
| **Mastermind** | Orkestrira, odlučuje, ne kodira | Sonnet | $3/$15 |
| **Triage** | Klasifikuje prijave (tip, prioritet, modul) | Haiku | $0.25/$1.25 |
| **Task Manager** | Kreira taskove, prati status | Sonnet/Haiku | $3/$15 |
| **Coder** | Piše Go kod + testove | Sonnet/Opus | $3-$15/$15-$75 |
| **Frontend** | Piše React kod + Playwright testove | Sonnet | $3/$15 |
| **Checker** | Build, test, vet, code review | Haiku/Opus | $0.25-$15 |
| **Reporter** | Piše izveštaje u markdown | Haiku | $0.25/$1.25 |
| **Docs** | Čita eksternu dokumentaciju | Haiku | $0.25/$1.25 |
| **Deployer** | Git merge, tag, verzija, deploy | Haiku | $0.25/$1.25 |

Pravilo: uvek najjeftiniji model koji može da uradi posao.

---

## Izolacija

Svaki agent dobija SAMO:
1. Svoj CLAUDE.md (pravila za njegov deo)
2. Fajlove koje treba da čita (eksplicitno)
3. Zadatak (šta tačno da uradi)

Agent NE dobija: celu codebase, druge module, poslovne odluke koje ga se ne tiču.

---

## Tok — primer

```
1. Operater: "Dodaj export faktura u PDF"
2. Mastermind: razbije na backend (T28a) + frontend (T28b)
3. Coder (Sonnet): implementira PDF endpoint + test
4. Checker (Haiku): go build, go test, go vet
5. Frontend (Sonnet): dugme Export PDF + Playwright test
6. Checker (Haiku): npm build, playwright test
7. Reporter (Haiku): napiše izveštaj
8. Mastermind: "Završeno, čeka odobrenje"
9. Operater: pregleda, odobri
10. Deployer (Haiku): git tag, deploy
```

---

## Verzionisanje

Svaki CLAUDE.md ima verziju (Semver).
Mastermind drži Agent registar sa verzijama.
Promena pravila = nova verzija + ažuriran registar.

---

## Prednosti

| Prednost | Objašnjenje |
|----------|-------------|
| Jeftinije | Haiku za jednostavne stvari, Opus samo kad mora |
| Brže | Manji kontekst = brži odgovor |
| Preciznije | Agent fokusiran na jedan zadatak = manje grešaka |
| Bezbednije | Agent za frontend ne može pokvariti engine |
| Skalabilno | Lako dodaš novog agenta |
| Zamenjivo | Novi model — promeniš samo u mastermind config |