# MAIster

> Public documentation for governed AI software delivery

## EN

### Start here

- [MAIster documentation](https://docs.imaister.dev/markdown/index.md): Understand, configure, and operate MAIster for governed AI software delivery over private repositories.

- [Quickstart](https://docs.imaister.dev/markdown/quickstart.md): Run MAIster locally, sign in, register a repository, and launch a first governed task.

### Product tour

- [Application map](https://docs.imaister.dev/markdown/product-tour/application-map.md): Find the MAIster screens for projects, attention, Runs, Studio, administration, and personal access.

- [Project workspace](https://docs.imaister.dev/markdown/product-tour/project-workspace.md): Understand every project tab and where repository, package, automation, knowledge, and access settings live.

- [Repository and project packages](https://docs.imaister.dev/markdown/product-tour/project-repository-and-packages.md): Browse project source, attach installed packages, and use local package cuts without changing an immutable upstream revision.

- [Kanban board, tasks, and Runs](https://docs.imaister.dev/markdown/product-tour/tasks-and-runs.md): Create work, model dependencies, follow queue and execution state, and inspect each attempt of a task.

- [Run history and Run workspace](https://docs.imaister.dev/markdown/product-tour/run-history-and-workbench.md): Find any execution attempt, read its graph and node results, inspect evidence and files, and understand available actions.

### Core concepts

- [The delivery spine](https://docs.imaister.dev/markdown/concepts/delivery-spine.md): Understand the stable sequence MAIster uses from repository intake to reviewed promotion.

- [Path to agentization](https://docs.imaister.dev/markdown/concepts/path-to-agentization.md): Move from co-work to governed autonomy through Scratch Runs, Flows, Policies, and Platform Agents.

- [Flows, nodes, and Runs](https://docs.imaister.dev/markdown/concepts/flows-and-runs.md): Learn how versioned Flow packages become observable Run attempts with isolated workspaces.

- [Tasks, Runs, and evaluation](https://docs.imaister.dev/markdown/concepts/tasks-runs-and-evaluations.md): Model task dependencies, keep multiple implementation Runs, and compare results with reproducible methods.

- [Recursive Agent Harness (RAH)](https://docs.imaister.dev/markdown/concepts/recursive-agent-harness.md): Coordinate bounded agent and Flow trees through typed results, independent verification, and human review.

- [Evidence, readiness, and review](https://docs.imaister.dev/markdown/concepts/evidence-and-review.md): Use current evidence and explicit human review to decide whether a Run may be promoted.

- [Project Brain, embeddings, and platform agents](https://docs.imaister.dev/markdown/concepts/project-brain-and-agents.md): Index canonical project sources, retain governed lessons, recall context, and turn recurring evidence into reviewed improvements.

### Administration

- [Configure ACP runners and models](https://docs.imaister.dev/markdown/administration/runners-and-models.md): Create host runner profiles, preserve provider authentication, verify readiness, and bind Flow session slots.

- [Users, project access, and API tokens](https://docs.imaister.dev/markdown/administration/users-tokens-and-access.md): Activate accounts, assign global and project roles, and issue scoped personal or project access tokens.

- [MCP servers, bindings, and secrets](https://docs.imaister.dev/markdown/administration/mcp-and-secrets.md): Register MCP servers, resolve package requirements per project, use environment references, and test trust and readiness.

- [Scheduler and platform agents](https://docs.imaister.dev/markdown/administration/scheduler-and-platform-agents.md): Enable the scheduler clock, inspect jobs, attach package-defined agents, and configure manual, cron, event, webhook, Flow, or mention triggers.

- [Project platform agents](https://docs.imaister.dev/markdown/administration/project-platform-agents.md): Author an agent in a package, attach it to a project, and configure its runner, workspace, memory, permissions, and triggers.

- [Scheduler and project automations](https://docs.imaister.dev/markdown/administration/scheduler-and-automations.md): Run the shared clock, schedule task and Flow launches, monitor jobs, and choose the correct trigger surface.

### Flow Studio

- [Flow Studio and package forks](https://docs.imaister.dev/markdown/studio/flow-studio-and-packages.md): Browse sources and installed packages, fork immutable content, edit a local package, use the AI assistant, and publish a cut.

- [AI assistant in Flow Studio](https://docs.imaister.dev/markdown/studio/ai-assistant.md): Open the assistant beside a local Flow, ask about the package, and apply guarded edits without giving the session direct write access.

- [Flow node and gate types](https://docs.imaister.dev/markdown/studio/node-types.md): Choose the correct execution, coordination, validation, and human node for each part of a Flow graph.

- [Structured results and Run context](https://docs.imaister.dev/markdown/studio/structured-results-and-context.md): Validate node output, reuse it through Flow variables, route on values, and distinguish results from evidence.

### Evaluation

- [Compare Runs in Evaluation Lab](https://docs.imaister.dev/markdown/evaluation/run-comparison.md): Launch controlled variants, freeze evidence, apply objective checks and AI judges, and record a human verdict.

### Guides

- [Register a project](https://docs.imaister.dev/markdown/guides/register-a-project.md): Connect an existing local or remote git repository to MAIster without exposing its credentials.

- [Package sources and versions](https://docs.imaister.dev/markdown/guides/package-sources-and-versions.md): Register your own Flow package repository, install tagged versions, trust and attach them, upgrade or roll back per project, and iterate on a local fork.

- [Handle human-in-the-loop requests](https://docs.imaister.dev/markdown/guides/human-in-the-loop.md): Respond to permissions, forms, reviews, and manual takeover requests, watch a live Run, and interrupt a node without losing Run context.

- [Review and promote a Run](https://docs.imaister.dev/markdown/guides/review-and-promote.md): Inspect changes and evidence, request rework when needed, then promote through a pull request or local merge.

- [Review, rework, and human takeover](https://docs.imaister.dev/markdown/guides/review-rework-and-takeover.md): Inspect production artifacts, leave anchored comments, return work to an agent, edit locally, and re-enter Flow validation.

- [Choose a Studio or evaluation workflow](https://docs.imaister.dev/markdown/guides/studio-and-evaluation.md): Find the right workflow for editing a Flow, comparing package lineage, or evaluating execution results.

### Reference

- [Project manifest reference](https://docs.imaister.dev/markdown/reference/project-manifest.md): Configure a repository, promotion policy, Flow bindings, and scoped capabilities in maister.yaml.

- [Flow manifest reference](https://docs.imaister.dev/markdown/reference/flow-manifest.md): Define a versioned graph of agent, command, check, human, and orchestration nodes in flow.yaml.

- [Agent runtimes](https://docs.imaister.dev/markdown/reference/agent-runtimes.md): Configure ACP runner profiles and understand readiness, credentials, and capability scoping.

### Operate

- [Single-host deployment](https://docs.imaister.dev/markdown/operations/deployment.md): Deploy MAIster on a Linux host with systemd, a local execution supervisor, Postgres, and a TLS reverse proxy.

- [Execution hosts](https://docs.imaister.dev/markdown/operations/execution-hosts.md): Understand the current single-host supervisor boundary and the safe path toward multiple execution hosts.

- [Observatory, Run costs, and budgets](https://docs.imaister.dev/markdown/operations/costs-and-budgets.md): Attribute token and time use to tasks, Runs, models, and runners, then set bounded execution policies.

- [Troubleshooting](https://docs.imaister.dev/markdown/operations/troubleshooting.md): Diagnose launch, workspace, agent runtime, evidence, and promotion failures without hiding the root cause.

## RU

### Начало работы

- [Документация MAIster](https://docs.imaister.dev/markdown/ru/index.md): Знакомство, настройка и эксплуатация MAIster для управляемой разработки с ИИ-агентами над приватными репозиториями.

- [Быстрый старт](https://docs.imaister.dev/markdown/ru/quickstart.md): Запустите MAIster локально, войдите, подключите репозиторий и создайте первую управляемую задачу.

### Знакомство с приложением

- [Карта приложения](https://docs.imaister.dev/markdown/ru/product-tour/application-map.md): Где находятся проекты, входящие запросы, прогоны, Studio, административные настройки и личный доступ.

- [Рабочее пространство проекта](https://docs.imaister.dev/markdown/ru/product-tour/project-workspace.md): Назначение всех вкладок проекта и расположение настроек репозитория, пакетов, автоматизации, знаний и доступа.

- [Репозиторий и пакеты проекта](https://docs.imaister.dev/markdown/ru/product-tour/project-repository-and-packages.md): Просмотр кода проекта, подключение установленных пакетов и использование локальных срезов без изменения исходной ревизии.

- [Канбан-доска, задачи и прогоны](https://docs.imaister.dev/markdown/ru/product-tour/tasks-and-runs.md): Создание работы, связи между задачами, очередь исполнения и разбор каждой попытки.

- [История и экран прогона](https://docs.imaister.dev/markdown/ru/product-tour/run-history-and-workbench.md): Поиск попытки исполнения, чтение графа и результатов узлов, просмотр доказательств, файлов и доступных действий.

### Основные понятия

- [Контур доставки](https://docs.imaister.dev/markdown/ru/concepts/delivery-spine.md): Устойчивый путь MAIster от подключения репозитория до проверенного продвижения результата.

- [Путь агентизации](https://docs.imaister.dev/markdown/ru/concepts/path-to-agentization.md): От co-work к управляемой автономности через Scratch Runs, Flows, Policies и Platform Agents.

- [Flow, узлы и прогоны](https://docs.imaister.dev/markdown/ru/concepts/flows-and-runs.md): Как версионированные Flow-пакеты превращаются в наблюдаемые попытки с изолированными рабочими копиями.

- [Задачи, прогоны и сравнение](https://docs.imaister.dev/markdown/ru/concepts/tasks-runs-and-evaluations.md): Зависимости задач, несколько попыток реализации и воспроизводимое сравнение результатов.

- [Рекурсивный контур агентов (RAH)](https://docs.imaister.dev/markdown/ru/concepts/recursive-agent-harness.md): Ограниченные деревья агентов и Flow с типизированными результатами и независимой проверкой человеком.

- [Доказательства, готовность и проверка](https://docs.imaister.dev/markdown/ru/concepts/evidence-and-review.md): Как принимать решение о продвижении по актуальным доказательствам и явной проверке человеком.

- [Мозг проекта, эмбеддинги и платформенные агенты](https://docs.imaister.dev/markdown/ru/concepts/project-brain-and-agents.md): Индексируйте канонические источники, сохраняйте проверяемую память и превращайте повторяющиеся наблюдения в контролируемые улучшения.

### Администрирование

- [Исполнители ACP и модели](https://docs.imaister.dev/markdown/ru/administration/runners-and-models.md): Профили исполнения на узле, авторизация провайдеров, проверка готовности и привязка сессий Flow.

- [Пользователи, доступ к проектам и токены API](https://docs.imaister.dev/markdown/ru/administration/users-tokens-and-access.md): Активация учётных записей, глобальные и проектные роли, личные и проектные токены доступа.

- [MCP-серверы, привязки и секреты](https://docs.imaister.dev/markdown/ru/administration/mcp-and-secrets.md): Регистрация MCP, разрешение требований пакета в проекте, ссылки на окружение, доверие и проверка соединения.

- [Планировщик и платформенные агенты](https://docs.imaister.dev/markdown/ru/administration/scheduler-and-platform-agents.md): Включение общего такта, диагностика заданий, подключение пакетных агентов и настройка триггеров.

- [Проектные платформенные агенты](https://docs.imaister.dev/markdown/ru/administration/project-platform-agents.md): Создание агента в пакете, подключение к проекту и настройка раннера, рабочей области, памяти, прав и триггеров.

- [Планировщик и автоматизация проекта](https://docs.imaister.dev/markdown/ru/administration/scheduler-and-automations.md): Запуск общего такта, расписания задач и Flow, диагностика заданий и выбор подходящего способа запуска.

### Flow Studio

- [Flow Studio и ответвления пакетов](https://docs.imaister.dev/markdown/ru/studio/flow-studio-and-packages.md): Источники и установленные пакеты, ответвление неизменяемого содержимого, ИИ-помощник и выпуск локального среза.

- [ИИ-помощник в Flow Studio](https://docs.imaister.dev/markdown/ru/studio/ai-assistant.md): Открытие помощника рядом с локальным Flow, вопросы о пакете и защищённое применение изменений без прямого доступа сессии к записи.

- [Виды узлов и проверок Flow](https://docs.imaister.dev/markdown/ru/studio/node-types.md): Выбор подходящего узла исполнения, координации, проверки или участия человека для каждого участка графа.

- [Структурные результаты и контекст прогона](https://docs.imaister.dev/markdown/ru/studio/structured-results-and-context.md): Проверка результата узла, повторное использование переменных, маршрутизация и отличие результата от доказательства.

### Сравнение результатов

- [Сравнение прогонов](https://docs.imaister.dev/markdown/ru/evaluation/run-comparison.md): Запускайте контролируемые варианты, фиксируйте доказательства, применяйте объективные проверки и ИИ-судей, а итог подтверждайте человеком.

### Руководства

- [Подключить проект](https://docs.imaister.dev/markdown/ru/guides/register-a-project.md): Подключите локальный или удалённый git-репозиторий к MAIster без публикации его учётных данных.

- [Источники пакетов и версии](https://docs.imaister.dev/markdown/ru/guides/package-sources-and-versions.md): Подключите собственный репозиторий с Flow-пакетами, устанавливайте версии по тегам, выдавайте доверие, подключайте пакеты к проектам, обновляйте и откатывайте версии, дорабатывайте локальный форк.

- [Запросы участия человека](https://docs.imaister.dev/markdown/ru/guides/human-in-the-loop.md): Отвечайте на разрешения, формы, review и ручной перехват, наблюдайте за живым прогоном и прерывайте узел без потери контекста прогона.

- [Проверить и продвинуть прогон](https://docs.imaister.dev/markdown/ru/guides/review-and-promote.md): Проверьте изменения и доказательства, запросите доработку и продвиньте результат через PR или локальное слияние.

- [Проверка, доработка и локальный перехват](https://docs.imaister.dev/markdown/ru/guides/review-rework-and-takeover.md): Проверяйте производственные артефакты, возвращайте работу агенту или дорабатывайте её локально с повторным входом в Flow.

- [Выбор между Flow Studio и сравнением](https://docs.imaister.dev/markdown/ru/guides/studio-and-evaluation.md): Выберите подходящий сценарий для изменения Flow, сравнения происхождения пакета или оценки результатов исполнения.

### Справочник

- [Манифест проекта](https://docs.imaister.dev/markdown/ru/reference/project-manifest.md): Настройте репозиторий, продвижение, привязки Flow и ограниченные возможности в maister.yaml.

- [Манифест Flow](https://docs.imaister.dev/markdown/ru/reference/flow-manifest.md): Опишите в flow.yaml версионированный граф агентных, командных, проверочных и человеческих узлов.

- [Исполнители агентов](https://docs.imaister.dev/markdown/ru/reference/agent-runtimes.md): Настройте исполнителя ACP и учитывайте готовность, учётные данные и область возможностей.

### Эксплуатация

- [Развёртывание на одном хосте](https://docs.imaister.dev/markdown/ru/operations/deployment.md): Разверните MAIster на Linux с systemd, локальным supervisor, Postgres и TLS reverse proxy.

- [Узлы исполнения](https://docs.imaister.dev/markdown/ru/operations/execution-hosts.md): Текущая граница одного узла супервизора и безопасный путь к нескольким узлам исполнения.

- [Обсерватория, расходы и бюджеты](https://docs.imaister.dev/markdown/ru/operations/costs-and-budgets.md): Относите расход токенов и времени к задачам, прогонам, моделям и исполнителям и ограничивайте потребление политиками.

- [Диагностика проблем](https://docs.imaister.dev/markdown/ru/operations/troubleshooting.md): Диагностируйте ошибки запуска, worktree, agent runtime, доказательств и продвижения без сокрытия причины.