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 для безпеки. Впроваджується семантичне версіонування для окремих скілів.