# 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/)
```bash
# 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
```bash
# 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)
```bash
# 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