T01: Inicijalizacija Go projekta
- go mod init github.com/dal/kaos - Config paket sa .env učitavanjem i validacijom - Supervisor skeleton paket - Entry point (cmd/kaos-supervisor/main.go) - Makefile (build, test, vet, clean, all) - .env.example, .gitignore - 6 config testova — svi prolaze Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
djuka
commit
f001c53ca1
162
CLAUDE.md
Normal file
162
CLAUDE.md
Normal file
@ -0,0 +1,162 @@
|
|||||||
|
# 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.
|
||||||
176
README.md
Normal file
176
README.md
Normal file
@ -0,0 +1,176 @@
|
|||||||
|
# KAOS — AI-Supervised Development System
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Status:** Pokretanje
|
||||||
|
**Autor:** DAL d.o.o.
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Šta je KAOS
|
||||||
|
|
||||||
|
Sistem gde AI agenti razvijaju softver pod ljudskim nadzorom.
|
||||||
|
Jedan mastermind orkestrira, specijalizovani agenti izvršavaju,
|
||||||
|
čovek odobrava. Svaki agent zna samo svoj deo posla.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Kako radi
|
||||||
|
|
||||||
|
```
|
||||||
|
Klijent prijavi (šta hoće ili šta ne radi)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Operater proveri (da li ima smisla, doradiš opis)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Mastermind se uključi (čita kontekst, razume problem)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Task se zapiše (markdown, u listu taskova)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Operater odobri (ok, kreni)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Mastermind pokrene agenta (pravi model, minimalan kontekst)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Agent izvrši (kodira, testira, commituje)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Checker verifikuje (build, test, vet — nezavisno)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Reporter napiše izveštaj (šta, koliko, koliko koštalo)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Operater pregleda (kod, testovi, izveštaj)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
Deploy ili dorada
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Arhitektura — Multi-Agent
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────┐
|
||||||
|
│ MASTERMIND │
|
||||||
|
│ (root CLAUDE) │
|
||||||
|
│ ne kodira, │
|
||||||
|
│ orkestrira │
|
||||||
|
└───────┬─────────┘
|
||||||
|
│
|
||||||
|
┌───────┬───────┬───┴───┬───────┬───────┬───────┬───────┐
|
||||||
|
▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼
|
||||||
|
┌───────┐┌──────┐┌──────┐┌──────┐┌───────┐┌────────┐┌────┐┌───────┐
|
||||||
|
│Triage ││Task ││Coder ││Front ││Checker││Reporter││Docs││Deploy │
|
||||||
|
│ ││Mgr ││ ││end ││ ││ ││ ││er │
|
||||||
|
│Haiku ││Sonnet││Sonnet││Sonnet││Haiku/ ││Haiku ││Haiku││Haiku │
|
||||||
|
│ ││ ││/Opus ││ ││Opus ││ ││ ││ │
|
||||||
|
└───────┘└──────┘└──────┘└──────┘└───────┘└────────┘└────┘└───────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**Princip:** Agenti ne komuniciraju međusobno. Samo sa mastermindom.
|
||||||
|
**Cena:** Uvek najjeftiniji model koji može da uradi posao.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Struktura projekta
|
||||||
|
|
||||||
|
```
|
||||||
|
/root/projects/KAOS/
|
||||||
|
│
|
||||||
|
├── CLAUDE.md ← mastermind (v0.1.0)
|
||||||
|
├── README.md ← ovo
|
||||||
|
│
|
||||||
|
├── agents/ ← specijalizovani agenti
|
||||||
|
│ ├── triage/CLAUDE.md ← klasifikacija prijava
|
||||||
|
│ ├── task-manager/CLAUDE.md ← kreiranje taskova, status
|
||||||
|
│ ├── coder/CLAUDE.md ← backend kodiranje
|
||||||
|
│ ├── frontend/CLAUDE.md ← React kodiranje
|
||||||
|
│ ├── checker/CLAUDE.md ← verifikacija
|
||||||
|
│ ├── reporter/CLAUDE.md ← izveštaji
|
||||||
|
│ ├── docs/CLAUDE.md ← eksterna dokumentacija
|
||||||
|
│ └── deployer/CLAUDE.md ← git merge, verzije, deploy
|
||||||
|
│
|
||||||
|
├── documentation/ ← eksterna dokumentacija (tuđe)
|
||||||
|
│ ├── api-specs/
|
||||||
|
│ ├── regulations/
|
||||||
|
│ └── third-party/
|
||||||
|
│
|
||||||
|
└── TASKS/ ← taskovi, specifikacije, izveštaji
|
||||||
|
├── MASTER-STATUS.md
|
||||||
|
├── Architecture.md
|
||||||
|
├── Workflow-Spec.md
|
||||||
|
├── Supervisor-Spec.md
|
||||||
|
├── Multi-Agent-Spec.md
|
||||||
|
├── Implementation-Tasks.md
|
||||||
|
└── reports/
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Verzije
|
||||||
|
|
||||||
|
### v0.1 — Osnova (TRENUTNO)
|
||||||
|
- Mastermind + agenti definisani u CLAUDE.md fajlovima
|
||||||
|
- Supervisor: ručno pokretanje (`kaos-supervisor run T01`)
|
||||||
|
- Checker: build + test + vet (deterministički)
|
||||||
|
- Izveštaji: markdown u TASKS/reports/
|
||||||
|
- Git: direktno na main
|
||||||
|
- Nema baze, nema frontend-a, nema AI trijaže
|
||||||
|
|
||||||
|
### v0.2 — Automatizacija (planirano)
|
||||||
|
- Supervisor daemon ili watch folder
|
||||||
|
- AI trijaža prijava
|
||||||
|
- AI compliance provere (modul, pravila, konvencije)
|
||||||
|
- Staging → main branch strategija
|
||||||
|
- Auto-retry za flaky testove
|
||||||
|
- Notifikacije (konfigurabilan kanal)
|
||||||
|
|
||||||
|
### v0.3 — Kompletni ekosistem (planirano)
|
||||||
|
- Frontend dashboard
|
||||||
|
- WebSocket real-time praćenje
|
||||||
|
- Help sistem
|
||||||
|
- Embed SDK
|
||||||
|
- Cost tracking dashboard
|
||||||
|
- Metrike i analitika
|
||||||
|
- Distribucija prema licencama
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Donesene odluke
|
||||||
|
|
||||||
|
| Odluka | Izbor | Datum |
|
||||||
|
|--------|-------|-------|
|
||||||
|
| Arhitektura | Multi-agent (mastermind + specijalizovani) | Feb 2026 |
|
||||||
|
| Komunikacija | Agenti → samo sa mastermindom, nikad međusobno | Feb 2026 |
|
||||||
|
| Model selekcija | Po zadatku: Haiku/Sonnet/Opus | Feb 2026 |
|
||||||
|
| Format taskova | Markdown (nema JSON-a, jedno mesto istine) | Feb 2026 |
|
||||||
|
| Triger | Ručno v0.1, automatizacija v0.2 | Feb 2026 |
|
||||||
|
| Verifikacija | Dupla (agent + supervisor nezavisno) | Feb 2026 |
|
||||||
|
| Retry | Čekaj operatera (v0.1), auto-retry (v0.2) | Feb 2026 |
|
||||||
|
| Verzionisanje | Semver (Major.Minor.Patch) | Feb 2026 |
|
||||||
|
| Izveštaji | Markdown u TASKS/reports/, idu u git | Feb 2026 |
|
||||||
|
| Dorada | Novi task sa MD referencom na stari | Feb 2026 |
|
||||||
|
| Rollback | Git revert (v0.1) | Feb 2026 |
|
||||||
|
| Branch | Direktno main (v0.1), staging (v0.2) | Feb 2026 |
|
||||||
|
| Timeout | Ručno podešavanje, operater odlučuje | Feb 2026 |
|
||||||
|
| Troškovi | Praćenje po tasku (tokeni, cena, vreme) | Feb 2026 |
|
||||||
|
| Backend | Go | Feb 2026 |
|
||||||
|
| Frontend | React + TypeScript + Vite + Tailwind + shadcn/ui | Feb 2026 |
|
||||||
|
| Baza | PostgreSQL (v0.2+) | Feb 2026 |
|
||||||
|
| HTTP framework | Gin (v0.2+) | Feb 2026 |
|
||||||
|
| Engine | `pkg/engine/` javni paket, nula HTTP (v0.2+) | Feb 2026 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Poreklo
|
||||||
|
|
||||||
|
KAOS je nastao iz ARV (Advanced Resource & Venue Management) projekta
|
||||||
|
gde smo dokazali da AI agent može da razvija softver pod nadzorom.
|
||||||
|
ARV ima 43+48 završenih taskova ovim pristupom.
|
||||||
|
KAOS formalizuje taj proces u alat koji može da se koristi za bilo koji projekat.
|
||||||
371
TASKS/Implementation-Tasks.md
Normal file
371
TASKS/Implementation-Tasks.md
Normal file
@ -0,0 +1,371 @@
|
|||||||
|
# KAOS v0.1 — Implementacioni taskovi
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Pregled
|
||||||
|
|
||||||
|
V0.1 cilj: supervisor koji pokreće Claude Code agente, prati izvršavanje,
|
||||||
|
verifikuje rezultat, piše izveštaj. Ručno pokretanje, markdown taskovi.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T01: Inicijalizacija Go projekta
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** —
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
Kreirati Go projekat u `code/` folderu sa osnovnom strukturom.
|
||||||
|
|
||||||
|
**Fajlovi za kreiranje:**
|
||||||
|
```
|
||||||
|
code/
|
||||||
|
├── go.mod ← module github.com/dal/kaos
|
||||||
|
├── .env.example ← KAOS_TIMEOUT=30m
|
||||||
|
├── .gitignore ← Go defaults + .env
|
||||||
|
├── Makefile ← build, test, vet, clean
|
||||||
|
├── cmd/
|
||||||
|
│ └── kaos-supervisor/
|
||||||
|
│ └── main.go ← entry point (prazan skeleton)
|
||||||
|
├── internal/
|
||||||
|
│ ├── config/
|
||||||
|
│ │ └── config.go ← čita .env, drži config struct
|
||||||
|
│ └── supervisor/
|
||||||
|
│ └── supervisor.go ← prazan skeleton
|
||||||
|
└── CLAUDE.md ← pravila kodiranja (kopija agents/coder/CLAUDE.md)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Pravila:**
|
||||||
|
- `go mod init github.com/dal/kaos`
|
||||||
|
- Go 1.22+
|
||||||
|
- Makefile targeti: `build`, `test`, `vet`, `clean`, `all`
|
||||||
|
- Config čita iz .env: KAOS_TIMEOUT, KAOS_PROJECT_PATH
|
||||||
|
- Svaki fajl mora imati package doc komentar
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- `go build ./...` prolazi
|
||||||
|
- `go vet ./...` prolazi
|
||||||
|
- Config test: učitaj .env.example, proveri da su vrednosti popunjene
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
Projekat se kompajlira. `make build` kreira binary. `make test` prolazi.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T02: Task loader — parsiranje markdown taskova
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** T01
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
Supervisor mora da čita taskove iz markdown fajla (ovog fajla).
|
||||||
|
Parsira sekcije, izvlači ID, status, zavisnosti.
|
||||||
|
|
||||||
|
**Fajlovi za kreiranje:**
|
||||||
|
```
|
||||||
|
code/internal/supervisor/
|
||||||
|
├── task.go ← Task struct, LoadTasks(), FindTask(), NextTask()
|
||||||
|
└── task_test.go ← testovi sa primer markdown-om
|
||||||
|
```
|
||||||
|
|
||||||
|
**Task struct:**
|
||||||
|
```go
|
||||||
|
type Task struct {
|
||||||
|
ID string // T01, T02...
|
||||||
|
Title string // naslov
|
||||||
|
Status string // pending, running, done, failed
|
||||||
|
Agent string // coder, checker, frontend...
|
||||||
|
Model string // Haiku, Sonnet, Opus
|
||||||
|
DependsOn []string // lista task ID-eva
|
||||||
|
Description string // ceo opis
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Funkcije:**
|
||||||
|
- `LoadTasks(mdPath string) ([]Task, error)` — parsira markdown
|
||||||
|
- `FindTask(tasks []Task, id string) *Task` — nađi po ID-u
|
||||||
|
- `NextTask(tasks []Task) *Task` — prvi pending čije su zavisnosti done
|
||||||
|
- `UpdateStatus(mdPath, taskID, newStatus string) error` — promeni status u fajlu
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- LoadTasks sa primer markdown-om → parsira tačno
|
||||||
|
- NextTask vraća pravi task po zavisnostima
|
||||||
|
- UpdateStatus menja fajl korektno
|
||||||
|
- Edge case: nema pending taskova, cirkularna zavisnost
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
`go test ./internal/supervisor/ -v` — svi testovi zeleni.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T03: Runner — pokretanje Claude Code
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** T02
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
Pokreće Claude Code sa task promptom, prati stdout/stderr u realnom vremenu,
|
||||||
|
meri vreme, čuva exit code.
|
||||||
|
|
||||||
|
**Fajlovi za kreiranje:**
|
||||||
|
```
|
||||||
|
code/internal/supervisor/
|
||||||
|
├── runner.go ← RunTask(), priprema prompt, pokreće claude CLI
|
||||||
|
└── runner_test.go ← test sa mock komandom (ne pravi claude)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Funkcije:**
|
||||||
|
```go
|
||||||
|
type RunResult struct {
|
||||||
|
TaskID string
|
||||||
|
StartedAt time.Time
|
||||||
|
FinishedAt time.Time
|
||||||
|
Duration time.Duration
|
||||||
|
ExitCode int
|
||||||
|
Output string
|
||||||
|
Error string
|
||||||
|
}
|
||||||
|
|
||||||
|
func RunTask(task Task, projectPath string, timeout time.Duration) RunResult
|
||||||
|
```
|
||||||
|
|
||||||
|
**Prompt koji šalje Claude Code-u:**
|
||||||
|
```
|
||||||
|
Radi na KAOS projektu.
|
||||||
|
Tvoj task: {ID} — {Title}
|
||||||
|
Pročitaj CLAUDE.md u root-u projekta za pravila rada.
|
||||||
|
{Description}
|
||||||
|
Kad završiš: go build, go test, commituj, pushuj.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- Mock: umesto `claude` pokreni `echo "done"` — proveri da RunResult ima tačne podatke
|
||||||
|
- Timeout: pokreni `sleep 999` sa timeout 1s — proveri da se prekine
|
||||||
|
- Output capture: proveri da stdout/stderr su uhvaćeni
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
RunTask pokrene proces, uhvati output, meri vreme, poštuje timeout.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T04: Checker — verifikacija posle agenta
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** T01
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
Posle svake Claude Code sesije, nezavisno pokrene build + test + vet.
|
||||||
|
|
||||||
|
**Fajlovi za kreiranje:**
|
||||||
|
```
|
||||||
|
code/internal/supervisor/
|
||||||
|
├── checker.go ← Verify(), CheckResult struct
|
||||||
|
└── checker_test.go ← test sa privremenim Go projektom
|
||||||
|
```
|
||||||
|
|
||||||
|
**Funkcije:**
|
||||||
|
```go
|
||||||
|
type CheckResult struct {
|
||||||
|
Name string // "build", "test", "vet"
|
||||||
|
Status string // "pass", "fail"
|
||||||
|
Output string
|
||||||
|
Duration time.Duration
|
||||||
|
TestCount int // samo za test check
|
||||||
|
}
|
||||||
|
|
||||||
|
type VerifyResult struct {
|
||||||
|
Build CheckResult
|
||||||
|
Vet CheckResult
|
||||||
|
Test CheckResult
|
||||||
|
AllPassed bool
|
||||||
|
}
|
||||||
|
|
||||||
|
func Verify(projectPath string) VerifyResult
|
||||||
|
```
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- Napravi temp Go projekat koji prolazi — Verify vraća AllPassed=true
|
||||||
|
- Napravi temp Go projekat sa syntax error — Build fail
|
||||||
|
- Napravi temp Go projekat sa failing test — Test fail
|
||||||
|
- Proveri da TestCount parsira tačno
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
Verify pokrene tri komande, parsira rezultat, vrati struct.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T05: Reporter — pisanje izveštaja
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** T03, T04
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
Generiše markdown izveštaj posle izvršenog taska.
|
||||||
|
|
||||||
|
**Fajlovi za kreiranje:**
|
||||||
|
```
|
||||||
|
code/internal/supervisor/
|
||||||
|
├── reporter.go ← WriteReport()
|
||||||
|
└── reporter_test.go
|
||||||
|
```
|
||||||
|
|
||||||
|
**Funkcije:**
|
||||||
|
```go
|
||||||
|
func WriteReport(
|
||||||
|
task Task,
|
||||||
|
run RunResult,
|
||||||
|
verify VerifyResult,
|
||||||
|
reportsDir string,
|
||||||
|
) (string, error) // vraća putanju do izveštaja
|
||||||
|
```
|
||||||
|
|
||||||
|
**Format izveštaja:**
|
||||||
|
```markdown
|
||||||
|
# T{XX}: Naslov
|
||||||
|
|
||||||
|
**Datum:** 2026-02-20 10:15
|
||||||
|
**Trajanje:** 8m 45s
|
||||||
|
**Status:** ✅ Završen / ❌ Neuspešan
|
||||||
|
|
||||||
|
## Verifikacija
|
||||||
|
- ✅/❌ go build (0.3s)
|
||||||
|
- ✅/❌ go vet (0.2s)
|
||||||
|
- ✅/❌ go test (12/12 testova, 2.1s)
|
||||||
|
|
||||||
|
## Agent output
|
||||||
|
(skraćen output Claude Code sesije)
|
||||||
|
|
||||||
|
## Commit
|
||||||
|
- Hash: a1b2c3d
|
||||||
|
- Branch: main
|
||||||
|
```
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- WriteReport sa mock podacima → fajl postoji, sadržaj tačan
|
||||||
|
- Proveri format datuma, trajanja
|
||||||
|
- Proveri da folder kreira ako ne postoji
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
`TASKS/reports/T01-report.md` se generiše sa tačnim sadržajem.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T06: CLI — komandni interfejs
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** T02, T03, T04, T05
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
Entry point — parsira komande, poziva supervisor funkcije.
|
||||||
|
|
||||||
|
**Fajlovi za izmenu:**
|
||||||
|
```
|
||||||
|
code/cmd/kaos-supervisor/main.go ← komande
|
||||||
|
```
|
||||||
|
|
||||||
|
**Komande:**
|
||||||
|
```bash
|
||||||
|
kaos-supervisor run [TASK_ID] # pokreni task (ili sledeći ako bez ID)
|
||||||
|
kaos-supervisor status # prikaži status svih taskova
|
||||||
|
kaos-supervisor next # prikaži šta je sledeće
|
||||||
|
kaos-supervisor verify # ponovo pokreni verifikaciju
|
||||||
|
kaos-supervisor history # prikaži izvršene taskove iz reports/
|
||||||
|
```
|
||||||
|
|
||||||
|
**Pravila:**
|
||||||
|
- Bez eksternih CLI biblioteka (flag package dovoljno)
|
||||||
|
- Svaka komanda ima --help
|
||||||
|
- Formatiran terminal output (emoji za status)
|
||||||
|
- Poruke na srpskom
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- `kaos-supervisor status` sa primer taskovima → ispravan output
|
||||||
|
- `kaos-supervisor next` → vraća pravi task
|
||||||
|
- Nepoznata komanda → help poruka
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
`make build` → `bin/kaos-supervisor` radi sve komande.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T07: Integracija — sve zajedno
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** T06
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
End-to-end tok: učitaj taskove → pokreni → verifikuj → izveštaj → ažuriraj status.
|
||||||
|
|
||||||
|
**Fajlovi za izmenu:**
|
||||||
|
```
|
||||||
|
code/internal/supervisor/
|
||||||
|
├── supervisor.go ← Run() koji povezuje sve korake
|
||||||
|
└── supervisor_test.go
|
||||||
|
```
|
||||||
|
|
||||||
|
**Funkcija:**
|
||||||
|
```go
|
||||||
|
func (s *Supervisor) Run(taskID string) error {
|
||||||
|
// 1. Učitaj taskove
|
||||||
|
// 2. Nađi task (po ID-u ili NextTask)
|
||||||
|
// 3. Proveri zavisnosti
|
||||||
|
// 4. Postavi status: running
|
||||||
|
// 5. Pokreni Claude Code (RunTask)
|
||||||
|
// 6. Verifikuj (Verify)
|
||||||
|
// 7. Napiši izveštaj (WriteReport)
|
||||||
|
// 8. Postavi status: done ili failed
|
||||||
|
// 9. Prikaži rezultat
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- End-to-end sa mock Claude Code komandom
|
||||||
|
- Task sa neispunjenom zavisnošću → greška
|
||||||
|
- Task koji je već done → skip ili greška
|
||||||
|
- Failed verifikacija → status=failed, izveštaj navede šta palo
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
`kaos-supervisor run T01` prolazi ceo tok od učitavanja do izveštaja.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Redosled izvršavanja
|
||||||
|
|
||||||
|
```
|
||||||
|
T01 (Go init)
|
||||||
|
│
|
||||||
|
├── T02 (Task loader)
|
||||||
|
│ │
|
||||||
|
│ └── T03 (Runner)
|
||||||
|
│ │
|
||||||
|
│ └── T05 (Reporter) ──┐
|
||||||
|
│ │
|
||||||
|
└── T04 (Checker) ─────────────┘
|
||||||
|
│
|
||||||
|
T06 (CLI)
|
||||||
|
│
|
||||||
|
T07 (Integracija)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Quality gates:**
|
||||||
|
- Posle T01: `make build` i `make test` prolaze
|
||||||
|
- Posle T04: Verify radi na test projektu
|
||||||
|
- Posle T06: Sve komande rade iz terminala
|
||||||
|
- Posle T07: End-to-end tok radi sa mock agentom
|
||||||
46
TASKS/MASTER-STATUS.md
Normal file
46
TASKS/MASTER-STATUS.md
Normal file
@ -0,0 +1,46 @@
|
|||||||
|
# KAOS — Master Status
|
||||||
|
|
||||||
|
**Verzija:** 0.3.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Fajl indeks
|
||||||
|
|
||||||
|
| Fajl | Opis |
|
||||||
|
|------|------|
|
||||||
|
| `CLAUDE.md` | Mastermind (v0.3.0) |
|
||||||
|
| `README.md` | Pregled projekta, arhitektura, odluke |
|
||||||
|
| `agents/*/CLAUDE.md` | 8 agenata (v0.1.0) |
|
||||||
|
| `TASKS/MASTER-STATUS.md` | Ovo — navigacija, status |
|
||||||
|
| `TASKS/Implementation-Tasks.md` | Svi taskovi detaljno |
|
||||||
|
| `TASKS/Workflow-Spec.md` | 10 koraka, odluke |
|
||||||
|
| `TASKS/Multi-Agent-Spec.md` | Arhitektura agenata |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task folderi
|
||||||
|
|
||||||
|
| Folder | Sadržaj | Taskovi |
|
||||||
|
|--------|---------|---------|
|
||||||
|
| backlog/ | Čeka odobrenje | T01 |
|
||||||
|
| ready/ | Odobren za rad | — |
|
||||||
|
| active/ | U izradi | — |
|
||||||
|
| review/ | Čeka pregled/odgovor | — |
|
||||||
|
| done/ | Završeno | — |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## v0.1 Taskovi
|
||||||
|
|
||||||
|
| Task | Naslov | Folder | Zavisi od |
|
||||||
|
|------|--------|--------|-----------|
|
||||||
|
| T01 | Inicijalizacija Go projekta | backlog | — |
|
||||||
|
| T02 | Task loader (parsiranje MD) | — | T01 |
|
||||||
|
| T03 | Runner (pokretanje Claude Code) | — | T02 |
|
||||||
|
| T04 | Checker (build + test + vet) | — | T01 |
|
||||||
|
| T05 | Reporter (pisanje izveštaja) | — | T03, T04 |
|
||||||
|
| T06 | CLI (komandni interfejs) | — | T02-T05 |
|
||||||
|
| T07 | Integracija (end-to-end) | — | T06 |
|
||||||
|
|
||||||
|
T02-T07 će biti napisani u backlog/ kad T01 bude done.
|
||||||
79
TASKS/Multi-Agent-Spec.md
Normal file
79
TASKS/Multi-Agent-Spec.md
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
# KAOS Multi-Agent Arhitektura
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Princip
|
||||||
|
|
||||||
|
Jedan mastermind orkestrira, specijalizovani agenti izvršavaju.
|
||||||
|
Mastermind NIKADA ne kodira. Agenti znaju SAMO svoj deo.
|
||||||
|
Agenti NE komuniciraju međusobno — samo sa mastermindom.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Agenti
|
||||||
|
|
||||||
|
| Agent | Uloga | Model | Cena/M tokena |
|
||||||
|
|-------|-------|-------|---------------|
|
||||||
|
| **Mastermind** | Orkestrira, odlučuje, ne kodira | Sonnet | $3/$15 |
|
||||||
|
| **Triage** | Klasifikuje prijave (tip, prioritet, modul) | Haiku | $0.25/$1.25 |
|
||||||
|
| **Task Manager** | Kreira taskove, prati status | Sonnet/Haiku | $3/$15 |
|
||||||
|
| **Coder** | Piše Go kod + testove | Sonnet/Opus | $3-$15/$15-$75 |
|
||||||
|
| **Frontend** | Piše React kod + Playwright testove | Sonnet | $3/$15 |
|
||||||
|
| **Checker** | Build, test, vet, code review | Haiku/Opus | $0.25-$15 |
|
||||||
|
| **Reporter** | Piše izveštaje u markdown | Haiku | $0.25/$1.25 |
|
||||||
|
| **Docs** | Čita eksternu dokumentaciju | Haiku | $0.25/$1.25 |
|
||||||
|
| **Deployer** | Git merge, tag, verzija, deploy | Haiku | $0.25/$1.25 |
|
||||||
|
|
||||||
|
Pravilo: uvek najjeftiniji model koji može da uradi posao.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Izolacija
|
||||||
|
|
||||||
|
Svaki agent dobija SAMO:
|
||||||
|
1. Svoj CLAUDE.md (pravila za njegov deo)
|
||||||
|
2. Fajlove koje treba da čita (eksplicitno)
|
||||||
|
3. Zadatak (šta tačno da uradi)
|
||||||
|
|
||||||
|
Agent NE dobija: celu codebase, druge module, poslovne odluke koje ga se ne tiču.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tok — primer
|
||||||
|
|
||||||
|
```
|
||||||
|
1. Operater: "Dodaj export faktura u PDF"
|
||||||
|
2. Mastermind: razbije na backend (T28a) + frontend (T28b)
|
||||||
|
3. Coder (Sonnet): implementira PDF endpoint + test
|
||||||
|
4. Checker (Haiku): go build, go test, go vet
|
||||||
|
5. Frontend (Sonnet): dugme Export PDF + Playwright test
|
||||||
|
6. Checker (Haiku): npm build, playwright test
|
||||||
|
7. Reporter (Haiku): napiše izveštaj
|
||||||
|
8. Mastermind: "Završeno, čeka odobrenje"
|
||||||
|
9. Operater: pregleda, odobri
|
||||||
|
10. Deployer (Haiku): git tag, deploy
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Verzionisanje
|
||||||
|
|
||||||
|
Svaki CLAUDE.md ima verziju (Semver).
|
||||||
|
Mastermind drži Agent registar sa verzijama.
|
||||||
|
Promena pravila = nova verzija + ažuriran registar.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Prednosti
|
||||||
|
|
||||||
|
| Prednost | Objašnjenje |
|
||||||
|
|----------|-------------|
|
||||||
|
| Jeftinije | Haiku za jednostavne stvari, Opus samo kad mora |
|
||||||
|
| Brže | Manji kontekst = brži odgovor |
|
||||||
|
| Preciznije | Agent fokusiran na jedan zadatak = manje grešaka |
|
||||||
|
| Bezbednije | Agent za frontend ne može pokvariti engine |
|
||||||
|
| Skalabilno | Lako dodaš novog agenta |
|
||||||
|
| Zamenjivo | Novi model — promeniš samo u mastermind config |
|
||||||
65
TASKS/Workflow-Spec.md
Normal file
65
TASKS/Workflow-Spec.md
Normal file
@ -0,0 +1,65 @@
|
|||||||
|
# KAOS Workflow — Korak po korak
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Koraci
|
||||||
|
|
||||||
|
### 0. Klijent prijavi
|
||||||
|
Šta hoće ili šta ne radi. Sad: ti u chatu. Gotov sistem: forma u aplikaciji.
|
||||||
|
|
||||||
|
### 1. Operater proveri
|
||||||
|
Da li ima smisla? Duplikat? Doradi opis.
|
||||||
|
|
||||||
|
### 2. Planer (Claude) se uključi
|
||||||
|
Kad operater kaže "krećemo". Čita kontekst, razume problem.
|
||||||
|
|
||||||
|
### 3. Task se zapiše u markdown
|
||||||
|
Jedno mesto istine. Supervisor parsira direktno. Nema JSON-a.
|
||||||
|
|
||||||
|
### 4. Operater odobri
|
||||||
|
Pregleda task, kaže ok.
|
||||||
|
|
||||||
|
### 5. Claude Code izvrši (triger: ručno)
|
||||||
|
V0.1: `kaos-supervisor run T01`. V0.2: automatizacija.
|
||||||
|
|
||||||
|
### 6. Verifikacija (dupla)
|
||||||
|
Claude Code proveri sam pre commita. Supervisor verifikuje nezavisno posle.
|
||||||
|
V0.1: build + test + vet. V0.2: + AI compliance.
|
||||||
|
|
||||||
|
### 7. Commit + Push + Verzija
|
||||||
|
Semver. Izveštaj uključuje cenu (tokeni).
|
||||||
|
|
||||||
|
### 8. Izveštaj
|
||||||
|
Markdown u TASKS/reports/, ide u git. Sadrži vreme, status, cenu, promene.
|
||||||
|
|
||||||
|
### 9. Operater pregleda
|
||||||
|
Kod, testovi, izveštaj. Ako ne valja: novi task sa MD referencom na stari.
|
||||||
|
Rollback: git revert.
|
||||||
|
|
||||||
|
### 10. Deploy
|
||||||
|
V0.1: git push = deploy. V0.2: distribucija prema licencama.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Odluke
|
||||||
|
|
||||||
|
| Tema | Odluka |
|
||||||
|
|------|--------|
|
||||||
|
| Format taskova | Samo markdown |
|
||||||
|
| Triger | Ručno (v0.1) |
|
||||||
|
| Supervisor | Po potrebi, nije daemon (v0.1) |
|
||||||
|
| Verifikacija | Dupla (agent + supervisor) |
|
||||||
|
| Retry | Čekaj operatera (v0.1) |
|
||||||
|
| Verzionisanje | Semver |
|
||||||
|
| Izveštaji | Markdown u reports/, git |
|
||||||
|
| Dorada | Novi task sa MD referencom |
|
||||||
|
| Rollback | Git revert |
|
||||||
|
| Branch | Main direktno (v0.1), staging (v0.2) |
|
||||||
|
| Timeout | Ručno podešavanje |
|
||||||
|
| Logovanje | Real-time + sumarno |
|
||||||
|
| Paralelnost | Jedan (v0.1), konfigurabilan (v0.2) |
|
||||||
|
| Troškovi | Po tasku (tokeni, cena, vreme) |
|
||||||
|
| Notifikacije | Bez (v0.1), konfigurabilan (v0.2) |
|
||||||
66
TASKS/active/T01.md
Normal file
66
TASKS/active/T01.md
Normal file
@ -0,0 +1,66 @@
|
|||||||
|
# T01: Inicijalizacija Go projekta
|
||||||
|
|
||||||
|
**Kreirao:** planer
|
||||||
|
**Datum:** 2026-02-20
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** —
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Opis
|
||||||
|
|
||||||
|
Kreirati Go projekat u `code/` folderu sa osnovnom strukturom
|
||||||
|
za KAOS supervisor.
|
||||||
|
|
||||||
|
## Fajlovi za kreiranje
|
||||||
|
|
||||||
|
```
|
||||||
|
code/
|
||||||
|
├── go.mod ← module github.com/dal/kaos
|
||||||
|
├── .env.example ← KAOS_TIMEOUT=30m, KAOS_PROJECT_PATH=.
|
||||||
|
├── .gitignore ← Go defaults + .env
|
||||||
|
├── Makefile ← build, test, vet, clean, all
|
||||||
|
├── cmd/
|
||||||
|
│ └── kaos-supervisor/
|
||||||
|
│ └── main.go ← entry point (prazan skeleton)
|
||||||
|
├── internal/
|
||||||
|
│ ├── config/
|
||||||
|
│ │ ├── config.go ← čita .env, Config struct
|
||||||
|
│ │ └── config_test.go ← test
|
||||||
|
│ └── supervisor/
|
||||||
|
│ └── supervisor.go ← prazan skeleton
|
||||||
|
└── CLAUDE.md ← kopija agents/coder/CLAUDE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Pravila
|
||||||
|
|
||||||
|
- `go mod init github.com/dal/kaos`
|
||||||
|
- Go 1.22+
|
||||||
|
- Makefile targeti: `build`, `test`, `vet`, `clean`, `all`
|
||||||
|
- Config čita iz .env: KAOS_TIMEOUT, KAOS_PROJECT_PATH
|
||||||
|
- Svaki fajl mora imati package doc komentar
|
||||||
|
- Nema hardkodiranih vrednosti
|
||||||
|
|
||||||
|
## Testovi
|
||||||
|
|
||||||
|
- `go build ./...` prolazi
|
||||||
|
- `go vet ./...` prolazi
|
||||||
|
- Config test: učitaj .env.example, proveri da su vrednosti popunjene
|
||||||
|
|
||||||
|
## Očekivani izlaz
|
||||||
|
|
||||||
|
Projekat se kompajlira. `make build` kreira binary u `bin/`.
|
||||||
|
`make test` prolazi. `make vet` čist.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Pitanja
|
||||||
|
|
||||||
|
*(agent piše pitanja ovde, planer odgovara)*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Odgovori
|
||||||
|
|
||||||
|
*(planer piše odgovore ovde)*
|
||||||
41
agents/checker/CLAUDE.md
Normal file
41
agents/checker/CLAUDE.md
Normal file
@ -0,0 +1,41 @@
|
|||||||
|
# Checker Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Verifikuje da je kod ispravan — build, test, vet.
|
||||||
|
V0.2+: provera usklađenosti sa poslovnim pravilima.
|
||||||
|
|
||||||
|
## Model: Haiku (build/test) / Opus (code review)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Putanja do projekta
|
||||||
|
- Šta da proveri (build, test, vet, ili sve)
|
||||||
|
- V0.2+: pravila za proveru (modul docs, konvencije)
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
```
|
||||||
|
build: PASS / FAIL (output, trajanje)
|
||||||
|
vet: PASS / FAIL (output, trajanje)
|
||||||
|
test: PASS / FAIL (output, trajanje, broj testova)
|
||||||
|
```
|
||||||
|
|
||||||
|
## V0.1 provere (deterministične)
|
||||||
|
- `go build ./...`
|
||||||
|
- `go vet ./...`
|
||||||
|
- `go test ./... -v -count=1`
|
||||||
|
|
||||||
|
## V0.2+ provere (AI)
|
||||||
|
- MODULE — promene u skladu sa dokumentacijom modula
|
||||||
|
- RULES — poštovanje poslovnih pravila
|
||||||
|
- CONVENTIONS — terminologija, naming, stil
|
||||||
|
- RBAC — endpoint u pravom route group-u
|
||||||
|
- AUDIT — write operacije imaju audit log
|
||||||
|
- LICENSE — feature u pravoj ediciji
|
||||||
|
- DEPS — ne kvari zavisne module
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Zašto je task napravljen
|
||||||
|
- Ko je prijavio
|
||||||
|
- Druge module osim onog koji proverava
|
||||||
39
agents/coder/CLAUDE.md
Normal file
39
agents/coder/CLAUDE.md
Normal file
@ -0,0 +1,39 @@
|
|||||||
|
# Coder Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Piše kod prema zadatku. Implementira funkcionalnost, piše testove,
|
||||||
|
poštuje konvencije projekta.
|
||||||
|
|
||||||
|
## Model: Sonnet (standardan) / Opus (kompleksno)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Zadatak (šta tačno da uradi)
|
||||||
|
- Fajlove koje treba da čita (eksplicitno navedene)
|
||||||
|
- Ograničenja (šta NE sme)
|
||||||
|
- code/CLAUDE.md (pravila kodiranja za ovaj projekat)
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Status: gotovo / neuspešno / treba pojašnjenje
|
||||||
|
- Lista kreiranih/izmenjenih fajlova
|
||||||
|
- Commit hash
|
||||||
|
- Pokrenuti testovi i rezultat
|
||||||
|
|
||||||
|
## Pravila
|
||||||
|
- Poštuje code/CLAUDE.md pravila
|
||||||
|
- Svaka funkcija mora imati test
|
||||||
|
- `go build ./...` mora proći pre commita
|
||||||
|
- `go test ./... -count=1` mora proći pre commita
|
||||||
|
- `go vet ./...` mora proći pre commita
|
||||||
|
- Commit format: `T{XX}: Opis na srpskom`
|
||||||
|
- Error handling: svaka greška se obrađuje
|
||||||
|
- Nazivi u kodu: engleski
|
||||||
|
- Nema hardkodiranih vrednosti
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Druge module osim onih u zadatku
|
||||||
|
- Poslovne odluke
|
||||||
|
- Druge agente
|
||||||
|
- Frontend (osim ako je to zadatak)
|
||||||
40
agents/deployer/CLAUDE.md
Normal file
40
agents/deployer/CLAUDE.md
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
# Deployer Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Git merge, verzionisanje, deploy hook-ovi.
|
||||||
|
Izvršava finalne korake posle odobrenja operatera.
|
||||||
|
|
||||||
|
## Model: Haiku (shell komande, deterministički)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Commit/branch za deploy
|
||||||
|
- Verzija (semver)
|
||||||
|
- Deploy target (produkcija, staging)
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Status: deployed / failed
|
||||||
|
- Verzija koja je deployovana
|
||||||
|
- Git tag kreiran
|
||||||
|
- Servis restartovan (da/ne)
|
||||||
|
|
||||||
|
## V0.1 akcije
|
||||||
|
```bash
|
||||||
|
git tag v{X.Y.Z}
|
||||||
|
git push origin --tags
|
||||||
|
# restart servisa ako treba
|
||||||
|
```
|
||||||
|
|
||||||
|
## V0.2+ akcije
|
||||||
|
- Merge staging → main
|
||||||
|
- Build binary
|
||||||
|
- Distribucija prema licencama
|
||||||
|
- Notifikacija klijentima o novoj verziji
|
||||||
|
- Rollback ako deploy padne
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Šta je u kodu
|
||||||
|
- Zašto se deploy radi
|
||||||
|
- Poslovne odluke
|
||||||
24
agents/docs/CLAUDE.md
Normal file
24
agents/docs/CLAUDE.md
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
# Docs Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Čita, indeksira i sumira eksternu dokumentaciju.
|
||||||
|
API specifikacije, zakoni, regulative, dokumentacija biblioteka.
|
||||||
|
|
||||||
|
## Model: Haiku (čitanje, sumiranje)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Pitanje ili kontekst koji treba istražiti
|
||||||
|
- Putanja do relevantnih dokumenata u documentation/
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Odgovor na pitanje
|
||||||
|
- Relevantni delovi dokumentacije (citati, reference)
|
||||||
|
- Sumarni pregled ako je tražen
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Kod projekta
|
||||||
|
- Taskove
|
||||||
|
- Druge agente
|
||||||
36
agents/frontend/CLAUDE.md
Normal file
36
agents/frontend/CLAUDE.md
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
# Frontend Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Piše React frontend kod — komponente, stranice, API pozive, testove.
|
||||||
|
|
||||||
|
## Model: Sonnet
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Zadatak (šta da napravi/izmeni)
|
||||||
|
- API endpoint specifikaciju (šta backend vraća)
|
||||||
|
- Wireframe ili opis UI-a
|
||||||
|
- code/kaos-frontend/CLAUDE.md (pravila za frontend)
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Status: gotovo / neuspešno / treba pojašnjenje
|
||||||
|
- Lista kreiranih/izmenjenih fajlova
|
||||||
|
- Commit hash
|
||||||
|
- Screenshot ili opis promena
|
||||||
|
|
||||||
|
## Pravila
|
||||||
|
- React + TypeScript + Vite + Tailwind + shadcn/ui
|
||||||
|
- TanStack Query za API pozive
|
||||||
|
- Playwright testovi za svaki novi flow
|
||||||
|
- `npm run build` mora proći
|
||||||
|
- `npx playwright test` mora proći
|
||||||
|
- Responsivan dizajn
|
||||||
|
- Poruke korisniku: srpski
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Backend implementaciju (samo API spec)
|
||||||
|
- Engine internals
|
||||||
|
- Bazu podataka
|
||||||
|
- Poslovne odluke osim onih u zadatku
|
||||||
49
agents/reporter/CLAUDE.md
Normal file
49
agents/reporter/CLAUDE.md
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
# Reporter Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Piše izveštaje posle izvršenih taskova. Formatira podatke u markdown.
|
||||||
|
|
||||||
|
## Model: Haiku (jeftin, formatiranje poznatih podataka)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Task ID i naslov
|
||||||
|
- Vreme početka i kraja
|
||||||
|
- Rezultat verifikacije (build, test, vet)
|
||||||
|
- Lista promenjenih fajlova
|
||||||
|
- Commit hash
|
||||||
|
- Token potrošnja i cena
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Putanja do izveštaja: `tasks/reports/T{XX}-report.md`
|
||||||
|
|
||||||
|
## Format izveštaja
|
||||||
|
```markdown
|
||||||
|
# T{XX}: Naslov
|
||||||
|
|
||||||
|
**Datum:** YYYY-MM-DD HH:MM
|
||||||
|
**Trajanje:** Xm Ys
|
||||||
|
**Status:** ✅ Završen / ❌ Neuspešan
|
||||||
|
**Cena:** ~$X.XX (N tokena)
|
||||||
|
**Model:** Koji model je korišćen
|
||||||
|
|
||||||
|
## Verifikacija
|
||||||
|
- ✅/❌ go build (Xs)
|
||||||
|
- ✅/❌ go vet (Xs)
|
||||||
|
- ✅/❌ go test (N/N testova, Xs)
|
||||||
|
|
||||||
|
## Promene
|
||||||
|
- N fajlova kreirano/izmenjeno
|
||||||
|
- Commit: hash
|
||||||
|
- Branch: main
|
||||||
|
|
||||||
|
## Fajlovi
|
||||||
|
- putanja/fajl.go (kreiran/izmenjen)
|
||||||
|
```
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Sadržaj koda
|
||||||
|
- Poslovnu logiku
|
||||||
|
- Druge taskove
|
||||||
43
agents/task-manager/CLAUDE.md
Normal file
43
agents/task-manager/CLAUDE.md
Normal file
@ -0,0 +1,43 @@
|
|||||||
|
# Task Manager Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Upravlja task listom — kreira taskove, ažurira status, prati zavisnosti.
|
||||||
|
Parsira markdown taskove za supervisor.
|
||||||
|
|
||||||
|
## Model: Sonnet (kreiranje) / Haiku (status update)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Opis šta treba da se uradi (od operatera)
|
||||||
|
- Trenutni status taskova (MASTER-STATUS.md)
|
||||||
|
- Zavisnosti između taskova
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Kreiran task u tasks/Implementation-Tasks.md
|
||||||
|
- Ažuriran MASTER-STATUS.md
|
||||||
|
- Lista zavisnosti i redosled izvršavanja
|
||||||
|
|
||||||
|
## Upravlja fajlovima
|
||||||
|
- tasks/Implementation-Tasks.md — dodaje/menja taskove
|
||||||
|
- tasks/MASTER-STATUS.md — ažurira status
|
||||||
|
- tasks/reports/ — ne piše (to radi reporter)
|
||||||
|
|
||||||
|
## Format taska u markdown-u
|
||||||
|
```markdown
|
||||||
|
### T{XX}: Naslov
|
||||||
|
**Status:** pending / running / done / failed
|
||||||
|
**Zavisi od:** T{YY}, T{ZZ}
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Fajlovi za čitanje:** [lista]
|
||||||
|
**Fajlovi za izmenu:** [lista]
|
||||||
|
**Opis:** Šta tačno treba uraditi
|
||||||
|
**Ograničenja:** Šta NE sme
|
||||||
|
**Očekivani izlaz:** Kako izgleda kad je gotovo
|
||||||
|
```
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Kod projekta
|
||||||
|
- Kako se kodira
|
||||||
|
- Poslovne detalje osim onih u opisu
|
||||||
28
agents/triage/CLAUDE.md
Normal file
28
agents/triage/CLAUDE.md
Normal file
@ -0,0 +1,28 @@
|
|||||||
|
# Triage Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Klasifikuje prijave — tip, prioritet, pogođeni modul, procena složenosti.
|
||||||
|
|
||||||
|
## Model: Haiku (brz, jeftin)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Tekst prijave (šta korisnik kaže)
|
||||||
|
- Listu modula projekta (samo imena)
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
```
|
||||||
|
Tip: BUG / NOVO / IZMENA
|
||||||
|
Prioritet: LOW / MEDIUM / HIGH / CRITICAL
|
||||||
|
Modul: koji deo sistema (fakture, zaposleni, smene...)
|
||||||
|
Procena: jednostavno / srednje / kompleksno
|
||||||
|
Kratak opis: jednom rečenicom šta je problem
|
||||||
|
```
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Kod projekta
|
||||||
|
- Arhitekturu
|
||||||
|
- Poslovne odluke
|
||||||
|
- Druge taskove
|
||||||
2
code/.env.example
Normal file
2
code/.env.example
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
KAOS_TIMEOUT=30m
|
||||||
|
KAOS_PROJECT_PATH=.
|
||||||
31
code/.gitignore
vendored
Normal file
31
code/.gitignore
vendored
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
# Binaries
|
||||||
|
bin/
|
||||||
|
*.exe
|
||||||
|
*.exe~
|
||||||
|
*.dll
|
||||||
|
*.so
|
||||||
|
*.dylib
|
||||||
|
|
||||||
|
# Test binary
|
||||||
|
*.test
|
||||||
|
|
||||||
|
# Output of go coverage
|
||||||
|
*.out
|
||||||
|
|
||||||
|
# Go workspace
|
||||||
|
go.work
|
||||||
|
go.work.sum
|
||||||
|
|
||||||
|
# Environment
|
||||||
|
.env
|
||||||
|
|
||||||
|
# IDE
|
||||||
|
.idea/
|
||||||
|
.vscode/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
|
||||||
|
# OS
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
39
code/CLAUDE.md
Normal file
39
code/CLAUDE.md
Normal file
@ -0,0 +1,39 @@
|
|||||||
|
# Coder Agent
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Poslednje ažuriranje:** 2026-02-20
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Piše kod prema zadatku. Implementira funkcionalnost, piše testove,
|
||||||
|
poštuje konvencije projekta.
|
||||||
|
|
||||||
|
## Model: Sonnet (standardan) / Opus (kompleksno)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Zadatak (šta tačno da uradi)
|
||||||
|
- Fajlove koje treba da čita (eksplicitno navedene)
|
||||||
|
- Ograničenja (šta NE sme)
|
||||||
|
- code/CLAUDE.md (pravila kodiranja za ovaj projekat)
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Status: gotovo / neuspešno / treba pojašnjenje
|
||||||
|
- Lista kreiranih/izmenjenih fajlova
|
||||||
|
- Commit hash
|
||||||
|
- Pokrenuti testovi i rezultat
|
||||||
|
|
||||||
|
## Pravila
|
||||||
|
- Poštuje code/CLAUDE.md pravila
|
||||||
|
- Svaka funkcija mora imati test
|
||||||
|
- `go build ./...` mora proći pre commita
|
||||||
|
- `go test ./... -count=1` mora proći pre commita
|
||||||
|
- `go vet ./...` mora proći pre commita
|
||||||
|
- Commit format: `T{XX}: Opis na srpskom`
|
||||||
|
- Error handling: svaka greška se obrađuje
|
||||||
|
- Nazivi u kodu: engleski
|
||||||
|
- Nema hardkodiranih vrednosti
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Druge module osim onih u zadatku
|
||||||
|
- Poslovne odluke
|
||||||
|
- Druge agente
|
||||||
|
- Frontend (osim ako je to zadatak)
|
||||||
19
code/Makefile
Normal file
19
code/Makefile
Normal file
@ -0,0 +1,19 @@
|
|||||||
|
BINARY_NAME=kaos-supervisor
|
||||||
|
BIN_DIR=bin
|
||||||
|
|
||||||
|
.PHONY: all build test vet clean
|
||||||
|
|
||||||
|
all: vet test build
|
||||||
|
|
||||||
|
build:
|
||||||
|
go build -o $(BIN_DIR)/$(BINARY_NAME) ./cmd/kaos-supervisor/
|
||||||
|
|
||||||
|
test:
|
||||||
|
go test ./... -v -count=1
|
||||||
|
|
||||||
|
vet:
|
||||||
|
go vet ./...
|
||||||
|
|
||||||
|
clean:
|
||||||
|
rm -rf $(BIN_DIR)
|
||||||
|
go clean
|
||||||
22
code/cmd/kaos-supervisor/main.go
Normal file
22
code/cmd/kaos-supervisor/main.go
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
// Package main is the entry point for the KAOS supervisor process.
|
||||||
|
// It loads configuration and starts the supervisor.
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"log"
|
||||||
|
"os"
|
||||||
|
|
||||||
|
"github.com/dal/kaos/internal/config"
|
||||||
|
_ "github.com/dal/kaos/internal/supervisor"
|
||||||
|
)
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
cfg, err := config.Load()
|
||||||
|
if err != nil {
|
||||||
|
log.Fatalf("Failed to load config: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Fprintf(os.Stdout, "KAOS Supervisor started (timeout=%s, project_path=%s)\n",
|
||||||
|
cfg.Timeout, cfg.ProjectPath)
|
||||||
|
}
|
||||||
3
code/go.mod
Normal file
3
code/go.mod
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
module github.com/dal/kaos
|
||||||
|
|
||||||
|
go 1.23.6
|
||||||
77
code/internal/config/config.go
Normal file
77
code/internal/config/config.go
Normal file
@ -0,0 +1,77 @@
|
|||||||
|
// Package config handles loading and validating configuration
|
||||||
|
// for the KAOS supervisor from environment variables.
|
||||||
|
package config
|
||||||
|
|
||||||
|
import (
|
||||||
|
"bufio"
|
||||||
|
"fmt"
|
||||||
|
"os"
|
||||||
|
"strings"
|
||||||
|
"time"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Config holds the supervisor configuration values.
|
||||||
|
type Config struct {
|
||||||
|
// Timeout is the maximum duration for supervisor operations.
|
||||||
|
Timeout time.Duration
|
||||||
|
// ProjectPath is the root path of the project being supervised.
|
||||||
|
ProjectPath string
|
||||||
|
}
|
||||||
|
|
||||||
|
// Load reads configuration from environment variables.
|
||||||
|
// It first attempts to load a .env file from the current directory.
|
||||||
|
// Required variables: KAOS_TIMEOUT, KAOS_PROJECT_PATH.
|
||||||
|
func Load() (*Config, error) {
|
||||||
|
loadEnvFile(".env")
|
||||||
|
|
||||||
|
timeoutStr := os.Getenv("KAOS_TIMEOUT")
|
||||||
|
if timeoutStr == "" {
|
||||||
|
return nil, fmt.Errorf("KAOS_TIMEOUT environment variable is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
timeout, err := time.ParseDuration(timeoutStr)
|
||||||
|
if err != nil {
|
||||||
|
return nil, fmt.Errorf("invalid KAOS_TIMEOUT value %q: %w", timeoutStr, err)
|
||||||
|
}
|
||||||
|
|
||||||
|
projectPath := os.Getenv("KAOS_PROJECT_PATH")
|
||||||
|
if projectPath == "" {
|
||||||
|
return nil, fmt.Errorf("KAOS_PROJECT_PATH environment variable is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
return &Config{
|
||||||
|
Timeout: timeout,
|
||||||
|
ProjectPath: projectPath,
|
||||||
|
}, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// loadEnvFile reads a .env file and sets environment variables
|
||||||
|
// that are not already set. Lines starting with # are ignored.
|
||||||
|
func loadEnvFile(path string) {
|
||||||
|
f, err := os.Open(path)
|
||||||
|
if err != nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
defer f.Close()
|
||||||
|
|
||||||
|
scanner := bufio.NewScanner(f)
|
||||||
|
for scanner.Scan() {
|
||||||
|
line := strings.TrimSpace(scanner.Text())
|
||||||
|
if line == "" || strings.HasPrefix(line, "#") {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
key, value, ok := strings.Cut(line, "=")
|
||||||
|
if !ok {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
key = strings.TrimSpace(key)
|
||||||
|
value = strings.TrimSpace(value)
|
||||||
|
|
||||||
|
// Don't override existing environment variables
|
||||||
|
if _, exists := os.LookupEnv(key); !exists {
|
||||||
|
os.Setenv(key, value)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
103
code/internal/config/config_test.go
Normal file
103
code/internal/config/config_test.go
Normal file
@ -0,0 +1,103 @@
|
|||||||
|
// Package config tests verify configuration loading from
|
||||||
|
// environment variables and .env files.
|
||||||
|
package config
|
||||||
|
|
||||||
|
import (
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
"testing"
|
||||||
|
"time"
|
||||||
|
)
|
||||||
|
|
||||||
|
func TestLoad_WithValidEnv(t *testing.T) {
|
||||||
|
t.Setenv("KAOS_TIMEOUT", "30m")
|
||||||
|
t.Setenv("KAOS_PROJECT_PATH", "/tmp/test")
|
||||||
|
|
||||||
|
cfg, err := Load()
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("unexpected error: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
if cfg.Timeout != 30*time.Minute {
|
||||||
|
t.Errorf("expected timeout 30m, got %v", cfg.Timeout)
|
||||||
|
}
|
||||||
|
|
||||||
|
if cfg.ProjectPath != "/tmp/test" {
|
||||||
|
t.Errorf("expected project path /tmp/test, got %s", cfg.ProjectPath)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestLoad_MissingTimeout(t *testing.T) {
|
||||||
|
t.Setenv("KAOS_TIMEOUT", "")
|
||||||
|
t.Setenv("KAOS_PROJECT_PATH", "/tmp/test")
|
||||||
|
|
||||||
|
_, err := Load()
|
||||||
|
if err == nil {
|
||||||
|
t.Fatal("expected error for missing KAOS_TIMEOUT")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestLoad_InvalidTimeout(t *testing.T) {
|
||||||
|
t.Setenv("KAOS_TIMEOUT", "not-a-duration")
|
||||||
|
t.Setenv("KAOS_PROJECT_PATH", "/tmp/test")
|
||||||
|
|
||||||
|
_, err := Load()
|
||||||
|
if err == nil {
|
||||||
|
t.Fatal("expected error for invalid KAOS_TIMEOUT")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestLoad_MissingProjectPath(t *testing.T) {
|
||||||
|
t.Setenv("KAOS_TIMEOUT", "30m")
|
||||||
|
t.Setenv("KAOS_PROJECT_PATH", "")
|
||||||
|
|
||||||
|
_, err := Load()
|
||||||
|
if err == nil {
|
||||||
|
t.Fatal("expected error for missing KAOS_PROJECT_PATH")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestLoadEnvFile(t *testing.T) {
|
||||||
|
dir := t.TempDir()
|
||||||
|
envPath := filepath.Join(dir, ".env")
|
||||||
|
|
||||||
|
content := "TEST_KAOS_VAR=hello\n# comment\nTEST_KAOS_OTHER=world\n"
|
||||||
|
if err := os.WriteFile(envPath, []byte(content), 0644); err != nil {
|
||||||
|
t.Fatalf("failed to write .env: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Ensure vars are not set
|
||||||
|
os.Unsetenv("TEST_KAOS_VAR")
|
||||||
|
os.Unsetenv("TEST_KAOS_OTHER")
|
||||||
|
|
||||||
|
loadEnvFile(envPath)
|
||||||
|
|
||||||
|
if v := os.Getenv("TEST_KAOS_VAR"); v != "hello" {
|
||||||
|
t.Errorf("expected TEST_KAOS_VAR=hello, got %q", v)
|
||||||
|
}
|
||||||
|
if v := os.Getenv("TEST_KAOS_OTHER"); v != "world" {
|
||||||
|
t.Errorf("expected TEST_KAOS_OTHER=world, got %q", v)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Cleanup
|
||||||
|
os.Unsetenv("TEST_KAOS_VAR")
|
||||||
|
os.Unsetenv("TEST_KAOS_OTHER")
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestLoadEnvFile_DoesNotOverride(t *testing.T) {
|
||||||
|
dir := t.TempDir()
|
||||||
|
envPath := filepath.Join(dir, ".env")
|
||||||
|
|
||||||
|
content := "TEST_KAOS_EXISTING=from_file\n"
|
||||||
|
if err := os.WriteFile(envPath, []byte(content), 0644); err != nil {
|
||||||
|
t.Fatalf("failed to write .env: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
t.Setenv("TEST_KAOS_EXISTING", "from_env")
|
||||||
|
|
||||||
|
loadEnvFile(envPath)
|
||||||
|
|
||||||
|
if v := os.Getenv("TEST_KAOS_EXISTING"); v != "from_env" {
|
||||||
|
t.Errorf("expected TEST_KAOS_EXISTING=from_env, got %q", v)
|
||||||
|
}
|
||||||
|
}
|
||||||
3
code/internal/supervisor/supervisor.go
Normal file
3
code/internal/supervisor/supervisor.go
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
// Package supervisor implements the KAOS supervisor process
|
||||||
|
// that orchestrates agent execution and task management.
|
||||||
|
package supervisor
|
||||||
96
templates/new-project/CLAUDE.md
Normal file
96
templates/new-project/CLAUDE.md
Normal file
@ -0,0 +1,96 @@
|
|||||||
|
# {{PROJECT_NAME}} — Mastermind
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Orkestrira ceo {{PROJECT_NAME}} sistem. Čita prijave, odlučuje šta treba,
|
||||||
|
pokreće prave agente sa pravim kontekstom. NIKADA ne kodira.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Projekat
|
||||||
|
|
||||||
|
**Ime:** {{PROJECT_NAME}}
|
||||||
|
**Opis:** {{PROJECT_DESCRIPTION}}
|
||||||
|
**Jezik:** {{LANGUAGE}}
|
||||||
|
**Server:** {{SERVER}}
|
||||||
|
**Git:** {{GIT_REMOTE}}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Struktura
|
||||||
|
|
||||||
|
```
|
||||||
|
{{PROJECT_PATH}}/
|
||||||
|
├── CLAUDE.md ← OVO — mastermind
|
||||||
|
├── README.md
|
||||||
|
├── agents/ ← specijalizovani agenti
|
||||||
|
├── code/ ← kod projekta
|
||||||
|
├── documentation/ ← eksterna dokumentacija
|
||||||
|
└── TASKS/ ← taskovi, status, izveštaji
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 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 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Odgovornosti
|
||||||
|
|
||||||
|
### Šta radi
|
||||||
|
- Čita prijave i taskove od operatera
|
||||||
|
- Odlučuje koji agent za koji posao
|
||||||
|
- Bira AI model po zadatku (Haiku/Sonnet/Opus)
|
||||||
|
- Priprema minimalan kontekst za agenta
|
||||||
|
- Pokreće agenta sa jasnim zadatkom
|
||||||
|
- Čita izveštaj agenta
|
||||||
|
- Ažurira status u TASKS/MASTER-STATUS.md
|
||||||
|
- Komunicira rezultat operateru
|
||||||
|
|
||||||
|
### Šta NE radi
|
||||||
|
- Ne kodira
|
||||||
|
- Ne piše testove
|
||||||
|
- Ne menja fajlove u code/
|
||||||
|
- Ne pristupa bazi direktno
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Model selekcija
|
||||||
|
|
||||||
|
| Zadatak | Agent | Model |
|
||||||
|
|---------|-------|-------|
|
||||||
|
| Klasifikacija prijave | triage | Haiku |
|
||||||
|
| Generisanje taska | task-manager | Sonnet |
|
||||||
|
| Kodiranje | coder | Sonnet/Opus |
|
||||||
|
| Frontend | frontend | Sonnet |
|
||||||
|
| Build + Test | checker | Haiku |
|
||||||
|
| Code review | checker | Opus |
|
||||||
|
| Izveštaj | reporter | Haiku |
|
||||||
|
| Dokumentacija | docs | Haiku |
|
||||||
|
| Deploy | deployer | Haiku |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Pristup
|
||||||
|
|
||||||
|
| Folder | Čita | Piše |
|
||||||
|
|--------|------|------|
|
||||||
|
| agents/ | ✅ | ❌ |
|
||||||
|
| TASKS/ | ✅ | ✅ |
|
||||||
|
| documentation/ | ✅ | ❌ |
|
||||||
|
| code/ | ✅ (strukturu) | ❌ |
|
||||||
60
templates/new-project/README.md
Normal file
60
templates/new-project/README.md
Normal file
@ -0,0 +1,60 @@
|
|||||||
|
# {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Status:** Pokretanje
|
||||||
|
**Autor:** {{AUTHOR}}
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Opis
|
||||||
|
|
||||||
|
{{PROJECT_DESCRIPTION}}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Arhitektura
|
||||||
|
|
||||||
|
Multi-agent sistem (KAOS framework):
|
||||||
|
- Mastermind orkestrira, ne kodira
|
||||||
|
- Specijalizovani agenti izvršavaju
|
||||||
|
- Operater odobrava
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Struktura
|
||||||
|
|
||||||
|
```
|
||||||
|
{{PROJECT_PATH}}/
|
||||||
|
├── CLAUDE.md ← mastermind
|
||||||
|
├── README.md ← ovo
|
||||||
|
├── agents/ ← 8 agenata
|
||||||
|
├── code/ ← {{LANGUAGE}} kod
|
||||||
|
├── documentation/ ← eksterna dokumentacija
|
||||||
|
└── TASKS/
|
||||||
|
├── MASTER-STATUS.md
|
||||||
|
├── Implementation-Tasks.md
|
||||||
|
└── reports/
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tehnologije
|
||||||
|
|
||||||
|
| Komponenta | Izbor |
|
||||||
|
|-----------|-------|
|
||||||
|
| Backend | {{LANGUAGE}} |
|
||||||
|
| Frontend | {{FRONTEND}} |
|
||||||
|
| Baza | {{DATABASE}} |
|
||||||
|
| Server | {{SERVER}} |
|
||||||
|
| Git | {{GIT_REMOTE}} |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
- [x] Projekat kreiran
|
||||||
|
- [ ] Taskovi definisani
|
||||||
|
- [ ] Razvoj u toku
|
||||||
|
- [ ] Testiranje
|
||||||
|
- [ ] Deploy
|
||||||
34
templates/new-project/TASKS/Implementation-Tasks.md
Normal file
34
templates/new-project/TASKS/Implementation-Tasks.md
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
# {{PROJECT_NAME}} — Implementacioni taskovi
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Pregled
|
||||||
|
|
||||||
|
{{PROJECT_DESCRIPTION}}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## T01: {{TASK_TITLE}}
|
||||||
|
|
||||||
|
**Status:** pending
|
||||||
|
**Agent:** coder
|
||||||
|
**Model:** Sonnet
|
||||||
|
**Zavisi od:** —
|
||||||
|
|
||||||
|
**Opis:**
|
||||||
|
{{TASK_DESCRIPTION}}
|
||||||
|
|
||||||
|
**Fajlovi za kreiranje:**
|
||||||
|
```
|
||||||
|
code/
|
||||||
|
└── ...
|
||||||
|
```
|
||||||
|
|
||||||
|
**Test:**
|
||||||
|
- {{TEST_CRITERIA}}
|
||||||
|
|
||||||
|
**Očekivani izlaz:**
|
||||||
|
{{EXPECTED_OUTPUT}}
|
||||||
48
templates/new-project/TASKS/MASTER-STATUS.md
Normal file
48
templates/new-project/TASKS/MASTER-STATUS.md
Normal file
@ -0,0 +1,48 @@
|
|||||||
|
# {{PROJECT_NAME}} — Master Status
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Fajl indeks
|
||||||
|
|
||||||
|
| Fajl | Opis |
|
||||||
|
|------|------|
|
||||||
|
| `CLAUDE.md` | Mastermind (v0.1.0) |
|
||||||
|
| `README.md` | Pregled projekta |
|
||||||
|
| `agents/*/CLAUDE.md` | 8 agenata |
|
||||||
|
| `TASKS/MASTER-STATUS.md` | Ovo — navigacija, status |
|
||||||
|
| `TASKS/Implementation-Tasks.md` | Taskovi |
|
||||||
|
| `TASKS/reports/` | Izveštaji |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Agenti
|
||||||
|
|
||||||
|
| 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 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Taskovi
|
||||||
|
|
||||||
|
| Task | Naslov | Status | Zavisi od |
|
||||||
|
|------|--------|--------|-----------|
|
||||||
|
| | | | |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Odluke
|
||||||
|
|
||||||
|
| Odluka | Izbor |
|
||||||
|
|--------|-------|
|
||||||
|
| | |
|
||||||
29
templates/new-project/agents/checker/CLAUDE.md
Normal file
29
templates/new-project/agents/checker/CLAUDE.md
Normal file
@ -0,0 +1,29 @@
|
|||||||
|
# Checker Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Verifikuje da je kod ispravan — build, test, lint.
|
||||||
|
|
||||||
|
## Model: Haiku (build/test) / Opus (code review)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Putanja do projekta
|
||||||
|
- Šta da proveri
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
```
|
||||||
|
build: PASS / FAIL (output, trajanje)
|
||||||
|
lint: PASS / FAIL (output, trajanje)
|
||||||
|
test: PASS / FAIL (output, trajanje, broj testova)
|
||||||
|
```
|
||||||
|
|
||||||
|
## V0.1 provere (deterministične)
|
||||||
|
{{BUILD_COMMAND}}
|
||||||
|
{{LINT_COMMAND}}
|
||||||
|
{{TEST_COMMAND}}
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Zašto je task napravljen
|
||||||
|
- Druge module
|
||||||
33
templates/new-project/agents/coder/CLAUDE.md
Normal file
33
templates/new-project/agents/coder/CLAUDE.md
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
# Coder Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Piše kod prema zadatku. Implementira funkcionalnost, piše testove.
|
||||||
|
|
||||||
|
## Model: Sonnet (standardan) / Opus (kompleksno)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Zadatak (šta tačno da uradi)
|
||||||
|
- Fajlove koje treba da čita
|
||||||
|
- Ograničenja
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Status: gotovo / neuspešno / treba pojašnjenje
|
||||||
|
- Lista kreiranih/izmenjenih fajlova
|
||||||
|
- Commit hash
|
||||||
|
|
||||||
|
## Pravila
|
||||||
|
- Svaka funkcija mora imati test
|
||||||
|
- Build mora proći pre commita
|
||||||
|
- Testovi moraju proći pre commita
|
||||||
|
- Commit format: `T{XX}: Opis na srpskom`
|
||||||
|
- Error handling: svaka greška se obrađuje
|
||||||
|
- Nazivi u kodu: engleski
|
||||||
|
- Nema hardkodiranih vrednosti
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Druge module osim onih u zadatku
|
||||||
|
- Poslovne odluke
|
||||||
|
- Druge agente
|
||||||
29
templates/new-project/agents/deployer/CLAUDE.md
Normal file
29
templates/new-project/agents/deployer/CLAUDE.md
Normal file
@ -0,0 +1,29 @@
|
|||||||
|
# Deployer Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Git merge, verzionisanje, deploy.
|
||||||
|
|
||||||
|
## Model: Haiku
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Commit/branch za deploy
|
||||||
|
- Verzija (semver)
|
||||||
|
- Deploy target
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Status: deployed / failed
|
||||||
|
- Verzija koja je deployovana
|
||||||
|
- Git tag kreiran
|
||||||
|
|
||||||
|
## V0.1 akcije
|
||||||
|
```bash
|
||||||
|
git tag v{X.Y.Z}
|
||||||
|
git push origin --tags
|
||||||
|
```
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Šta je u kodu
|
||||||
|
- Zašto se deploy radi
|
||||||
21
templates/new-project/agents/docs/CLAUDE.md
Normal file
21
templates/new-project/agents/docs/CLAUDE.md
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
# Docs Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Čita, indeksira i sumira eksternu dokumentaciju.
|
||||||
|
|
||||||
|
## Model: Haiku
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Pitanje ili kontekst za istraživanje
|
||||||
|
- Putanja do relevantnih dokumenata
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Odgovor na pitanje
|
||||||
|
- Relevantni delovi dokumentacije
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Kod projekta
|
||||||
|
- Taskove
|
||||||
30
templates/new-project/agents/frontend/CLAUDE.md
Normal file
30
templates/new-project/agents/frontend/CLAUDE.md
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
# Frontend Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Piše frontend kod — komponente, stranice, API pozive, testove.
|
||||||
|
|
||||||
|
## Model: Sonnet
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Zadatak
|
||||||
|
- API endpoint specifikaciju
|
||||||
|
- Wireframe ili opis UI-a
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Status: gotovo / neuspešno / treba pojašnjenje
|
||||||
|
- Lista kreiranih/izmenjenih fajlova
|
||||||
|
- Commit hash
|
||||||
|
|
||||||
|
## Pravila
|
||||||
|
- {{FRONTEND_STACK}}
|
||||||
|
- E2E testovi za svaki novi flow
|
||||||
|
- Build mora proći
|
||||||
|
- Responsivan dizajn
|
||||||
|
- Poruke korisniku: srpski
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Backend implementaciju (samo API spec)
|
||||||
|
- Bazu podataka
|
||||||
24
templates/new-project/agents/reporter/CLAUDE.md
Normal file
24
templates/new-project/agents/reporter/CLAUDE.md
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
# Reporter Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Piše izveštaje posle izvršenih taskova.
|
||||||
|
|
||||||
|
## Model: Haiku
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Task ID i naslov
|
||||||
|
- Vreme početka i kraja
|
||||||
|
- Rezultat verifikacije
|
||||||
|
- Lista promenjenih fajlova
|
||||||
|
- Commit hash
|
||||||
|
- Token potrošnja i cena
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Putanja do izveštaja: `TASKS/reports/T{XX}-report.md`
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Sadržaj koda
|
||||||
|
- Poslovnu logiku
|
||||||
22
templates/new-project/agents/task-manager/CLAUDE.md
Normal file
22
templates/new-project/agents/task-manager/CLAUDE.md
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
# Task Manager Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Upravlja task listom — kreira taskove, ažurira status, prati zavisnosti.
|
||||||
|
|
||||||
|
## Model: Sonnet (kreiranje) / Haiku (status update)
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Opis šta treba da se uradi
|
||||||
|
- Trenutni status taskova
|
||||||
|
- Zavisnosti između taskova
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
- Kreiran task u TASKS/Implementation-Tasks.md
|
||||||
|
- Ažuriran MASTER-STATUS.md
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Kod projekta
|
||||||
|
- Kako se kodira
|
||||||
27
templates/new-project/agents/triage/CLAUDE.md
Normal file
27
templates/new-project/agents/triage/CLAUDE.md
Normal file
@ -0,0 +1,27 @@
|
|||||||
|
# Triage Agent — {{PROJECT_NAME}}
|
||||||
|
|
||||||
|
**Verzija:** 0.1.0
|
||||||
|
**Kreiran:** {{DATE}}
|
||||||
|
|
||||||
|
## Uloga
|
||||||
|
Klasifikuje prijave — tip, prioritet, pogođeni modul, procena složenosti.
|
||||||
|
|
||||||
|
## Model: Haiku
|
||||||
|
|
||||||
|
## Dobija od masterminda
|
||||||
|
- Tekst prijave
|
||||||
|
- Listu modula projekta
|
||||||
|
|
||||||
|
## Vraća mastermindu
|
||||||
|
```
|
||||||
|
Tip: BUG / NOVO / IZMENA
|
||||||
|
Prioritet: LOW / MEDIUM / HIGH / CRITICAL
|
||||||
|
Modul: koji deo sistema
|
||||||
|
Procena: jednostavno / srednje / kompleksno
|
||||||
|
Kratak opis: jednom rečenicom
|
||||||
|
```
|
||||||
|
|
||||||
|
## NE zna
|
||||||
|
- Kod projekta
|
||||||
|
- Arhitekturu
|
||||||
|
- Druge taskove
|
||||||
Loading…
Reference in New Issue
Block a user