Краткий справочник терминов, используемых в этом руководстве, а также ответы на частые вопросы.
Глоссарий и FAQ
Глоссарий
| Термин | Определение |
|---|---|
| Agent | ИИ-"исполнитель", выполняющий один шаг Pipeline и настроенный на конкретного провайдера и модель. См. Settings. |
| Archive | Доступная для поиска запись обо всех выполненных Task с полными сведениями о результате. Архивную Task можно вернуть в очередь кнопкой Restore. См. Просмотр результатов и Archive. |
| Auto-merge | Параметр Task autoMergeDev, который автоматически сливает завершённую и протестированную Task в dev. См. Создание Task. |
| Branch / Worktree | Изолированная ветка Git и отдельная рабочая папка, создаваемые для каждой Task, чтобы она не могла повлиять на остальную работу. См. Pipeline. |
| Brainstorm | Панель для открытого исследования и планирования с ИИ без редактирования кода. См. Brainstorm. |
| Chat | Панель беседы для каждого проекта, предназначенная для быстрых вопросов и обсуждения с учётом контрактов. См. Chat. |
| Contract | Сохранённая справка, описывающая, как ведёт себя определённая часть проекта; поддерживается в актуальном состоянии автоматически. См. Обмен знаниями. |
| Dashboard | Главное рабочее представление AITM, показывающее вкладки проектов, карточки и очередь Task. |
| Dev Panel (AITM Dev Panel) | Внедряемая JS-панель инструментов (aitm-dev-panel.js), предоставляемая сервером AITM: накладывается на помеченные элементы интерфейса, показывает живой счётчик событий и инспектор и передаёт обратно в AITM данные о взаимодействиях с DOM, чтобы он мог строить и поддерживать карту элементов DOM проекта. См. Карта DOM + Dev Panel. |
| dev branch | Ветка по умолчанию / интеграционная ветка, в которую сливается каждая Task Pipeline. См. Слияние, исправления после слияния и Scope Gate. |
| DOM Explorer | Реестр реальных элементов интерфейса проекта и того, что чем запускается, для проектов с фронтендом. См. Variable Explorer и IntelliSense. |
| E2E (End-to-End) | Автоматические тесты, проверяющие реальное работающее приложение в браузере так, как это делал бы пользователь. См. Тестирование. |
| Hint | Короткое повторно используемое правило, которое ИИ автоматически применяет в последующих Task, без необходимости повторять его. См. Обмен знаниями. |
| Integration branch (defaultBranch) | Настройка проекта, указывающая, в какую ветку сливаются его Task (по умолчанию dev); редактируется в настройках проекта с проверкой "Verify remote". См. Слияние, исправления после слияния и Scope Gate. |
| Knowledge Graph | Взаимосвязанная карта переменных, контрактов, элементов интерфейса и документации проекта. См. Обмен знаниями. |
| License slot | Слот проекта: лицензия определяет, сколькими проектами может управлять AITM. Он не ограничивает, сколько Task выполняется одновременно — для этого служит отдельная настройка Pipeline Max concurrently running tasks. См. Лицензирование и слоты проектов. |
| Lite mode | Параметр Task, пропускающий шаг планирования Architect, когда модель для написания кода достаточно сильна. См. Создание Task. |
| main branch | Стабильная релизная ветка, обновляемая только слиянием dev → main в момент релиза. См. Слияние, исправления после слияния и Scope Gate. |
| Merge Queue | Механизм, который выстраивает слияния в dev по одному и пытается автоматически разрешать конфликты. См. Pipeline. |
| Pipeline | Автоматическая последовательность из 12 шагов (branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit), превращающая prompt Task в готовое изменение, которое затем Merge queue сливает в dev. См. Pipeline. |
| Priority (приоритет) | Подсказка о позиции Task в очереди: low, medium или high. См. Создание Task. |
| Project (проект) | Кодовая база, подключённая к AITM, для которой можно создавать Task. См. Обзор и начало работы. |
| Provider (провайдер) | Базовый ИИ-сервис (Claude, Gemini, OpenAI, DeepSeek, NVIDIA, Ollama), выполняющий шаг Pipeline. См. Settings. |
| Status (статус Task) | Текущее состояние Task: pending, running, awaiting_input, waiting, finished, failed, stopped, conflict или archived. awaiting_input означает, что ИИ ожидает ответа или одобрения пользователя; waiting означает, что Task ожидает исправления багов, найденных E2E-тестированием. См. Создание Task. |
| Task | Отдельная единица порученной работы, проходящая через Pipeline. См. Создание Task. |
| Turn (ход) | Примерно один шаг размышления/действия ИИ-агента (например, чтение или редактирование файла). См. Settings. |
| Verdict (вердикт) | Результат шага тестирования — пройдено/провалено (или более подробный), в первую очередь вердикты E2E. См. Просмотр результатов и Archive. |
| Watchdog | Фоновый процесс, обнаруживающий зависшие шаги Pipeline и автоматически их возобновляющий. См. Pipeline. |
FAQ
Что происходит, если Task завершается сбоем?
Pipeline останавливается на шаге, где произошёл сбой, статус Task становится failed, а причина записывается. Как правило, после выяснения того, что пошло не так, её можно возобновить с этого шага (или с более раннего) — см. Просмотр результатов и Archive.
Можно ли выполнять несколько Task одновременно?
Да, в разных проектах. Внутри одного проекта Task выполняются по одной, чтобы две Task не боролись за одну и ту же ветку; разные проекты работают полностью параллельно.
Отправляет ли AITM когда-либо что-либо самостоятельно в удалённую или производственную ветку?
Нет. Auto-merge сливает только в локальную ветку dev. Отправка куда-либо дальше всегда является преднамеренным отдельным действием, которое выполняется самостоятельно.
Что делать, если ИИ застревает посреди Task?
Watchdog замечает зависший шаг и автоматически возобновляет Pipeline, ограниченное число попыток. Если восстановиться всё равно не удаётся, Task помечается как failed с сохранением причины, чтобы можно было решить, что делать дальше. См. Pipeline.
Где хранятся данные?
Локально, в сочетании баз данных проектов, папок Task и автоматически создаваемой документации. Полная карта приведена в разделе Какие данные хранит AITM.
Нужно ли писать идеальные prompt?
Нет, но более конкретные prompt требуют меньше циклов исправления. См. советы по написанию prompt в разделе Создание Task.
В чём разница между Chat, Brainstorm и Task?
Chat и Brainstorm обсуждают и планируют — они никогда не затрагивают код. Task — единственное, что действительно изменяет код, и она всегда проходит весь Pipeline с ревью и тестированием. См. Chat и Brainstorm.
Что означает баннер "License blocked (session-mismatch)"?
Сервер лицензий увидел, что один и тот же ключ одновременно отправляет heartbeat из двух мест — второго экземпляра AITM, клонированной ВМ или восстановленной резервной копии, работающей рядом с оригиналом. Пока блокировка не снята, очередь не принимает Task. Остановите дубликат, затем нажмите Retry в баннере (или Refresh from server в Settings → License). Если уверены, что существует только один экземпляр, блокировка является ложным срабатыванием и может быть снята из того же баннера. См. Лицензирование и слоты проектов.
Почему после слияния Task в заголовке появляется кнопка "Restart"?
AITM слил изменение в собственный код и в режиме по умолчанию manual ожидает действия пользователя перед перезапуском, чтобы не прерывать работающую очередь. Дайте выполняющимся Task завершиться, затем нажмите Restart в меню заголовка. Для серверов без присмотра задайте для Settings → Git & Storage → Server restart after self-merge значение auto.
Почему Task застряли в статусе pending, хотя ничего не выполняется?
Либо лимит параллелизма равен 0, либо отображается баннер лицензии, либо защита ресурсов удерживает Task, потому что RAM/CPU ниже порога свободных процентов. Проверьте строку состояния (RAM/CPU), баннер лицензии и Settings → Pipeline → Max concurrently running tasks. Вкладка Queued панели Monitor показывает, почему ожидает каждое задание.