Мультиагентная разработка ПО на Openclaw + Plane + Git
Версия: 1.0
Дата: 2026-05-04
Статус: проектная спецификация, готова к пилоту
База: analysis_implementation_options.md (Вариант А — GitOps + Claude Code subagents + Plane как «витрина»)
Источник требований: intro.txt + add0405.txt
Зачем этот пакет
Аналитическая записка в analysis_implementation_options.md отвечала на вопрос «как делать?» (выбор варианта А из четырёх). Этот пакет отвечает на вопрос «что именно делать прямо сейчас?» — превращает рекомендацию в оперативный комплект:
- описанный шаг-в-шаг производственный процесс,
- каталог артефактов с шаблонами,
- список Quality Gates с машинно-проверяемыми критериями,
- роли и системные промпты агентов (под Openclaw / Claude Code),
- протокол их взаимодействия,
- интеграцию с Plane и Git,
- чек-лист запуска.
Цель — состояние, в котором пользователь только формулирует бизнес-требования, а аналитика, дизайн, разработка, ревью, тестирование, деплой выполняются агентами с проверяемым результатом на каждом шаге.
TL;DR одним абзацем
Каждая фича в Plane автоматически разворачивается в 7 типовых подзадач (Анализ → Архитектура → Дизайн → Разработка → Code Review → Тестирование → Внедрение). Каждая подзадача обслуживается отдельным агентом-специалистом из Openclaw, который читает контекст из Git (/docs, /CLAUDE.md, ADR) и пишет туда же свой артефакт. Между подзадачами стоят машинные Quality Gates (CI-проверки): без зелёного QG задача не закрывается, кто бы что ни «считал готовым». Plane — витрина для человека, реальный источник правды — Git.
Структура пакета
| # | Файл | О чём |
|---|---|---|
| 0 | README.md | Этот файл — навигация и TL;DR |
| 1 | 01_production_process.md | Производственный процесс: 7 этапов, входы/выходы, диаграмма потока |
| 2 | 02_repo_structure.md | Канон структуры репозитория, naming convention, шаблоны артефактов |
| 3 | 03_quality_gates.md | Quality Gates: машинно-проверяемые критерии для каждого этапа |
| 4 | 04_agents_roles.md | Роли агентов, модели, инструменты, границы ответственности |
| 5 | 05_agent_system_prompts.md | Готовые системные промпты для Openclaw — копируются в subagent definition |
| 6 | 06_plane_integration.md | Plane: иерархия, шаблоны, custom fields, webhooks, MCP |
| 7 | 07_git_workflow.md | Git-flow, лейблы стадий, branch protection, CI, конвенция коммитов |
| 8 | 08_interaction_protocol.md | Протокол взаимодействия: hand-off, формат сообщений, эскалации |
| 9 | 09_ui_testing.md | Стратегия UI-тестирования: Playwright, visual regression, accessibility |
| 10 | 10_launch_checklist.md | Чек-лист запуска: что поднять, какие секреты, последовательность |
Как читать пакет
Если вы заказчик / постановщик БТ — достаточно прочесть 01_production_process.md и раздел «Простым языком» в каждом следующем файле. Технические разделы можно пропустить — их выполняют агенты и инженер DevOps на этапе настройки.
Если вы инженер, который будет настраивать — читайте всё подряд, плюс перечитайте analysis_implementation_options.md для контекста.
Если вы агент, читающий это в Git — после прочтения переходите к своему SKILL.md и к CLAUDE.md конкретного проекта.
Принципы, на которых построен пакет
- Single Source of Truth = Git. Если чего-то нет в репозитории — этого не существует. Plane не источник правды, а витрина.
- Каждый артефакт машинно-валидируем. «Согласовать у Иванова» не считается QG. Считается — проверка скрипта или линтера.
- Агент производит, оркестратор закрывает. Агент не имеет права сам поставить галочку «готово» — это делает CI на основе DoD.
- Ничего лишнего. Если этап не даёт самостоятельной ценности или его проверка не машинна — он не входит в процесс.
- Эскалация явная. Когда агент не уверен — он пишет вопрос в Plane и останавливается, а не «угадывает».
- Воспроизводимость сред. Один Dockerfile, один
docker-compose.yml, разница только в данных и секретах. - Тестирование обязательно, включая UI. Без зелёных тестов (unit + integration + e2e + UI + visual + a11y) задача не закрывается.
Краткий словарь терминов
- BR (Business Request) — короткий запрос от заказчика (1–10 строк), с которого всё начинается.
- BRD (Business Requirements Document) — формализованные бизнес-требования (что и зачем).
- ТЗ (Техническое задание) — что именно реализуется, в технических терминах.
- ADR (Architecture Decision Record) — запись об архитектурном решении в формате М. Найгарда.
- C4 — модель Саймона Брауна для диаграмм архитектуры (Context / Container / Component / Code).
- DoD (Definition of Done) — машинно-проверяемые критерии завершения подзадачи.
- QG (Quality Gate) — «ворота» между этапами, без прохождения которых движение запрещено.
- Subagent — специализированный агент в Openclaw / Claude Code с собственным system prompt и набором тулов.
- MCP (Model Context Protocol) — протокол подключения инструментов к LLM-агентам (Plane, Git, Playwright и т.д.).
- Hand-off — передача задачи от одного агента следующему через коммит/PR/статус Plane.
- Ephemeral preview — временное изолированное окружение, поднимается на каждый PR и удаляется при merge.
Что делать после прочтения
- Прочесть весь пакет (≈45 минут вдумчивого чтения).
- Открыть
10_launch_checklist.mdи пройти его по пунктам. - Выбрать пилотный проект (рекомендация из
analysis_implementation_options.md:fr24-noisemap). - Запустить первую фичу через процесс end-to-end. Все находки — в backlog улучшений процесса.