Полный курс по проекту ControlFlow — мультиагентной системе оркестрации задач разработки на основе LLM. Пособие проведёт вас от первого знакомства до уровня, на котором вы сможете уверенно ориентироваться в репозитории, объяснять архитектуру коллегам и отвечать на сложные вопросы по любому компоненту.
- Новичок в LLM-агентах — начните с глав 00–04. Вы получите понимание зачем нужна вся эта система и как она устроена сверху.
- Разработчик среднего уровня (Python/JS/любой стек) — после глав 00–04 переходите к 05–14, где разбираются процессы и подсистемы.
- Архитектор / тимлид — главы 09–14 (схемы, governance, память, taxonomy сбоев) дают полный системный взгляд.
- Все — глава 15 (разборы кейсов), 16 (упражнения), 17 (глоссарий), 18 (FAQ) — постоянный справочный материал.
| Цель | Порядок глав | Время |
|---|---|---|
| Быстрый обзор за час | 00 → 01 → 02 → 17 | ~60 мин |
| Полное освоение | 00 → 01 → 02 → 03 → 04 → 05 → 06 → 07 → 08 → 09 → 10 → 11 → 12 → 13 → 14 → 15 → 16 | ~10–14 ч |
| Подготовка к ревью / архитектурным разговорам | 02 → 04 → 05 → 06 → 07 → 09 → 10 → 13 → 18 | ~6–8 ч |
| Контрибьютор (хочу добавить агента) | 04 → 09 → 10 → 11 → 14 → CONTRIBUTING.md | ~4 ч |
| № | Глава | Содержание | ~стр. |
|---|---|---|---|
| 00 | Введение | Что такое ControlFlow, зачем он нужен, отличия от runtime-приложений, цели этого пособия | 4 |
| 01 | Быстрый старт | 15-минутный экспресс-обзор: где что лежит, как запустить evals, общая картина | 5 |
| 02 | Архитектурный обзор | Верхнеуровневая архитектура, потоки управления, диаграмма всех 13 агентов | 7 |
| 03 | Реестр агентов | Подробный разбор каждого из 13 агентов: роль, входы, выходы, типичные сценарии | 12 |
| 04 | Структура P.A.R.T. | Обязательная структура агентского файла: Prompt → Archive → Resources → Tools | 8 |
| 05 | Оркестрация | Жизненный цикл Orchestrator, gate-events, делегирование, восстановление после сбоев | 9 |
| 06 | Планирование | Процедура Planner: idea interview, clarification gate, semantic risk gate, complexity gate, skills, research, design, planning, handoff | 10 |
| 07 | Ревью-пайплайн | PLAN_REVIEW: PlanAuditor, AssumptionVerifier, ExecutabilityVerifier, маршрутизация по тиру, бюджет итераций | 8 |
| 08 | Пайплайн исполнения | Волны параллельного исполнения, executor_agent, quality gates, completion gate, optional final review | 8 |
| 09 | Схемы (контракты) | Разбор всех 15 JSON-схем: какая для какого агента, ключевые поля | 10 |
| 10 | Governance | agent-grants, tool-grants, runtime-policy, model-routing, rename-allowlist | 8 |
| 11 | Skills (паттерны) | Skill library, протокол выбора (≤3 на фазу), 11 паттернов | 7 |
| 12 | Архитектура памяти | Трёхслойная модель: session / task-episodic / repo-persistent; роль NOTES.md | 6 |
| 13 | Таксономия сбоев | 4 класса: transient / fixable / needs_replan / escalate; retry-политики | 6 |
| 14 | Eval-харнесс | Устройство cd evals && npm test, режимы full/structural/behavior |
6 |
| 15 | Разборы кейсов | 5 пошаговых разборов реальных сценариев из evals/scenarios/ |
10 |
| 16 | Упражнения | 15 сквозных упражнений с возрастающей сложностью | 6 |
| 17 | Глоссарий | Все термины с переводом и английским оригиналом | 8 |
| 18 | FAQ | Сложные вопросы и ответы для собеседований и архитектурных дискуссий | 7 |
Все содержательные главы (02–14) построены по единой схеме:
- Зачем эта глава — кратко формулируется, какую проблему вы научитесь решать.
- Ключевые понятия — определения с английским оригиналом в скобках.
- Диаграмма (Mermaid) — визуализация описываемой подсистемы.
- Подробное описание — раскрытие концепций со ссылками на первоисточники.
- Пример — конкретный сценарий из репозитория или иллюстративный мини-кейс.
- Типичные ошибки — что обычно понимают неправильно.
- Упражнения — 3–5 заданий для самопроверки (с подсказками).
- Контрольные вопросы — 3–5 вопросов для проверки понимания.
- См. также — ссылки на связанные главы и канонические первоисточники.
Это пособие — учебный пересказ. Если возникает противоречие, канонические источники всегда побеждают:
- .github/copilot-instructions.md — общие политики
- plans/project-context.md — реестр агентов, тиры, taxonomy
- docs/agent-engineering/ — governance-спецификации
- governance/runtime-policy.json — runtime-параметры
schemas/*.json— контракты выходов агентов
- Английские оригиналы терминов даются в скобках при первом упоминании в каждой главе: P.A.R.T.-структура (P.A.R.T. structure), волна (wave), исполнитель фазы (executor_agent).
- Имена файлов, агентов и схем оставлены в оригинальном написании:
Orchestrator.agent.md,CoreImplementer-subagent,schemas/planner.plan.schema.json. - Команды и пути — без перевода:
cd evals && npm test. - Цитаты из канонических документов сопровождаются ссылкой на файл.
Удачи в изучении! Если что-то непонятно — обратитесь к глоссарию или FAQ.