AIF Handoff: autonomní agent pro vývoj kódu

# Autonomní agent pro vývoj: jak AIF Handoff nahrazuje manuální workflow

Vytvoril si úlohu v rozhraní, zatvoril notebook – o niekoľko minút príde notifikácia v Telegrame o hotovom PR. To nie je fantázia, ale realita, ktorú zabezpečuje AIF Handoff: systém autonómnych agentov postavený na AI Factory a pracujúci s akýmikoľvek LLM nástrojmi ako Claude Code alebo Cursor. V jadre – riadenie kontextu, iteratívne plánovanie a samoobučovanie na základe patchov.

Prečo klasické „vibe-kódovanie“ sa nescáluje

Väčšina vývojárov prechádza tromi fázami interakcie s LLM:

• Loterícia – jeden prompt, nádej na šťastie. Model generuje pravdepodobný, ale nefunkčný kód, pretože nepozná kontext projektu. Každý požiadavka začína od nuly, bez histórie predchádzajúcich rozhodnutí.
• „Babičine prompty“ – inštrukcie typu „si senior s 15-ročnou praxou“. Menia tón odpovede, ale nie jej kvalitu. Model imituje sebavedomie, nie kompetenciu.
• Manuálny workflow – sám zhromažďuješ kontext: kopíruješ súbory, špecifikuješ obmedzenia, voláš príkazy jeden po druhom. Výsledok je lepší, ale proces zostáva náročný a náchylný na chyby kvôli prehliadnutému kontextu.

Kľúčový postreh: LLM nečíta myšlienky. Pracuje len s tým, čo si jej dal. Čím presnejší a úplnejší kontext – tým predvídateľnejší výsledok. Príklad:

Zle:

Sprav autentifikáciu cez JWT, použi best practices

Dobre:

Tu je AuthService (kód), tu ako sa ukladajú sessiony (kód), tu middleware (kód).
Treba pridať refresh token. Používame Laravel Sanctum, meniť sa nedá.
Tu je test, ktorý musí prejsť.

V druhom prípade je priestor pre fantáziu modelu minimalizovaný. Úspech sa meria konkrétnymi kritériami, nie abstraktnými „best practices“.

Ako AI Factory systematizuje kontext

AI Factory – to je CLI nástroj a ekosystém skillov, ktorý automaticky riadi kontext pre akéhokoľvek kódovacieho agenta. Po inštalácii (npm install -g ai-factory && ai-factory init) systém naskenuje projekt, určí stack a vytvorí štruktúru:

your-project/
├── .claude/
│   └── skills/           ← markdown súbory s inštrukciami pre agenta
├── .ai-factory/
│   ├── DESCRIPTION.md    ← popis projektu, stack, architektúra
│   ├── PLAN.md           ← aktuálny plán
│   ├── patches/          ← patchy samoobučovania
│   └── evolutions/       ← logy evolúcií skillov
└── .ai-factory.json

Skilly – to nie sú všeobecné odporúčania, ale konkrétne inštrukcie: „ako presne zostavovať plán v tomto projekte“, „ktoré súbory meniť pri zmene autentifikácie“. Hlavné príkazy:

• /aif – inicializácia kontextu sessiony
• /aif-plan – vytvorenie plánu a git vetvy
• /aif-implement – vykonanie úloh s commitmi po checkpointoch
• /aif-fix – oprava bugu + vytvorenie patchy samoobučovania
• /aif-evolve – analýza patchov a aktualizácia skillov
• /aif-verify – overenie zhody výsledku s plánom

Samoobučovanie prebieha neustále: každý /aif-fix ukladá patch a /aif-evolve nachádza v nich vzory a adaptuje skilly. Agent pred každým /aif-implement prečíta všetky nahromadené patchy – systém sa učí aj bez explicitného volania evolve.

AIF Handoff: človek na slučke, nie v slučke

AI Factory rieši problém kontextu, ale stále vyžaduje manuálne spúšťanie príkazov. AIF Handoff odstraňuje túto poslednú bariéru – je to webová aplikácia s Kanban doskou, ktorá plne automatizuje agentný pipeline:

