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 за сигурност. Внедрява се семантично версиониране за отделни скилове.