Skip to main content

Agent Teams Rules

Last Verified: 2026-02-17 | Owner: John

Agent Teams — Pravila korištenja (2026-02-12)

CEO approved. Ova pravila su obavezna za John-a i sve agente.


1. TIER SISTEM — Routing po kompleksnosti

Svaki task ima tier koji određuje način izvršavanja:

Tier Token budget Kad Kako
T1 Solo ~200K Bug fix, config, single file edit, quick research John direktno, nema agenata
T2 Subagent ~440K Focused build, parallel research, file search 1-3 subagenta (sonnet/haiku)
T3 Team ~800K+ Multi-layer feature, audit, QA swarm, cross-domain Agent team sa lead + teammates

Pravilo: MC task MORA imati tier oznaku (T1/T2/T3) prije starta. Default: T1 Solo. Eskalacija na T2/T3 samo kad task zahtijeva.


2. PLAN-FIRST GATE — Obavezno za T2 i T3

T1: Task → GOTCHA → Build (direktno)
T2: Task → GOTCHA → Plan (~10K) → Build (~400K)
T3: Task → GOTCHA → Plan (~10K) → CEO approve → Build (~800K+)

T3 UVIJEK zahtijeva CEO approval prije builda. Plan je jeftin (~10K tokena). Rework je skup (~500K+). Bolje 10 minuta planiranja nego 1 sat ponovnog rada.


3. DELEGATE MODE — Lead ne implementira

Kad John koristi T3 Agent Team:

  • John SAMO kreira taskove, spawnuje agente, reviewira output
  • John NE piše kod, NE edituje fajlove unutar team scope-a
  • Agenti implementiraju, John orkestrira

Zašto: Lead kontekst je skup (opus). Implementacija troši kontekst bez potrebe. Lead koji implementira = skuplji agent koji radi isti posao.


4. FILE OWNERSHIP — Nema konflikata

Svaki agent task MORA definisati koje fajlove smije dirati:

## Task za Agent X
Files (WRITE): src/api/auth.js, src/api/auth.test.js
Files (READ): src/config.js, src/db.js

Pravilo: Dva agenta NIKAD ne pišu u isti fajl. Ako dva taska trebaju isti fajl — sekvencijalno, ne paralelno.


5. TASK GRANULARNOST — 5-6 units per agent

Svaki agent dobija 5-6 self-contained task units:

  • Svaki unit ima jasan deliverable (fajl, output, report)
  • Svaki unit je testabilan nezavisno
  • Prevelik task = agent luta. Premali = overhead koordinacije

Anti-pattern: "Napravi cijeli backend" (preveliko) Dobro: "Napravi auth API: register, login, logout, me endpoint. Fajlovi: src/api/auth.js + test."


6. MODEL BUDGET — Strogo

Uloga Model Razlog
Lead (John) opus Orkestracija, planning, CEO interakcija
Builder agent sonnet Implementacija — dobar balans kvalitet/cijena
Validator agent sonnet Verifikacija — treba razumjeti kod
Research/search haiku Trivijalno — ne treba duboko razumijevanje

NIKAD opus za agente. NIKAD haiku za build.


7. CONTEXT U SPAWN PROMPTU

Agenti NE nasljeđuju lead-ov conversation history. Zato:

  • Svaki spawn prompt MORA sadržavati task-specific kontekst
  • Referencuj konkretne fajlove, ne "pogledaj projekt"
  • Uključi acceptance criteria u prompt

Loše: "Fixaj bug u API-ju" Dobro: "Fix auth token expiry bug u src/api/auth.js:45. Token se ne refresha nakon 1h. Acceptance: test src/api/auth.test.js prolazi, token refresh radi na 59min."


8. GRACEFUL SHUTDOWN

Svaki team MORA završiti čisto:

  1. Lead šalje shutdown_request svakom agentu
  2. Agent odgovara shutdown_response
  3. Lead poziva TeamDelete

Nikad ne ostavljaj zombie agente.


9. DECISION TREE — Kad šta koristiti

Pitanje: Trebaju li agenti međusobno komunicirati?
├── NE → Subagenti (T2) — jeftinije, dovoljno
└── DA → Agent Team (T3) — skuplje, ali potrebno

Pitanje: Može li se uraditi u jednom fajlu / jednom koraku?
├── DA → Solo (T1) — ne troši na agente
└── NE → T2 ili T3

Pitanje: Treba li CEO approval?
├── DA (build od spec-a, >800K tokena, deploy) → T3 + Plan-First
└── NE (research, fix, maintenance) → T1 ili T2

10. MJERENJE USPJEHA

Svaki T3 team session MORA logirati:

  • Ukupni tokeni potrošeni
  • Broj agenata
  • Trajanje
  • Output kvalitet (PASS/FAIL po acceptance criteria)

Log u HiveMind: hivemind.js post john metrics "T3 team: X agents, Y tokens, Z min, PASS/FAIL"

Ovo gradi dataset za optimizaciju budućih team sessija.


Primjeri iz prakse

SENTINEL audit (T3): 5 agenata, ~540K tokena, 6.8/10 score — PASS alai.no update (T1): Solo, ~30K tokena, 8 edita — PASS SLA loop fix (T1): Solo, ~20K tokena, 4 fajla — PASS Shell injection fix (T1): Solo, ~25K tokena, 4 fajla — PASS

Lekcija: Većina posla je T1. Timovi samo za kompleksno.