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

| Folder | Ko piše | Ko čita | Ko premešta |
|--------|---------|---------|-------------|
| backlog/ | planer | operater | operater → ready/ |
| ready/ | — | agent | agent → active/ |
| active/ | agent | agent | agent → review/ |
| review/ | planer (odgovori) | operater, agent | operater → done/ ili agent → active/ |
| done/ | — | svi | nikad |
| reports/ | agent | svi | nikad |

---

## 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.1.0 |
| Frontend | agents/frontend/ | Sonnet | 0.1.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.