cdo
CDO v2 — опциональный оркестратор. Используй только когда пользователь явно просит оркестрацию, делегирование или параллельную агентную работу, и только если текущая среда разрешает запуск субагентов.
SKILL.md.claude/skills/cdo/SKILL.md
GitHubCDO v2 — Optional Agent Orchestrator
Safety override: Не автозапускай CDO как дефолтный режим. Не запускай субагентов, если пользователь явно не попросил делегирование/параллельную агентную работу или если текущие системные/developer-инструкции это запрещают.
Как это работает
Пользователь: "хочу добавить систему гильдий"
↓ (0 вопросов)
CDO: классификация → Feature, XL, systems: social+backend+iOS+DB+economy
↓
CDO: pipeline → architect ∥ conductor → nexus → server+fortress → screen → guardian+oracle → gatekeeper → herald
↓
CDO: запускает Agent 1, передаёт результат → Agent 2 → ... → Agent N
↓
Пользователь: получает готовый execution plan / готовый код / готовый ревью
Phase 1: INSTANT CLASSIFICATION (без вопросов к пользователю)
Определи за 1 секунду:
| Что определить | Как |
|---|---|
| Домен(ы) | По карте доменов ниже |
| Тип задачи | feature / enhancement / bugfix / audit / refactor / balance / deploy / research / docs |
| Размер | S (1 агент) / M (2-3) / L (4-6) / XL (7+) |
| Режим | sequential / parallel / hybrid |
| Pipeline | Конкретный список агентов в порядке запуска |
Карта доменов (ВСЯ экосистема)
| Сигналы в запросе | Домен | Агенты |
|---|---|---|
| Hexbound, iOS, SwiftUI, баланс, комбат, арена, данжен, прогрессия, лор, экран, экономика игры | Hexbound Studio | hexbound-studio:* (30+ агентов) |
| Amazon, FBA, ниша, листинг, PPC, поставщик, бренд Амазон | Amazon Team | amazon-product-research, amazon-ops |
| Портфель, бюджет, рынки, крипто, налоги, кредиты, прогнозы | Finance Office | finance-office:* (15+ агентов) |
| Дизайн, UX, ревью экрана, accessibility, wireframe, прототип | Design | full-design-review, design:*, design-department:* |
| Данные, SQL, дашборд, график, статистика, анализ | Data | data:* |
| Код, архитектура, дебаг, деплой, тесты, CI/CD | Engineering | engineering:* |
| Контент, SEO, email, кампания, бренд (не Amazon) | Marketing | marketing:* |
| Спека, роадмап, спринт, метрики, стейкхолдеры | Product | product-management:* |
| Outreach, pipeline продаж, звонок, прогноз | Sales | sales:* |
| Word, Excel, PowerPoint, PDF | Документы | docx / xlsx / pptx / pdf |
Приоритет при конфликтах
- Hexbound-специфичное → всегда
hexbound-studio:* - Amazon-специфичное → всегда
amazon-* - Личные финансы →
finance-office:*(неfinance:*— это корпоративный учёт)
Phase 2: PIPELINE CONSTRUCTION
Режим SEQUENTIAL (цепочка)
Результат Agent A → передаётся как контекст → Agent B → ... → Agent N.
Agent A ──результат──→ Agent B ──результат A+B──→ Agent C ──→ финал
Когда: каждый следующий агент нужен результат предыдущего.
Режим PARALLEL (одновременно)
Запуск нескольких Agent tool в ОДНОМ сообщении. Результаты собираются вместе.
┌→ Agent A → результат A ─┐
Задача ──┤→ Agent B → результат B ─├→ CDO синтезирует
└→ Agent C → результат C ─┘
Когда: агенты работают независимо.
Режим HYBRID (комбо)
Phase 1 (parallel): architect ∥ conductor
Phase 2 (sequential): nexus получает результаты обоих → bladework
Phase 3 (parallel): guardian ∥ oracle
Phase 4: gatekeeper → herald
Phase 3: AGENT BUS — Прямая коммуникация между агентами
Как агенты общаются
Агенты общаются через файловую шину .claude/agent-bus/. Каждый агент читает результаты других и пишет свои. CDO НЕ передаёт контекст вручную — агенты сами забирают нужное.
Полный протокол: .claude/agent-bus/PROTOCOL.md
Lifecycle одного pipeline
1. CDO очищает bus:
find .claude/agent-bus -maxdepth 1 -type f -name '*.md' ! -name 'PROTOCOL.md' ! -name 'AGENT_HEADER.md' -delete
2. CDO запускает Wave 1 — НЕСКОЛЬКО Agent tool вызовов в ОДНОМ сообщении:
Agent tool (guardian) ─┐
Agent tool (oracle) ─┼─ параллельно
Agent tool (scales) ─┘
3. Каждый Agent:
a) Читает .claude/agent-bus/ — что уже есть от других
b) Делает свою работу
c) Пишет результат в .claude/agent-bus/{name}.md
d) В секции ## Alerts пишет @mentions для других агентов
4. CDO запускает Wave 2 — агенты ЧИТАЮТ bus и видят результаты Wave 1:
Agent tool (screen) ──→ читает guardian.md, oracle.md → работает → пишет screen.md
Agent tool (nexus) ──→ читает все файлы → пишет nexus.md
5. CDO читает ВСЕ .md в bus → синтезирует финальный ответ
Контекст при запуске агента (MANDATORY)
Каждый вызов Agent tool ОБЯЗАН содержать:
## CDO PIPELINE CONTEXT
Задача: {оригинальный запрос пользователя}
Wave: {1 из 3}
Агенты в этой волне: {guardian, oracle, scales}
## AGENT BUS PROTOCOL
После завершения работы — ОБЯЗАТЕЛЬНО запиши результат:
Write tool → .claude/agent-bus/{твоё-имя}.md
Перед началом работы — прочитай bus:
Bash: ls .claude/agent-bus/ → Read каждый .md файл (кроме PROTOCOL.md)
Если нашёл проблему для другого агента — добавь в ## Alerts:
@{agent-name}: описание проблемы
Формат результата в bus-файле:
# {Name} — Result
timestamp: {now}
status: OK | WARNING | BLOCKED
## Findings
## Decisions
## Alerts
## Files Changed
Динамическая маршрутизация (ESCALATION)
Если агент находит проблему ВНЕ своей компетенции — он пишет @mention в bus:
# Guardian — Result
## Alerts
- @oracle: endpoint /api/foo возвращает неправильный тип — проверь async
- @fortress: нужна миграция для нового поля lastLoginAt
CDO видит алерты при синтезе. Если адресат ещё не запускался — CDO добавляет его в следующую волну. Если уже отработал — CDO запускает его повторно с контекстом алерта.
Пользователь видит только финальный результат.
Phase 4: PIPELINE TEMPLATES (готовые цепочки)
HEXBOUND — Новая фича (Template A: Full Pipeline)
1. [PARALLEL] architect (vision) + conductor (scope)
↓ GO/NO-GO gate — если architect BLOCKED → стоп
2. nexus (cross-system impact) — получает context от обоих
3. [PARALLEL] профильные агенты по домену:
- bladework (если бой) / vault (если экономика) / arena (если PvP) / depths (если PvE) / ascent (если прогрессия)
- scales (если баланс) + heartbeat (если core loop)
4. [PARALLEL] UX/UI:
- flow (UX) + canvas (visual) + blueprint (tokens)
5. [SEQUENTIAL по зависимостям] Engineering:
- fortress (DB) → server (API) → console (admin) → screen (iOS) → engine (gameplay)
6. [PARALLEL] QA:
- shield (test plan) + gauntlet (gameplay QA) + ledger (economy QA)
↓ QA gate — если shield BLOCKED → стоп
7. gatekeeper (pre-commit check)
8. herald (deploy)
9. [PARALLEL] Post-deploy:
- lens (analytics) + scroll (docs) + context-auditor (CLAUDE.md update)
HEXBOUND — Код-ревью (Template B)
1. [PARALLEL] guardian (iOS) + oracle (backend) — если оба затронуты
2. blueprint (design system) — если UI изменения
3. signal (security) — если auth/payment
4. gatekeeper (pre-commit)
HEXBOUND — UX Ревью экрана (Template C)
1. mirror (полный UX аудит) — основной отчёт
2. [PARALLEL] flow (friction) + canvas (visual) + pulse (animation)
3. blueprint (tokens) — если нарушения найдены
4. psyche (motivation) — если экран влияет на retention
HEXBOUND — Баланс (Template D)
1. [PARALLEL] scales (формулы) + vault (экономика)
2. gauntlet (playtesting) — на основе результатов обоих
3. ledger (abuse/exploit test)
4. strategist (retention impact)
5. architect (final approval)
HEXBOUND — Деплой (Template E)
1. gatekeeper — если FAIL → стоп, показать что фиксить
2. blacksmith (build verify) — если FAIL → стоп
3. herald (deploy all products)
4. gate (release verification) — если прод
HEXBOUND — Hotfix (Template F)
1. server/engine (diagnose + fix)
2. fortress (data integrity check)
3. shield (regression)
4. gate (rollback plan)
5. herald (emergency deploy)
AMAZON — Product Research (Template G)
1. [PARALLEL] Scout (product) + Pulse (trends)
2. Shadow (competitors) — получает нишу от Scout
3. Vault (financial model) — получает данные от Shadow
4. [PARALLEL] Shield (risks) + Architect (brand strategy)
5. Commander (final verdict) — синтез всего
FINANCE — Полный обзор (Template H)
1. [PARALLEL] market-intelligence + financial-news-analyst + macro-economist
2. portfolio-analyst — с учётом рыночного контекста
3. risk-manager — на основе портфеля + макро
4. chief-financial-strategist — финальный синтез
УТРЕННИЙ БРИФ (Template I)
[ALL PARALLEL]:
- finance-office:cdo-orchestrator (финансовый обзор)
- Hexbound: git log + открытые задачи
- Проверка памяти (текущие проекты, дедлайны)
CDO: синтезирует → краткий бриф с приоритетами дня
Phase 5: SYNTHESIS + BUS SUMMARY — Сборка результатов
После получения ответов от всех агентов:
- Прочитай ВСЕ файлы в
.claude/agent-bus/(кроме PROTOCOL.md, AGENT_HEADER.md) - Объединить findings — дедупликация, группировка по теме
- Разрешить конфликты — если агенты спорят, выбрать позицию (или эскалировать architect)
- Приоритизировать — Critical → High → Medium → Low
- Проверить @mentions — если есть нерешённые алерты, запустить дополнительную волну
- Записать самари в bus — сжатый итог всего pipeline
- Очистить индивидуальные файлы — оставить только самари
Bus Summary (ОБЯЗАТЕЛЬНО после каждого pipeline)
После синтеза CDO ОБЯЗАН:
# 1. Записать самари
Write tool → .claude/agent-bus/_summary.md
# 2. Удалить индивидуальные файлы агентов (чтобы bus не рос)
rm -f .claude/agent-bus/guardian.md .claude/agent-bus/oracle.md ... (все кроме PROTOCOL.md, AGENT_HEADER.md, _summary.md)
Формат _summary.md:
# Pipeline Summary
date: {YYYY-MM-DD HH:MM}
task: {краткое описание задачи}
agents: guardian, oracle, scales, screen (кто участвовал)
status: OK | WARNING | BLOCKED
## Key Findings
- finding 1 (source: guardian)
- finding 2 (source: oracle)
## Actions Taken
- файл X изменён (agent)
- миграция создана (fortress)
## Unresolved
- @oracle алерт от guardian — не обработан (если остались)
## Files Changed (all agents combined)
- path/to/file1.swift
- path/to/file2.ts
Правило: _summary.md всегда перезаписывается (не аппендится). Это снэпшот ПОСЛЕДНЕГО pipeline. Предыдущие самари не хранятся — они не нужны, результат в коде.
Формат финального ответа пользователю
[Прямой ответ — 1-3 предложения]
[Детали от агентов — только то, что нужно пользователю, не внутренняя кухня]
[Action items — если есть, конкретные следующие шаги]
[Предупреждения — если были блокеры или escalations]
НЕ показывать: internal pipeline details, "Agent X said Y", промежуточные артефакты. Пользователь видит РЕЗУЛЬТАТ, не процесс.
Phase 6: VERIFY — Post-Task Checklist (CDO ALWAYS RUNS)
Backend
- TypeScript compiles (
npx next build) - Prisma schema synced (
backend/prisma/=admin/prisma/) - No PII in logs
- try/catch on all routes
- async/await correct
- No N+1 queries
iOS
- New .swift files in pbxproj (4 sections)
- No force unwraps
- DarkFantasyTheme tokens (no hardcoded colors)
- ButtonStyles.swift styles
- LayoutConstants for radius/spacing
- Ornamental pattern on panels
-
.compositingGroup()after ornamental stacks -
.transaction { $0.animation = nil }for optional VM
Design System
- All tokens verified in source files
- CurrencyDisplay used (not SF Symbols)
- ItemCardView for items, UnifiedHeroWidget for character
Deploy
-
git push origin main -
git subtree pushif admin changed - No merge conflict markers
Docs
- Relevant docs updated in
/docs/ - CLAUDE.md updated if new rules
- Schema/API reference updated if changed
БЛОКЕРЫ — Стоп-сигналы
Эти агенты могут остановить pipeline:
| Агент | Блокирует | Override |
|---|---|---|
| architect | Любую фичу (vision mismatch) | Только Артём |
| gatekeeper | Деплой (pre-commit fail) | Fix → re-run |
| blacksmith | Деплой (build fail) | Fix → re-run |
| shield | Релиз (QA fail) | Только Артём |
| risk-manager | Финансовое решение | Только Артём |
Если блокер → СТОП → сообщить пользователю ЧТО не так и КАК починить.
Правила CDO
ДЕЛАЙ
- Используй Agent tool только когда пользователь явно попросил агентную делегацию и текущая среда это разрешает
- Если субагенты запрещены или не нужны, выполняй работу локально обычным пошаговым планом
- Очищай bus перед каждым pipeline:
find .claude/agent-bus -maxdepth 1 -type f -name '*.md' ! -name 'PROTOCOL.md' ! -name 'AGENT_HEADER.md' -delete - В prompt каждого Agent tool включай: задачу + bus protocol + путь к SKILL.md агента
- Используй Escalation через @mentions в bus
- Адаптируй templates — они база, не догма
- Для S-задач (1 агент) — вызывай напрямую без pipeline overhead
- Читай bus после каждой волны — проверяй @mentions и статусы
НЕ ДЕЛАЙ
- Не делай CDO дефолтным режимом для любого запроса
- Не запускай субагентов без явной просьбы пользователя
- Не запускай больше 5 агентов в одной волне
- Не показывай пользователю pipeline internals — показывай результат
- Не дублируй работу — если guardian проверил tokens, blueprint не нужен для того же
- Не пропускай Phase 6 (verify) — даже для "маленьких" задач
- Не передавай контекст вручную — агенты читают bus сами
CDO Maxim
"Пользователь описывает ЧТО. CDO решает КТО, КАК, и В КАКОМ ПОРЯДКЕ. Агенты делают РАБОТУ. Пользователь получает РЕЗУЛЬТАТ."
Agent Bus (Team Communication)
CDO — оркестратор bus. Он очищает, запускает волны, читает результаты, пишет самари, чистит за собой.
CDO Bus Lifecycle
1. find .claude/agent-bus -maxdepth 1 -type f -name '*.md' ! -name 'PROTOCOL.md' ! -name 'AGENT_HEADER.md' -delete
2. Launch Wave 1 (parallel Agent tools)
3. Wait for completion
4. Read all .claude/agent-bus/*.md — check @mentions, statuses
5. If unresolved @mentions → Launch Wave 2 with targeted agents
6. Repeat until all waves done
7. Write .claude/agent-bus/_summary.md (compressed summary)
8. rm -f .claude/agent-bus/{agent-name}.md (cleanup individual files)
9. Present result to user (no internals)
При старте pipeline
# Очистка bus (сохраняем только протокол и хедер)
rm -f .claude/agent-bus/_summary.md
# Индивидуальные файлы агентов удалятся автоматически в конце
При завершении pipeline
Записать _summary.md и удалить все {agent-name}.md — bus должен быть чистым между pipeline'ами.