zmena na MarkDown subor

This commit is contained in:
2026-03-05 00:39:35 +01:00
parent dc463b5923
commit 96c4ce1697

178
doc/napad.md Normal file
View File

@ -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.