Backlog → Planning → Plan Ready → Implementing → Review → Done

Vytvoríš úlohu v UI – systém sám ju posúva po stavoch cez WebSocket. Dovnútra pracujú špecializovaní koordinátori:

• plan-coordinator – nielen generuje plán, ale iteratívne ho leští cez plan-polisher, kým nesplní kritériá kvality.
• implement-coordinator – analyzuje závislosti medzi úlohami a spúšťa paralelné workery v oddelených git worktree tam, kde je to bezpečné.
• review-sidecar + security-sidecar – paralelne kontrolujú kód na zhodu s plánom a zraniteľnosti (XSS, SQL-injekcie, úniky dát). Pri prítomnosti MCP Playwright – vykonávajú browserové testy.

Ak review nájde problémy, úloha sa automaticky vráti na úpravu – ale s tvrdým limitom iterácií, aby nespálil celý tokenový rozpočet za noc.

Human-on-the-loop ≠ Human-in-the-loop

• Human-in-the-loop: zúčastňuješ sa na každom prechode. Maximálna kontrola, minimálna rýchlosť.
• Human-on-the-loop: zadáš úlohu a kritériá – systém pracuje autonómne. Ty schváliš alebo zamietneš finálny výsledok. Presne tak funguje Handoff.

Dva režimy vykonávania:

• Subagents (predvolený) – úplný pipeline s iteratívnym upresňovaním, paralelnými workermi a quality sidecars. Vyššia kvalita, vyššia cena.
• Skills – jednopriechodové vykonanie cez základné príkazy AI Factory. Rýchlejšie a lacnejšie, vhodné pre jednoduché úlohy.

Inštalácia a obojsmerná synchronizácia

Spustenie Handoff:

git clone https://github.com/lee-to/aif-handoff
cd aif-handoff
npm install
npm run init
npm run dev

Alebo cez Docker (odporúča sa):

docker compose up

Systém spustí tri služby: API (Hono + WebSocket), Web (React UI) a Agent (koordinátor). Pri prvom spustení je potrebná OAuth autorizácia v Claude Code. Nastavenia – v .env:

AI_LANGUAGE=ru                  # jazyk agentov
MAX_REVIEW_ITERATIONS=3         # limit iterácií review
AGENT_USE_SUBAGENTS=true        # režim vykonávania
TELEGRAM_BOT_TOKEN=...          # pre notifikácie
TELEGRAM_CHAT_ID=...

Handoff a AI Factory sa synchronizujú obojsmerne cez MCP. Začal si úlohu v Handoff, rozhodol si pokračovať v Claude Code priamo – zmeny sa automaticky odrazia na Kanban doske. Akýkoľvek kompatibilný agent sa môže pripojiť cez MCP.

Rozdiel od Paperclip a ďalšie špecifiká

Paperclip – nástroj na orchestráciu agentov v marketingu, obsahu, SEO. Pracuje s textom a informačnými tokmi. AIF Handoff je stvorený pre vývoj: pozná tvoj stack, kontroluje kód (nie text), používa git worktree na izoláciu workerov a učí sa na patchoch konkrétneho projektu.

Čo je dôležité:

• Kontext > prompty. Čím konkrétnejšie vstupné dáta – tým stabilnejší výsledok.
• Samoobučovanie cez patchy (/aif-fix → /aif-evolve) – kľúč k adaptácii na projekt.
• Human-on-the-loop umožňuje plne delegovať rutinu, zachovať finálnu kontrolu.
• Paralelné workery a iteratívne review zvyšujú kvalitu, ale vyžadujú limity na úsporu tokenov.
• Obojsmerná synchronizácia umožňuje voľne prepínať medzi Handoff a priamou prácou s agentom.

Technický stack Handoff: Node.js + TypeScript (Turborepo), SQLite (drizzle-orm), Hono API, React + TailwindCSS, node-cron. Projekt je pokrytý testami (>70%), má ESLint guards na ochranu vrstiev. V plánoch – plugin pre JetBrains a integrácia s CI/CD.

— Editorial Team