KAOS/CLAUDE.md

KAOS — Mastermind

Verzija: 0.3.0 Poslednje ažuriranje: 2026-02-20

---

Kad te pokrenu

Ti razgovaraš sa operaterom. Operater je tvoj šef — on odlučuje šta se radi.

Tok rada

1. Operater kaže "radi" ili "T01" ili "nastavi"
2. Pogledaj TASKS/ready/ — ima li task spreman za rad
3. Pogledaj TASKS/review/ — ima li task sa dopunjenim odgovorima
4. Pokaži operateru šta ćeš da radiš — čekaj odobrenje
5. Kad dobiješ ok — izvršavaj

Kad izvršavaš task

1. Premesti fajl iz ready/ u active/
2. Pročitaj agents/coder/CLAUDE.md — pravila kodiranja
3. Kod piši u code/ folderu
4. Ako imaš pitanje:
   • Zapiši pitanje u task fajl pod ## Pitanja
   • Premesti fajl iz active/ u review/
   • Reci operateru "imam pitanje, čekam odgovor u fajlu"
   • STANI — ne radi dalje dok operater ne kaže "nastavi"
5. Kad nastaviš:
   • Pročitaj odgovor u task fajlu
   • Premesti fajl iz review/ u active/
   • Nastavi rad
6. Kad završiš:
   • Svi testovi moraju proći
   • Build mora proći
   • Commituj: T{XX}: Opis na srpskom
   • Push: git push origin main
   • Tag: git tag v0.1.{PATCH} (patch = redni broj završenog taska)
   • Push tag: git push origin --tags
   • Napiši izveštaj u TASKS/reports/T{XX}-report.md
   • Premesti task fajl iz active/ u review/
   • Reci operateru "gotovo, čeka pregled"

NIKAD

• Ne radi bez odobrenja operatera
• Ne pretpostavljaj šta operater želi
• Ne preskoči "čekaj odobrenje"
• Ne radi na tasku koji nije u ready/ ili review/

---

Task folderi

TASKS/
├── backlog/     ← novi taskovi (piše planer, čeka odobrenje operatera)
├── ready/       ← odobreni za rad (operater premesti iz backlog/)
├── active/      ← u izradi (agent premesti iz ready/)
├── review/      ← čeka pregled (agent ima pitanje ili završio)
├── done/        ← završeno i odobreno (operater premesti iz review/)
└── reports/     ← izveštaji izvršenih taskova

Ko šta sme da premesti

Iz → U	Operater (dashboard)	Agent (CLI)
backlog → ready	✅	❌
ready → backlog	✅	❌
ready → active	❌	✅
active → review	❌	✅
review → done	✅	❌
review → ready	✅	❌
done → bilo gde	❌	❌

---

Struktura projekta

/root/projects/KAOS/
│
├── CLAUDE.md                  ← OVO — mastermind (v0.3.0)
├── README.md
│
├── agents/                    ← specijalizovani agenti
│   ├── triage/CLAUDE.md
│   ├── task-manager/CLAUDE.md
│   ├── coder/CLAUDE.md
│   ├── frontend/CLAUDE.md
│   ├── checker/CLAUDE.md
│   ├── reporter/CLAUDE.md
│   ├── docs/CLAUDE.md
│   └── deployer/CLAUDE.md
│
├── documentation/             ← eksterna dokumentacija (tuđe)
│
├── TASKS/                     ← taskovi po stanju
│   ├── backlog/
│   ├── ready/
│   ├── active/
│   ├── review/
│   ├── done/
│   ├── reports/
│   ├── MASTER-STATUS.md
│   └── Implementation-Tasks.md
│
└── code/                      ← Go kod

---

Agent registar

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

---

Model selekcija

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

Zadatak	Agent	Model	Cena/M tokena
Klasifikacija prijave	triage	Haiku	$0.25/$1.25
Generisanje taska	task-manager	Sonnet	$3/$15
Kodiranje	coder	Sonnet	$3/$15
Kompleksno kodiranje	coder	Opus	$15/$75
Frontend	frontend	Sonnet	$3/$15
Build + Test	checker	Haiku	$0.25/$1.25
Code review	checker	Opus	$15/$75
Izveštaj	reporter	Haiku	$0.25/$1.25
Dokumentacija	docs	Haiku	$0.25/$1.25
Deploy	deployer	Haiku	$0.25/$1.25

---

Pristup

Folder	Čita	Piše
agents/	✅	❌
TASKS/	✅	✅ (status, premesti fajlove)
documentation/	✅	❌
code/	✅	✅ (kad izvršava task)

---

Verzionisanje CLAUDE.md fajlova

Format: Major.Minor.Patch

• Patch (0.1.1) — sitne ispravke
• Minor (0.2.0) — nova pravila, novi korak
• Major (1.0.0) — fundamentalna promena

Kad se promeni CLAUDE.md → podigne verzija → ažurira Agent registar.