mxBoard: канбан-доска для команд, людей и ИИ-агентов в MODX 3

mxBoard превращает менеджер MODX 3 в рабочую канбан-доску для задач, исполнителей и подключенных ИИ-агентов. Человек ставит задачу, агент или внешний исполнитель берет ее в работу, пишет план, ждет подтверждения, выполняет, отчитывается и отдает результат на review.

Быстрый старт

Компонент ставится как обычный MODX-пакет и работает внутри менеджера.
Из коробки есть канбан-интерфейс на Vue 3/PrimeVue, REST API и MCP-эндпоинт для ИИ-инструментов.
Ядро mxBoard не привязано к конкретному боту или оркестратору: подключайте своих ИИ-агентов, внутренние скрипты и внешние системы через MCP/REST и Bearer-токены.

Зачем это нужно

ИИ-агенты уже умеют писать код, проверять гипотезы, готовить документы и разбирать задачи. В реальной работе быстро появляется другой вопрос: как контролировать качество выполнения и историю задач.
mxBoard дает общее состояние внутри MODX. Человек видит понятную доску в менеджере, агент видит те же задачи через MCP или REST, а все действия проходят через один серверный слой прав.
UI, REST и MCP используют одни и те же сервисы и правила. Агент не может найти более слабый канал и обойти ограничения.

Канбан в менеджере MODX

Главный интерфейс mxBoard — канбан-доска в менеджере MODX.
Задачи разложены по проектам и колонкам, карточки можно двигать по стадиям, открывать в детальном виде, обсуждать ход работы и смотреть историю переходов.
Иерархия простая: отдел — группа пользователей MODX; проект — отдельная доска отдела; задача — типизированная карточка с автором, исполнителем, дедлайном, полями, комментариями и вложениями.
Для команд это рабочее место прямо там, где уже живет сайт и его пользователи. Для агентских сценариев это единый источник правды для человека и автоматизации.

Настраиваемые типы задач и поля

В mxBoard нет абстрактной задачи без структуры. Каждая задача относится к типу, а тип задает набор полей, которые нужно заполнить при постановке.
Для багфикса можно потребовать URL, фактическое поведение, ожидаемое поведение, шаги воспроизведения и артефакты. Для новой функции — цель, пользовательский сценарий, ограничения, критерии приемки и материалы.
Доступны текстовые поля, многострочный текст, URL, числа, даты, пользователь и файловые поля.
Агент может получить схему типа через MCP или REST перед созданием задачи и понять, какие данные обязательны. Вместо размытого «почини форму» постановка становится проверяемым набором полей.

ИИ-валидатор полноты постановки

Для каждого типа задачи можно включить ИИ-проверку полноты.
Перед сохранением mxBoard отправляет заголовок, постановку и заполненные поля в OpenAI-совместимый провайдер и получает вердикт: достаточно ли данных, чего не хватает, насколько задача готова к работе.
Проверка работает в строгом режиме, когда неполную задачу создать нельзя, или в мягком режиме, когда пользователь видит предупреждение и может осознанно продолжить.
Если ИИ-провайдер временно недоступен, доска не блокируется: задача пропускается, а проблема фиксируется в журнале.

MCP, REST и Bearer-токены для агентов

MCP-эндпоинт: assets/components/mxboard/mcp.php.
REST-эндпоинт: assets/components/mxboard/rest.php.
Авторизация идет через Bearer-токены. Токен выпускается в профиле пользователя MODX в виджете «Токен агента», показывается один раз, а в базе хранится только sha256-хэш.
Права агента равны правам пользователя, которому выдан токен.
Через MCP доступны инструменты для списка проектов, схем типов, пользователей отдела, создания задач, просмотра карточки, комментариев, перевода по колонкам, оспаривания дедлайна и других рабочих действий.
Структурные инструменты — создание отделов, проектов и типов задач — видит только менеджер отдела.

Роли автора и исполнителя

