KAOS/CLAUDE.md

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:

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/