Rychlá reference pojmů používaných v celé této příručce, plus odpovědi na časté otázky.
Slovník pojmů a FAQ
Slovník pojmů
| Pojem | Definice |
|---|---|
| Agent | AI "pracovník" vykonávající jeden krok pipeline, nakonfigurovaný s konkrétním providerem a modelem. Viz Nastavení. |
| Archive | Prohledávatelný záznam všech dokončených tasků s plným detailem výsledku. Archivovaný task lze tlačítkem Restore vrátit do fronty. Viz Čtení výsledků a archiv. |
| Auto-merge | Volba tasku autoMergeDev, která automaticky sloučí hotový, otestovaný task do dev. Viz Vytvoření tasku. |
| Branch / Worktree | Izolovaná Git větev a samostatná pracovní složka vytvořená pro každý task, aby neovlivnil ostatní práci. Viz Pipeline. |
| Brainstorm | Panel pro otevřené zkoumání a plánování s AI, bez úpravy kódu. Viz Brainstorm. |
| Chat | Konverzační panel vázaný na projekt pro rychlé, na kontrakty navázané dotazy a diskuzi. Viz Chat. |
| Contract (Kontrakt) | Uložený přehled faktů popisující, jak se konkrétní část projektu chová, automaticky udržovaný synchronizovaný. Viz Sdílení znalostí. |
| Dashboard | Hlavní pracovní pohled AITM zobrazující záložky projektů, karty a frontu tasků. |
| Dev Panel (AITM Dev Panel) | Injektovatelný JS toolbar (aitm-dev-panel.js) podávaný AITM serverem, který přes vaše UI vykreslí overlay označených prvků, živý čítač událostí a inspektor a hlásí interakce zpět do AITM, aby udržoval mapu DOM prvků vašeho projektu. Viz Mapa DOM + Dev Panel. |
| dev branch (větev) | Výchozí / integrační větev, do které se slučuje každý pipeline task. Viz Slučování, opravy po merge a scope gate. |
| DOM Explorer | Registr skutečných UI prvků projektu a toho, co co spouští, u projektů s frontendem. Viz Variable Explorer & IntelliSense. |
| E2E (End-to-End) | Automatizované testy, které prověřují skutečnou běžící aplikaci v prohlížeči tak, jak by to udělal uživatel. Viz Testování. |
| Hint | Krátké, znovupoužitelné pravidlo, které AI automaticky aplikuje v budoucích taskách, aniž byste ho museli opakovat. Viz Sdílení znalostí. |
| Integrační větev (defaultBranch) | Nastavení projektu určující, do které větve se slučují jeho tasky (výchozí je dev); editovatelné v nastavení projektu s kontrolou "Ověřit remote". Viz Slučování, opravy po merge a scope gate. |
| Knowledge Graph (Znalostní graf) | Vzájemně propojená mapa proměnných, kontraktů, UI prvků a dokumentace projektu. Viz Sdílení znalostí. |
| Licenční slot | Slot pro projekt: licence určuje, kolik projektů smí AITM spravovat. Neomezuje počet souběžně běžících tasků — ten řídí samostatné nastavení Pipeline Max concurrently running tasks. Viz Licencování a sloty projektů. |
| Lite mode | Volba tasku, která přeskočí plánovací krok Architect, pokud je model pro kódování dost silný. Viz Vytvoření tasku. |
| main branch (větev) | Stabilní release větev, aktualizovaná jen sloučením dev → main v čase vydání. Viz Slučování, opravy po merge a scope gate. |
| Merge Queue | Mechanismus, který serializuje sloučení do dev jedno po druhém a pokouší se o automatické řešení konfliktů. Viz Pipeline. |
| Pipeline | Automatická sekvence 12 kroků (branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit), která z promptu tasku udělá hotovou změnu; tu pak merge queue sloučí do dev. Viz Pipeline. |
| Priority | Náznak pozice tasku ve frontě: low, medium nebo high. Viz Vytvoření tasku. |
| Project (Projekt) | Kódová báze, kterou AITM onboardoval a pro kterou může vytvářet tasky. Viz Přehled a začínáme. |
| Provider | Podkladová AI služba (Claude, Gemini, OpenAI, DeepSeek, NVIDIA, Ollama) provádějící krok pipeline. Viz Nastavení. |
| Stav tasku | Aktuální fáze tasku: pending, running, awaiting_input, waiting, finished, failed, stopped, conflict nebo archived. awaiting_input znamená, že AI čeká na vaši odpověď nebo schválení; waiting znamená, že task čeká na opravu bugů nalezených E2E testy. Viz Vytvoření tasku. |
| Task | Jedna jednotka zadané práce, která prochází pipeline. Viz Vytvoření tasku. |
| Turn (Kolo) | Zhruba jeden krok toho, co AI agent myslí/dělá (např. čtení nebo úprava souboru). Viz Nastavení. |
| Verdict (Verdikt) | Výsledek pass/fail (nebo podrobnější) testovacího kroku, nejvýrazněji verdikty E2E. Viz Čtení výsledků a archiv. |
| Watchdog | Proces na pozadí, který detekuje zaseknuté kroky pipeline a automaticky je obnovuje. Viz Pipeline. |
FAQ
Co se stane, když task selže?
Pipeline se zastaví u selhaného kroku a stav tasku se změní na failed, s uchovaným důvodem. Task obvykle můžete obnovit od tohoto kroku (nebo dřívějšího), jakmile pochopíte, co se pokazilo — viz Čtení výsledků a archiv.
Mohu spustit více tasků najednou?
Ano, napříč různými projekty. V rámci jednoho projektu běží tasky jeden po druhém, aby dva tasky nesoupeřily o stejnou větev; různé projekty běží plně paralelně.
Nasazuje AITM někdy sám do vzdálené nebo produkční větve?
Ne. Auto-merge slučuje pouze do vaší lokální větve dev. Push kamkoliv dál je vždy záměrná, samostatná akce, kterou provádíte vy sami.
Co když se AI uprostřed tasku zasekne?
Watchdog si zaseknutého kroku všimne a automaticky pipeline obnoví, až do omezeného počtu pokusů. Pokud se stále nedokáže zotavit, task je označen jako failed s uchovaným důvodem, abyste se mohli rozhodnout, jak dál. Viz Pipeline.
Kde jsou uložena moje data?
Lokálně, v kombinaci databází pro jednotlivé projekty, složek tasků a automaticky generované dokumentace. Viz Jaká data AITM ukládá pro kompletní mapu.
Musím psát dokonalé prompty?
Ne, ale konkrétnější prompty potřebují méně opravných cyklů. Viz tipy pro psaní promptů v kapitole Vytvoření tasku.
Jaký je rozdíl mezi Chatem, Brainstormem a taskem?
Chat a Brainstorm diskutují a plánují — nikdy se nedotýkají vašeho kódu. Task je jediná věc, která kód skutečně mění, a vždy prochází celou zkontrolovanou, otestovanou pipeline. Viz Chat a Brainstorm.
Co znamená banner „License blocked (session-mismatch)“?
Licenční server viděl stejný klíč hlásit se najednou ze dvou míst — druhou instanci AITM, klonovaný VM, nebo obnovenou zálohu běžící vedle originálu. Dokud se to nevyřeší, fronta nepřijímá žádné tasky. Zastavte duplicitní instanci a poté klikněte na Retry v banneru (nebo Refresh from server v Settings → License). Pokud jste si jistí, že existuje jen jedna instance, je blokace falešně pozitivní a lze ji odemknout ze stejného banneru. Viz Licencování a sloty projektů.
Proč se po sloučení tasku zobrazí v hlavičce tlačítko „Restart“?
AITM sloučil změnu do vlastního kódu a ve výchozím režimu manual čeká, než ho restartujete sami, aby se nepřerušila běžící fronta. Nechte doběhnout běžící tasky a poté klikněte na Restart v menu hlavičky. Pro nehlídané servery nastavte Settings → Git & Storage → Server restart after self-merge na auto.
Proč zůstávají tasky ve stavu pending, i když nic neběží?
Buď je limit souběžnosti nastaven na 0, svítí licenční banner, nebo hlídač zdrojů zadržuje tasky, protože volná RAM/CPU je pod prahovou hodnotou. Zkontrolujte stavový řádek (RAM/CPU), licenční banner a Settings → Pipeline → Max concurrently running tasks. Záložka Queued v Monitor liště ukáže, proč každý task čeká.