Tool-First Protocol

Tool-First Protocol 
 OBAVEZNO za SVE agente. Prije nego tražiš na internetu ili pišeš novo — provjeri šta već imamo. 
 
 Redoslijed (UVIJEK ovim redom) 
 1. NAŠI ALATI (~/system/tools/) 
 # Provjeri manifest — postoji li tool za ovo?
cat ~/system/tools/manifest.md
 
 Ako tool postoji → KORISTI GA. Ne piši novi. 
 2. NAŠI SKILLOVI (~/.claude/commands/) 
 /plan-with-team — plan sa builder/validator timom
/build-plan — izvrši odobren plan
/code-review — sistematski code review
/debugging — sistematsko debugiranje
/security-audit — security pregled
 
 Ako skill pokriva tvoj zadatak → KORISTI GA. 
 3. NAŠA BAZA ZNANJA 
 # HiveMind — jesmo li ovo već radili?
node ~/system/agents/hivemind/hivemind.js query "<keyword>"

# Prošle sesije — je li neko već rješavao ovo?
bash ~/system/tools/session-search.sh keyword "<keyword>"

# Kontekst dokumentacija
ls ~/system/context/docs/

# Pravila
ls ~/system/rules/

# Specifikacije
ls ~/system/specs/
 
 4. INTERNET (tek ako 1-3 ne daju odgovor) 
 Ako ništa od gore ne pokriva tvoj problem — ONDA pretražuj internet.
Ali OBAVEZNO dokumentiraj šta si naučio (vidi Korak 5). 
 5. AŽURIRAJ BAZU (nakon svakog značajnog saznanja) 
 # Novo saznanje → HiveMind
node ~/system/agents/hivemind/hivemind.js post <agent> knowledge "<šta si naučio>"

# Nova greška → HiveMind
node ~/system/agents/hivemind/hivemind.js post <agent> bugfix "<bug + fix + prevencija>"

# Novi pattern → HiveMind
node ~/system/agents/hivemind/hivemind.js post <agent> pattern "<pattern + kad koristiti>"

# Ako je toliko važno da treba u rules/ → predloži update
 
 
 Primjeri 
 LOŠE (preskaču naše alate): 
 ❌ "Let me search the web for how to send email in Node.js"
 → IMAMO email.js! Provjeri manifest.

❌ "I'll write a function to track tasks"
 → IMAMO mc.js! Provjeri manifest.

❌ "Let me create a new database utility"
 → IMAMO hivemind.js, invoice-generator.js, etc! Provjeri manifest.
 
 DOBRO (koriste naše alate): 
 ✅ "Let me check manifest.md... We have email.js, using that."
✅ "Checking HiveMind for past solutions... Found: [result]"
✅ "No existing tool for this. Searching web... Found solution. Logging to HiveMind."
 
 
 Za Buildere i Validatore 
 Builder — prije implementacije: 
 
 cat ~/system/tools/manifest.md — postoji li tool? 
 node ~/system/agents/hivemind/hivemind.js query "<task-keyword>" — imamo li iskustvo? 
 Ako ne → implementiraj, ali na kraju postaj saznanje na HiveMind 
 
 Validator — provjeri da je builder slijedio protokol: 
 
 Je li builder provjerio manifest prije pisanja novog koda? 
 Je li koristio postojeće alate gdje je moguće? 
 Je li ažurirao HiveMind sa novim saznanjima? 
 
 
 Zašto 
 
 Izbjegavamo duplikate — ne pišemo tool koji već postoji 
 Kumulativno znanje — svako saznanje se sprema, sljedeći agent ga koristi 
 Manja cijena — web search košta tokene. Lokalni lookup je besplatan. 
 Manja greška — naši alati su testirani. Novi kod = novi bugovi. 
 Brže — lokalni file read < web search < pisanje novog koda