KAOS/TASKS/Multi-Agent-Spec.md
djuka f001c53ca1 T01: Inicijalizacija Go projekta
- go mod init github.com/dal/kaos
- Config paket sa .env učitavanjem i validacijom
- Supervisor skeleton paket
- Entry point (cmd/kaos-supervisor/main.go)
- Makefile (build, test, vet, clean, all)
- .env.example, .gitignore
- 6 config testova — svi prolaze

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 11:21:06 +00:00

80 lines
2.4 KiB
Markdown

# 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 |