166 lines
4.9 KiB
Markdown
166 lines
4.9 KiB
Markdown
# 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 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.
|