flowai 0.4: паки, мультиагентный пайплайн и адаптация скиллов

https://github.com/korchasa/flowai

TL;DR: За последние две недели мы ушли от монолитной архитектуры — теперь фреймворк разделен на 6 независимых паков. Добавили мультиагентный SDLC-пайплайн, где 6 субагентов передают задачу по цепочке через файлы-артефакты. Решили проблему с затиркой локальных правок при обновлении скиллов: теперь работает трехсторонний мерж. Также распараллелили проверки и сделали whiteboards посессионными. Итого: 142 коммита, 10 релизов (0.3.5 → 0.4.8), 41 скилл.

Разделение на паки

Монолитный подход оказался неудобным: при установке в проект тянулись лишние зависимости (например, Deno-скиллы в Go-проект). Фреймворк разбили на 6 паков. Пак — это директория с pack.yaml, скиллами и агентами, по аналогии с claude code plugins. При установке теперь можно выбрать только нужное.

• core — базовые скиллы (commit, review, plan и т.д., 14 шт.)
• engineering — deep-research, тесты, QA, браузерная автоматизация (14 шт.)
• devtools — создание скиллов, агентов, бенчмарки (6 шт.)
• pipeline — мультиагентный пайплайн (3 скилла + 6 субагентов)
• deno и typescript — инструменты под конкретный стек

Мультиагентный SDLC-пайплайн

Оркестратор проводит задачу через конвейер из 6 субагентов: PM → Architect → Developer → QA → Tech Lead → Tech Lead Review.

Агенты не имеют общей памяти и ничего не знают друг о друге. Координация идет исключительно через чтение и запись артефактов в папке .flowai/. Поддерживаются два режима: полностью локальный и через GitHub Issues.

На небольших задачах (добавить эндпоинт, написать CLI-команду) пайплайн работает стабильно. На объемных пока есть сложности: архитектор иногда выдает слишком абстрактный план, из-за чего разработчик теряет контекст. Будем дорабатывать.

Адаптер скиллов (без потери локальных правок)

Раньше при выполнении flowai sync апстрим-версии скиллов затирали локальные команды (например, если базовый вызов тестов был заменен под проект на pytest -x или ruff check .).

Теперь команда flowai-update запускает отдельный адаптер для каждого измененного скилла. Он делает трехсторонний мерж: сводит свежую версию из фреймворка, прошлую локальную версию (из git HEAD) и контекст проекта из AGENTS.md. В результате обновления накатываются, а специфика команд проекта сохраняется. Перед применением изменений показывается diff.

Параллельные проверки

Линтеры, форматтеры и тесты (deno task check и flowai-review-and-commit) теперь выполняются параллельно. Чтобы вывод в консоли не смешивался в кашу, он буферизуется и печатается только после полного завершения конкретного шага.

Per-session whiteboards

План задачи (whiteboard) больше не перезаписывается в одном файле documents/whiteboard.md при старте новой сессии. Теперь для каждой задачи создается отдельный файл в формате documents/whiteboards/YYYY-MM-DD-slug.md, что позволяет возвращаться к истории старых планов.

Рефлексия по истории сессий

Новый скилл flowai-reflect-by-history анализирует транскрипты прошлых IDE-сессий (не текущей) и ищет повторяющиеся паттерны в поведении агента. Скилл автоматически определяет IDE по маркерам в проекте и выбирает глубину анализа в зависимости от запроса — от одной последней сессии до 20.

Что ищет: повторяющиеся ошибки (одна и та же ошибка в 2+ сессиях), ручные workflows-кандидаты на автоматизацию, ad-hoc решения без правил. Каждую находку классифицирует по типу артефакта: Rule, Skill, Hook, Code Change или Project Docs — и предлагает конкретное исправление с указанием evidence из конкретных сессий.

Что ещё добавили и убрали

• Новое: Автоматизация браузера через Playwright, генерация обучающих материалов, хуки для генерации IDE-конфигов и пайплайнов.
• Убрано: flowai-skill-executor (скиллы теперь вызываются напрямую), flowai-skill-ai-skel-ts (вынесен в отдельную библиотеку).

Остальные изменения

• CLI: Добавлен флаг --local для локальной разработки, -y для генерации конфига без промптов, --version с проверкой обновлений.
• Логика команд: Критика плана в flowai-plan стала автоматической (убран лишний запрос), добавлены секции Risks и Trade-offs. flowai-commit предлагает рефлексию после выполнения. Documentation Audit стал обязательным этапом.
• Инфраструктура: Папка .flow/ переименована в .flowai/. Обязательный префикс flowai- для именования.
• Бенчмарки: Добавлено 25 новых сценариев, внедрены статические моки, LLM-judge через Claude CLI и запрет test-fitting.
• CI: В GitHub Actions экшены привязаны к SHA для безопасности. Внедряется семантическое версионирование для отдельных скиллов.