Skip to main content

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:

  1. cat ~/system/tools/manifest.md — postoji li tool?
  2. node ~/system/agents/hivemind/hivemind.js query "<task-keyword>" — imamo li iskustvo?
  3. 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

  1. Izbjegavamo duplikate — ne pišemo tool koji već postoji
  2. Kumulativno znanje — svako saznanje se sprema, sljedeći agent ga koristi
  3. Manja cijena — web search košta tokene. Lokalni lookup je besplatan.
  4. Manja greška — naši alati su testirani. Novi kod = novi bugovi.
  5. Brže — lokalni file read < web search < pisanje novog koda
Back to top