diff --git a/doc/napad.txt b/doc/napad.txt new file mode 100644 index 0000000..e6f6a58 --- /dev/null +++ b/doc/napad.txt @@ -0,0 +1,178 @@ +zvazujem vytvorit nastroj pre multiagentove pouzivanie llm ako je napriklad codex, bol by to aplikacia v jazyku GO, ovladala by sa webrozhranim, cize by som ju mohol vlozit do virtualky a na hostovacom serveri spravit proxy s HTTP autentifikaciou + +este to nemam cele premyslene, zatial zbieram napady, ze ake funkcie by to malo, ako by sa s tym pracovalo, ake rezimy prace by to umoznovalo + +a tiez aj aky nazov by bol pre taku aplikaciu vhodny? + +----- 2026-03-05 00:35:22 ----------------------------------------------------- + +Jasné — toto je presne ten typ nástroja, kde sa oplatí najprv “pozbierať režimy práce” a až potom riešiť implementačné detaily. Dám ti návrhy funkcií, pracovných režimov, kľúčové UX prvky pre web UI, a nakoniec aj nápady na názov (vrátane doménového/brand štýlu). + +## Ako by sa s tým pracovalo (model používania) + +### 1) “Workflow / Graph” režim (najsilnejší) + +* vizuálne skladanie uzlov (agents/tasks/tools) + väzby medzi nimi +* typy hrán: *posuň výstup ďalej*, *zhrň*, *over*, *rozdeľ na podúlohy*, *hlasovanie* +* každý uzol má: prompt šablónu, pravidlá vstupu/výstupu, limity (čas/token), “guardrails” +* ideálne pre opakovateľné procesy (release notes, refactor, audit, migrácie, dokumentácia) + +### 2) “Supervisor + workers” režim (operatívny) + +* 1 nadriadený agent rozbíja úlohu na kroky, prideľuje workerom +* workers robia izolovane (napr. “reader”, “coder”, “tester”, “reviewer”) +* supervisor sklada výsledok a rieši konflikty +* vhodné na “sprav mi toto v repozitári” + +### 3) “Chat room / swarm” režim (brainstorm) + +* viac agentov v jednej miestnosti +* rôzne osobnosti/role (skeptik, architekt, bezpečák, product) +* výstup môže byť “konsenzus” alebo “alternatívy s tradeoffmi” + +### 4) “Batch / queue” režim (automatizácia) + +* dávkové spúšťanie jobov (napr. cez webhook, cron, ručne) +* každý job má artifacty: logy, diffy, reporty, build výsledky +* “idempotentné” opakovanie + cache na rovnakých vstupoch + +### 5) “Human-in-the-loop” checkpointy (prakticky nutnosť) + +* uzly môžu vyžadovať schválenie: pred zápisom do repo, pred spustením príkazov, pred odoslaním e-mailu, pred mergom +* UI: “Approve / Edit / Rerun / Split into subtasks” + +--- + +## Funkcie, ktoré budú rozhodovať, či je to použiteľné + +### A) Orchestrácia a stav + +* **per-run timeline**: kto čo urobil, s akým promptom, aké vstupy dostal, aké sústavy súborov/patchov sa zmenili +* **replay**: spustiť znovu od konkrétneho uzla (s upravenými parametrami) +* **branching**: alternatívne vetvy riešenia (A/B) + +### B) Kontext a “workspace” + +* **workspace snapshot** (git branch / svn working copy) viazaný na run +* možnosť mať “read-only” režim pre agentov, ktorí len analyzujú +* pre coder agentov: “patch mode” (generuj diff) vs “apply mode” (aplikuj zmeny) + +### C) Nástroje / integrácie (aj keby spočiatku minimal) + +* shell (limitovaný), git/svn, grep/ripgrep, test runner, linter +* viewer pre diff (side-by-side), prehliadač súborov, “jump to symbol” +* import zadania: URL, issue tracker text, paste diffu, súbory + +### D) Bezpečnosť a izolácia (tvoj use-case s VM/proxy je super) + +* “capabilities” per agent: čítanie repo, zápis repo, shell, sieť +* allowlist príkazov alebo wrapper príkazy +* audit log + export (aby si vedel spätne vysvetliť “čo to spravilo”) + +### E) Kvalita výstupu + +* “review agent” ako povinný gate pred finalizáciou +* testovací agent, ktorý vždy spúšťa minimálne sanity check +* “policy” uzol: kontrola tajomstiev (API keys), licencia, bezpečnostné regexy + +--- + +## Web UI, ktoré sa používa dobre + +* ľavý panel: runs (história), workflow templates +* stred: graf / timeline (uzly + stav) +* pravý panel: detail uzla (prompt, vstupy, výstupy, súbory, diff) +* spodok: live log konzol (stream), + “agent consoles” ako taby +* tlačidlá: **Pause / Resume / Step / Rerun node / Fork** + +Plus jedna vec, čo ľudia ocenia: **“diff-first UX”** — ak je cieľ kód, tak výsledok nech je primárne diff + krátke odôvodnenie. + +--- + +## Minimalistický MVP (aby si sa nerozstrieľal) + +Ak by som to osekal na verziu, ktorú vieš reálne používať: + +1. runs + timeline (logy, prompty, výstupy) +2. 3 role: planner, coder (patch), reviewer +3. workspace integrácia pre git/svn +4. web UI: workflow (lineárny) + diff viewer +5. checkpoint pred apply / commit + +Potom pridávať grafy, swarm, batch queue. + +--- + +## Názov aplikácie – návrhy (podľa štýlu) + +### Krátke, technické (dobré pre CLI aj web) + +* **Orchestr** +* **SwarmDock** +* **AgentDeck** +* **FlowForge** +* **TaskMesh** +* **RunGraph** +* **WorkWeaver** +* **PatchPilot** +* **RepoConductor** +* **OpsWeave** + +### Go-čkový vibe (trochu hravejšie) + +* **GopherSwarm** +* **GoConductor** +* **GoMesh** +* **GoFlow** +* **Graft** (graf + draft) +* **Gorchestr** (Go + orchestrator) + +### “Produktové”, znejú ako SaaS + +* **Conductor** +* **Weave** +* **Mesh** +* **Relay** +* **Forge** +* **Draft + Review** (napr. “DraftForge”) + +### Ak chceš meno s jasným významom (čo to robí) + +* **Agent Orchestrator** +* **LLM Control Plane** +* **Multi-Agent Studio** +* **Workflow Pilot** + +--- + +## Rýchly trik na výber názvu (bez filozofovania) + +Vyber si, čo chceš komunikovať ako “hlavnú vec”: + +* ak je to o **grafových workflow** → niečo s *Flow / Graph / Weave / Mesh* +* ak je to o **repo + diffoch** → *Patch / Repo / Commit / Review* +* ak je to o **riadení agentov** → *Conductor / Orchestr / Supervisor* + +Za mňa najviac sedí tvojej predstave: **RepoConductor**, **PatchPilot**, alebo neutrálne **FlowForge**. + +Ak chceš, môžem ti rovno navrhnúť aj: + +* krátky “one-liner” opis (tagline) k vybraným názvom +* štruktúru konfigurácie workflow (YAML/JSON) + ako by vyzeral run log model v Go (structy) + Bez ďalších otázok — len mi povedz, či ťa viac láka “workflow graf” alebo “supervisor+workers” ako primárny režim. + +----- 2026-03-05 00:35:42 ----------------------------------------------------- +Vybral som nazov: Supervisor + +Supervisor is a lightweight multi-agent orchestration tool for LLM workflows. + +It runs multiple AI agents under the control of a central supervisor that plans tasks, +delegates them to worker agents, and evaluates their results. The system provides +a web interface to observe, control, and intervene in agent workflows in real time. + +Designed for development workflows, Supervisor allows agents to analyze code, +generate patches, run tools, review changes, and collaborate on complex tasks +while keeping a human in the loop when needed. + +The core is written in Go and intended to run inside an isolated environment +(such as a VM or container) with secure access through a web interface. \ No newline at end of file