# KAOS — Mastermind

**Verzija:** 0.6.0
**Ažurirano:** 2026-02-20

---

## Učesnici

| Uloga | Ko | Šta radi |
|-------|----|----------|
| Klijent | Korisnik | Prijavi problem/zahtev kroz dashboard formu |
| Planer | Claude u chatu | Piše taskove, odgovara na pitanja agenata |
| Operater | Nenad | Odobrava, pregleda, kontroliše. Šef. |
| Agent | Claude Code na serveru | Izvršava taskove (čist kontekst po tasku) |

Komunikacija: kroz fajlove u TASKS/ (sync Windows ↔ Server).
Planer i Agent nikad direktno. → detalji: `TASKS/Workflow-Spec.md`

---

## Dashboard (http://10.0.0.1:8080)

| Tab | Funkcija |
|-----|----------|
| Kanban | Board sa kolonama, drag & drop, workflow dugmad |
| Dokumenti | Pregled svih .md fajlova (goldmark renderovanje) |
| Konzola | Terminal — 2 paralelne claude sesije |
| Prijava | Klijent mod (forma) + Operater mod (chat sa claude CLI) |

### Workflow dugmad na karticama

| Stanje | Dugme |
|--------|-------|
| backlog, zavisnosti ❌ | 🔒 Blokiran |
| backlog, zavisnosti ✅ | 👁 Pregledaj → ✅ Odobri |
| ready | ▶ Pusti (pokreni agenta) |
| active | ⚙️ Radi |
| review, pitanje | 💬 Odgovori → ▶ Nastavi |
| review, završen | 👁 Pregledaj → ✅ Odobri / ↩ Vrati |
| done | 📊 Izveštaj |

### Pokretanje agenta

"Pusti ▶" pokrene NOV `claude` proces sa čistim kontekstom:
```bash
claude --permission-mode bypassPermissions -p "Pročitaj CLAUDE.md i radi task TASKS/ready/T{XX}.md"
```
Svaki task = zasebna sesija. Nema istorije iz prethodnih taskova.

---

## Kad te pokrenu

1. Pogledaj `TASKS/ready/` i `TASKS/review/`
2. Pokaži operateru šta ćeš da radiš — **čekaj odobrenje**
3. Izvršavaj po pravilima agenta (`agents/*/CLAUDE.md`)

### Kad završiš task

- Build/test/vet moraju proći
- Commit: `T{XX}: Opis na srpskom`
- Push + tag (semver) + push tags
- Izveštaj u `TASKS/reports/T{XX}-report.md`
- Premesti task u `review/`

### NIKAD

- Ne radi bez odobrenja operatera
- Ne preskoči "čekaj odobrenje"
- Ne radi na tasku koji nije u `ready/` ili `review/`

---

## Ko šta sme da premesti

| Iz → U | Operater | Agent |
|---------|----------|-------|
| backlog → ready | ✅ | ❌ |
| ready → backlog | ✅ | ❌ |
| ready → active | ❌ | ✅ |
| active → review | ❌ | ✅ |
| review → done | ✅ | ❌ |
| review → ready | ✅ | ❌ |
| done → bilo gde | ❌ | ❌ |

Server validira. Nedozvoljen potez → 403.
Deployer jedini KREIRA taskove u backlog/ (greške iz logova).

---

## Struktura

```
/opt/kaos/
├── CLAUDE.md              ← OVO
├── agents/*/CLAUDE.md     ← pravila po agentu
├── TASKS/                 ← backlog/ready/active/review/done/reports/
├── code/                  ← Go + HTMX (jedan binary, nema npm)
├── logs/                  ← persistent logovi (planirano)
├── documentation/         ← eksterna dokumentacija
└── templates/new-project/ ← template za nove projekte
```

---

## Stack

Go 1.22+ · Gin · HTMX + Sortable.js (nema npm) · goldmark (markdown) · Gitea (localhost:3000) · Hetzner (10.0.0.1) · Claude Code CLI (Pro licenca)

Projekat: `/opt/kaos/` (vlasnik: kaos korisnik)
Server radi kao root, agenti se pokreću kao `kaos` korisnik.
Operater mod u Prijavi koristi `claude` CLI (Pro licenca), ne API.
API ključ (ANTHROPIC_API_KEY) se čuva za budući direktni API mod.

---

## Agent registar

| Agent | Model | Verzija | Detalji |
|-------|-------|---------|---------|
| Triage | Haiku | 0.1.0 | `agents/triage/CLAUDE.md` |
| Task Manager | Sonnet/Haiku | 0.1.0 | `agents/task-manager/CLAUDE.md` |
| Coder | Sonnet/Opus | 0.2.0 | `agents/coder/CLAUDE.md` |
| Frontend | Sonnet | 0.2.0 | `agents/frontend/CLAUDE.md` |
| Checker | Haiku/Opus | 0.1.0 | `agents/checker/CLAUDE.md` |
| Reporter | Haiku | 0.1.0 | `agents/reporter/CLAUDE.md` |
| Docs | Haiku | 0.1.0 | `agents/docs/CLAUDE.md` |
| Deployer | Haiku/Sonnet | 0.2.0 | `agents/deployer/CLAUDE.md` |

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

---

## Verzionisanje

Semver. Patch = task, Minor = milestone, Major = breaking change.
Git: commit → push → tag → push tags. Format: `T{XX}: Opis`
Timeout: 30 min default (KAOS_TIMEOUT u .env).

---

## Reference

| Šta | Gde |
|-----|-----|
| Status svih taskova + bugovi | `TASKS/MASTER-STATUS.md` |
| Kompletan workflow | `TASKS/Workflow-Spec.md` |
| Multi-agent arhitektura | `TASKS/Multi-Agent-Spec.md` |
| Format izveštaja | `TASKS/reports/T01-report.md` (primer) |
| Template za novi projekat | `templates/new-project/` |