Skip to content

00-introduction.md

Latest commit

 

History

History
92 lines (63 loc) · 8.81 KB

00-introduction.md

File metadata and controls

92 lines (63 loc) · 8.81 KB
Raw

Глава 00 — Введение

Зачем эта глава

Понять, что такое ControlFlow, для чего он нужен и чем он не является. Без этого фундамента легко запутаться: проект не похож ни на обычный фреймворк, ни на типичное приложение.

Что такое ControlFlow

ControlFlow — это репозиторий промптов, governance-конфигураций и автоматических проверок (evals), описывающий мультиагентную систему оркестрации задач разработки на основе больших языковых моделей (LLM).

Если упростить до одного предложения:

ControlFlow — это «оркестр» из 13 специализированных AI-агентов, каждый со своей ролью и контрактом, которые сообща превращают неформальные задачи разработки («хочу добавить такую-то фичу») в проверенный, детерминированный результат с гейтами безопасности и человеческим одобрением в нужных точках.

Чем ControlFlow не является

Это критически важно, потому что новички часто пытаются «запустить» ControlFlow как обычное приложение и не понимают, почему ничего не происходит.

ControlFlow — это НЕ… …потому что
Runtime-приложение Здесь нет сервера, нет UI, нет компилируемого продукта.
Библиотека для импорта Нечего импортировать в код вашего проекта.
Готовый «AI-разработчик в коробке» Это набор контрактов и процессов. Реальный исполнитель — LLM в вашем редакторе (например, GitHub Copilot Chat в VS Code).
Замена планированию Это инструмент поддержки планирования и исполнения, а не замена инженерного мышления.

Что ControlFlow поставляет в виде артефактов:

  1. 13 агентских файлов (*.agent.md в корне) — промпты, описывающие роль каждого агента.
  2. 20 JSON-схем (schemas/*.json) — контракты входов и выходов между агентами.
  3. Governance-конфигурации (governance/*.json) — что какому агенту разрешено, какие пороги retry, какие модели использовать.
  4. Skill-паттерны (skills/patterns/*.md) — переиспользуемые знания о тестировании, безопасности, производительности и т.д.
  5. Eval-харнесс (evals/) — оффлайн-проверки качества всех вышеперечисленных артефактов.
  6. Документация (docs/agent-engineering/) — канонические governance-спецификации.

Зачем всё это нужно

Сырая работа с одной LLM «как с программистом» имеет известные проблемы:

  • Галлюцинации — модель уверенно выдумывает факты о коде, которого не существует.
  • Размытие фокуса — на длинных задачах модель забывает требования.
  • Отсутствие проверок — модель радостно объявляет, что «всё работает», не запустив тесты.
  • Скрытое расширение скоупа — параллельно с просьбой починить баг модель «улучшает» соседний код.
  • Безопасность — деструктивные операции выполняются без согласования.

ControlFlow борется с этим через разделение ролей и детерминированные контракты:

  • Планировщик (Planner) только думает и пишет план — но не пишет код.
  • Исполнители (CoreImplementer, UIImplementer, PlatformEngineer) только пишут код по плану — но не меняют дизайн.
  • Ревьюеры (CodeReviewer) проверяют код после исполнения — независимо от исполнителя.
  • Аудиторы плана (PlanAuditor, AssumptionVerifier, ExecutabilityVerifier) ищут проблемы в плане до исполнения — это адверсариальная фаза.
  • Оркестратор (Orchestrator) дирижирует всем процессом, эскалирует к человеку при риске.

Каждое сообщение между агентами проходит через JSON-схему, что отсеивает «болтливые» ответы и заставляет агентов структурировать свою работу.

Аудитория этого пособия

Пособие построено по принципу двухуровневой подачи:

  • Главы 00–04 — для новичков. Что такое мультиагентная система, как она выглядит сверху, какие есть основные роли и как читать агентский файл.
  • Главы 05–14 — для разработчиков среднего уровня. Подробный разбор процессов оркестрации, планирования, ревью, исполнения, схем, governance, skills, памяти, taxonomy сбоев и eval-харнесса.
  • Главы 15–18 — практика и справка. Разборы реальных кейсов, упражнения, глоссарий, FAQ.

После прохождения пособия вы:

  1. Сможете объяснить архитектуру ControlFlow за 5 минут.
  2. Поймёте, какой агент делает что, когда и почему именно он.
  3. Сможете прочитать любой агентский файл и сказать, что в нём правильно/неправильно.
  4. Поймёте, как Planner превращает идею в план и как Orchestrator превращает план в код.
  5. Сможете отвечать на сложные вопросы вида «зачем нужен AssumptionVerifier, если есть PlanAuditor», «когда использовать ABSTAIN, а когда REPLAN_REQUIRED», «почему Planner не вызывает ревьюеров сам» и т.д.
  6. Сможете внести вклад: добавить агента, схему, skill или сценарий теста.

Как читать пособие

  • Если у вас час — глава 01 (быстрый старт) + глава 02 (архитектурный обзор) + просмотр глоссария.
  • Если у вас день — главы 00–08 подряд.
  • Полное освоение — все 19 файлов, с упражнениями и кейсами.

Каждая содержательная глава завершается упражнениями и контрольными вопросами. Не пропускайте их — именно они переводят знание в навык.

Контрольные вопросы

  1. Почему ControlFlow нельзя «запустить» как обычное приложение?
  2. Перечислите три типа артефактов, поставляемых ControlFlow.
  3. Какие проблемы LLM-разработки ControlFlow стремится решать?
  4. В чём принципиальная разница между Planner и CoreImplementer?

См. также