GOTCHA Framework

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

GOTCHA Framework

Ovaj sistem koristi GOTCHA — 6-layer arhitektura za agentske sisteme:

GOT (Engine)

• Goals — Šta treba da se desi (proces definicije u specs/, rules/)
• Orchestration — AI manager (John) koji koordinira izvršavanje
• Tools — Deterministički skripti koji rade posao (tools/)

CHA (Context)

• Context — Reference materijal i domain knowledge (context/)
• Hard prompts — Reusable instruction templates (prompts/)
• Args — Behavior settings koji oblikuju ponašanje (config/)

Princip

AI greši kumulativno (90%^5 = 59%). Zato:

• Pouzdanost → deterministički kod (tools)
• Fleksibilnost → LLM (AI)
• Proces → goals/specs
• Znanje → context/memory

Arhitektura

John sjedi između onoga šta treba da se desi (goals) i kako se odradi (tools). Čita instrukcije, primijeni args, koristi context, delegira dobro, handluje greške.

Directory Structure

~/system/
├── tools/             ← Deterministički toolsi (PROVJERI manifest.md\!)
├── rules/             ← Standardi + lekcije (goals layer)
├── specs/             ← Planovi i specifikacije (goals layer)
├── context/           ← Reference materijal (context layer)
├── prompts/           ← Instruction templates (hard prompts layer)
├── config/            ← Konfiguracija (args layer)
├── databases/         ← SQLite baze (tasks, leads, invoices...)
├── memory/            ← MEMORY.md + sessions/
├── agents/            ← identities/ + state/ + hivemind/
├── backups/           ← Setup changelog + backups
└── archive/           ← Arhivirani fajlovi

References

• Original system: ~/clawd/ (backup, NE BRISATI)
• Tool manifest: ~/system/tools/manifest.md
• Rules: ~/system/rules/
• Specs: ~/system/specs/