152 lines
4.5 KiB
Markdown
152 lines
4.5 KiB
Markdown
# 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/` |
|