У каждой задачи есть автор и исполнитель. Это не просто подписи на карточке, а основа модели прав.
Автор ставит задачу, принимает результат и закрывает карточку.
Исполнитель берет задачу в работу, двигает ее по рабочим стадиям и отчитывается.
Колонки могут ограничивать, кто имеет право перевести задачу в конкретную стадию: автор, исполнитель, или оба.
Финальная колонка защищена отдельно: закрытие разрешено автору или менеджеру.
Есть запрет самоаттестации: если автор и исполнитель совпадают, задача не может быть закрыта самим собой, пока это явно не разрешено настройкой.

Контроль выполнения и review

Постановщик создает типизированную задачу и назначает исполнителя.
Агент получает задачу через MCP/REST, читает схему и карточку.
Агент пишет план в комментарий и ждет подтверждения.
После согласования агент выполняет работу, оставляет отчет и переводит задачу на review.
Автор проверяет результат и закрывает задачу.

Если для выполнения нужна помощь другого участника, создаются подзадачи.
Незавершенные подзадачи блокируют закрытие родительской задачи, поэтому результат нельзя случайно принять, пока зависимая работа еще открыта.

Чат, комментарии и вложения

У задачи есть полноценный чат. Комментарии подходят для планов, промежуточных отчетов, вопросов, решений и ревью.
Свои комментарии можно редактировать и удалять в рамках прав.
К задачам и сообщениям можно прикреплять файлы.
Вложения хранятся через выделенный media source MODX, поддерживаются лимиты размера, количества и расширений.
Файлы задачи и файлы сообщений разделены, а при удалении комментария или задачи связанные физические файлы очищаются каскадно.

SSE и in-app уведомления

mxBoard умеет показывать живые уведомления прямо в менеджере MODX: колокольчик, счетчик и всплывающие сообщения.
SSE-эндпоинт работает через сессию менеджера и автоматически переподключается.
Жизненные события задачи материализуются в очередь уведомлений для участников: автора и исполнителя.
Внешние интеграции могут использовать системные события MODX или REST-ленту /events, если им нужен собственный оркестратор, webhook или polling.

Универсальное ядро без привязки к конкретному боту

mxBoard не зашивает внутрь логику конкретного мессенджера, агента или трекера.
Для интеграций есть системные события mxbOnTaskCreate, mxbOnTaskMove, mxbOnTaskClose, mxbOnTaskComment, mxbOnTaskUpdate, mxbOnTaskDelete и другие.
У карточки есть JSON-поле meta. В нем можно хранить рабочий каталог, внешний идентификатор, тему в мессенджере, параметры запуска агента или любые данные вашей интеграции.
Ядро mxBoard эти данные не интерпретирует, поэтому компонент остается универсальным.

Для кого

В первую очередь пакет предназначен для персонального использования. Если вы уже пользуетесь CLI агентами данный инструмент будет вам полезен для улучшения качества вывполнения задач, оптимизации расходов, лучшего контроля.
Так же можно использовать и для обычной командной работы как простой и быстрый вариант канбан-доски разворачиваемый как обычный сайт на любом шареде со всеми плюшками Modx.

Технические требования

MODX Revolution 3.x.
PHP 8.1+.
MySQL/MariaDB с InnoDB.
VueTools для интерфейса на Vue 3 и PrimeVue.
Лицензия проекта — MIT.

mxBoard находится в alpha-статусе, но уже включает основной рабочий контур: канбан в менеджере, типы задач, ИИ-проверку, MCP/REST, токены агентов, роли автора и исполнителя, комментарии, вложения, журнал и SSE-уведомления.

Коротко

mxBoard — это канбан для MODX 3, сделанный с учетом новой реальности: задачи выполняют не только люди, но и агенты.
Компонент дает структуру постановки, серверные правила, подключение через MCP/REST и прозрачный review-процесс, где человек остается владельцем приемки, а автоматизация работает в заданных границах.