Szybki przewodnik po terminach używanych w całym podręczniku oraz odpowiedzi na często zadawane pytania.
Słowniczek i FAQ
Słowniczek
| Termin | Definicja |
|---|---|
| Agent | „Pracownik" AI wykonujący jeden krok Pipeline, skonfigurowany z konkretnym dostawcą i modelem. Zob. Settings. |
| Archive | Przeszukiwalny rejestr każdego ukończonego Task z pełnymi szczegółami wyniku. Zarchiwizowany Task można przywrócić do kolejki przyciskiem Restore. Zob. Odczytywanie wyników i Archive. |
| Auto-merge | Opcja Task autoMergeDev, która automatycznie scala ukończony, przetestowany Task z dev. Zob. Tworzenie Task. |
| Branch / Worktree | Izolowana gałąź Git i osobny folder roboczy tworzone dla każdego Task, aby nie wpływał na inną pracę. Zob. Pipeline. |
| Brainstorm | Panel do otwartej eksploracji i planowania z AI, bez edycji kodu. Zob. Brainstorm. |
| Chat | Panel rozmowy dla każdego projektu, do szybkich pytań i dyskusji uwzględniających Contracts. Zob. Chat. |
| Contract | Zapisana karta faktów opisująca, jak zachowuje się konkretna część projektu, automatycznie utrzymywana w synchronizacji. Zob. Knowledge Sharing. |
| Dashboard | Główny widok obszaru roboczego AITM, pokazujący karty projektów, karty i kolejkę Tasks. |
| Dev Panel (AITM Dev Panel) | Wstrzykiwany pasek narzędzi JS (aitm-dev-panel.js) serwowany przez serwer AITM, który nakłada oznaczenia na otagowane elementy UI, pokazuje licznik zdarzeń na żywo i inspektor oraz raportuje interakcje z DOM z powrotem do AITM, aby ten mógł budować i utrzymywać mapę elementów DOM projektu. Zob. DOM map + Dev Panel. |
| gałąź dev | Domyślna / integracyjna gałąź, do której scalany jest każdy Task Pipeline. Zob. Scalanie, poprawki po scaleniu i Scope Gate. |
| DOM Explorer | Rejestr rzeczywistych elementów UI projektu i tego, co co wyzwala, dla projektów z frontendem. Zob. Variable Explorer i IntelliSense. |
| E2E (End-to-End) | Automatyczne testy obciążające rzeczywiście działającą aplikację w przeglądarce, tak jak robiłby to użytkownik. Zob. Testowanie. |
| Hint | Krótka, wielokrotnego użytku reguła, którą AI stosuje automatycznie w przyszłych Tasks, bez powtarzania jej. Zob. Knowledge Sharing. |
| Integration branch (defaultBranch) | Ustawienie dla projektu wskazujące, do której gałęzi scalane są Tasks projektu (domyślnie dev); edytowalne w ustawieniach projektu z kontrolą „Verify remote". Zob. Scalanie, poprawki po scaleniu i Scope Gate. |
| Knowledge Graph | Wzajemnie powiązana mapa zmiennych, Contracts, elementów UI i dokumentacji projektu (graf wiedzy). Zob. Knowledge Sharing. |
| Slot licencji | Slot projektu: licencja określa, ilu projektami AITM może zarządzać. Nie ogranicza liczby jednocześnie uruchomionych Tasks — służy do tego osobne ustawienie Pipeline Max concurrently running tasks. Zob. Licencjonowanie i sloty projektów. |
| Lite mode | Opcja Task, która pomija krok planowania Architect, gdy model kodujący jest wystarczająco silny. Zob. Tworzenie Task. |
| gałąź main | Stabilna gałąź wydań, aktualizowana tylko scaleniem dev → main w momencie wydania. Zob. Scalanie, poprawki po scaleniu i Scope Gate. |
| Merge queue | Mechanizm szeregujący scalenia do dev jedno po drugim i próbujący automatycznie rozwiązywać konflikty. Zob. Pipeline. |
| Pipeline | Automatyczna sekwencja 12 kroków (branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit), która zamienia prompt Task w gotową zmianę, scalaną następnie przez Merge queue z dev. Zob. Pipeline. |
| Priorytet | Wskazówka pozycji Task w kolejce: low, medium lub high. Zob. Tworzenie Task. |
| Projekt | Baza kodu, do której AITM został wdrożony i dla której może tworzyć Tasks. Zob. Przegląd i pierwsze kroki. |
| Dostawca | Bazowa usługa AI (Claude, Gemini, OpenAI, DeepSeek, NVIDIA, Ollama) wykonująca krok Pipeline. Zob. Settings. |
| Status (Task) | Bieżący stan Task: pending, running, awaiting_input, waiting, finished, failed, stopped, conflict lub archived. awaiting_input oznacza, że AI czeka na odpowiedź lub zatwierdzenie; waiting oznacza, że Task czeka na poprawki błędów znalezionych przez testy E2E. Zob. Tworzenie Task. |
| Task | Pojedyncza jednostka przydzielonej pracy, przechodząca przez Pipeline. Zob. Tworzenie Task. |
| Tura | Z grubsza jeden krok myślenia/działania Agent AI (np. odczyt lub edycja pliku). Zob. Settings. |
| Werdykt | Wynik pass/fail (lub bardziej szczegółowy) kroku testowego, przede wszystkim werdykty E2E. Zob. Odczytywanie wyników i Archive. |
| Watchdog | Proces w tle, który wykrywa zawieszone kroki Pipeline i automatycznie je wznawia. Zob. Pipeline. |
FAQ
Co się dzieje, gdy Task zawiedzie?
Pipeline zatrzymuje się na nieudanym kroku, a status Task zmienia się na failed, z zapisaną przyczyną. Zwykle można go wznowić od tego kroku (lub wcześniejszego), gdy już wiadomo, co poszło nie tak — zob. Odczytywanie wyników i Archive.
Czy można uruchomić wiele Tasks naraz?
Tak, w różnych projektach. W obrębie jednego projektu Tasks działają pojedynczo, aby dwa Tasks nie walczyły o tę samą gałąź; różne projekty działają w pełni równolegle.
Czy AITM kiedykolwiek sam wypycha zmiany do zdalnej lub produkcyjnej gałęzi?
Nie. Auto-merge scala tylko do lokalnej gałęzi dev. Wypychanie gdziekolwiek dalej jest zawsze świadomym, osobnym działaniem wykonywanym samodzielnie.
Co jeśli AI utknie w trakcie Task?
Watchdog zauważa zawieszony krok i automatycznie wznawia Pipeline, do ograniczonej liczby prób. Jeśli nadal nie uda się go odzyskać, Task zostaje oznaczony jako failed z zachowaną przyczyną, aby można było zdecydować, co dalej. Zob. Pipeline.
Gdzie przechowywane są moje dane?
Lokalnie, w połączeniu baz danych projektów, folderów Tasks i automatycznie generowanej dokumentacji. Pełną mapę zawiera Jakie dane przechowuje AITM.
Czy trzeba pisać idealne prompty?
Nie, ale bardziej szczegółowe prompty wymagają mniej cykli poprawek. Wskazówki dotyczące pisania promptów znajdują się w Tworzenie Task.
Jaka jest różnica między Chat, Brainstorm i Task?
Chat i Brainstorm służą do dyskusji i planowania — nigdy nie dotykają kodu. Task jest jedyną rzeczą, która faktycznie zmienia kod, i zawsze przechodzi przez pełny Pipeline z review i testami. Zob. Chat i Brainstorm.
Co oznacza baner „License blocked (session-mismatch)"?
Serwer licencji zobaczył ten sam klucz wysyłający heartbeat z dwóch miejsc jednocześnie — druga instancja AITM, sklonowana maszyna wirtualna lub przywrócona kopia zapasowa działająca obok oryginału. Dopóki blokada nie zniknie, kolejka nie przyjmuje żadnych Tasks. Należy zatrzymać zduplikowaną instancję, a następnie kliknąć Retry na banerze (lub Refresh from server w Settings → License). Jeśli ma się pewność, że istnieje tylko jedna instancja, blokada jest fałszywym alarmem i można ją odblokować z tego samego banera. Zob. Licencjonowanie i sloty projektów.
Dlaczego po scaleniu Task w nagłówku pojawia się przycisk „Restart"?
AITM scalił zmianę we własnym kodzie i w domyślnym trybie manual czeka na użytkownika przed restartem, aby nie przerywać działającej kolejki. Należy poczekać na zakończenie uruchomionych Tasks, a następnie kliknąć Restart w menu nagłówka. Dla serwerów bez nadzoru można ustawić Settings → Git & Storage → Server restart after self-merge na auto.
Dlaczego Tasks tkwią w pending, choć nic nie działa?
Albo limit współbieżności wynosi 0, albo wyświetlony jest baner licencji, albo strażnik zasobów wstrzymuje Tasks, ponieważ RAM/CPU jest poniżej progu wolnego procentu. Należy sprawdzić pasek stanu (RAM/CPU), baner licencji oraz Settings → Pipeline → Max concurrently running tasks. Karta Queued paska Monitor pokazuje, dlaczego każde zadanie czeka.