delegated-development

name	delegated-development
description	Use when delegating tasks to Codegen cloud agents, monitoring agent runs, reviewing agent PRs, or running multiple agents in parallel. Triggers on "delegate", "codegen", /delegate, "@codegen-sh", Codegen Bridge.

Delegated Development

Codegen cloud agents исполняют bounded tasks. Claude Code проектирует и контролирует.

Когда делегировать

Делегировать (Codegen)	НЕ делегировать
Любой новый код, тесты	iCloud/локальные файлы
Рефакторинг, lint fixes	dev.db (SQLite на iCloud)
Фиксы по code review	MCP runtime debugging
Документация	YM API с credentials

/delegate — быстрый запуск

/delegate <описание задачи>

Claude анализирует → декомпозирует → формирует промпт → запускает Codegen agent → review PR.

Промпт шаблон

@codegen-sh

## Task
<Одно предложение>

## Context
- Branch: <ветка>
- Related files: <список>

## Requirements
- <Требование 1>

## Constraints
- Follow patterns in <файл-образец>
- Run `make check` before committing
- Do NOT modify files outside <scope>
- Create branch `X` from `Y`, PR to `Y`

## Acceptance criteria
- [ ] <Критерий>
- [ ] `make check` passes

Richness Rule

Codegen agents видят ТОЛЬКО клонированный репо + промпт. Промпт ДОЛЖЕН содержать полный контекст.

Элемент	Почему
Ветка (from + to)	PR не туда
Текущий код (20-50 строк)	Агент не знает что написано
Что НЕ трогать	Агент сломает логику
Acceptance criteria	Нет definition of done

Минимум: 200 слов (1 файл), 500 слов (1-3 файла), >3 файлов → декомпозируй.

Quality Gates

Pre-delegation: scope ≤ 3 файла, спецификация, файл-образец, branch. Post-agent: make check, diff vs spec, no hardcoded secrets, Codex review. Pre-merge: acceptance criteria, CHANGELOG, no conflicts.

Rate Limits

• Параллельных: 3 рекомендуемо (1 Opus ИЛИ 3 Sonnet)
• Model IDs: claude-sonnet-4-5-20250929 (НЕ sonnet-4-5)
• Размер задачи: ≤ 5 файлов

Decision tree после PR

make check failed → "@codegen-sh fix CI errors"
Codex P1/P2 issues → "@codegen-sh исправь замечания"
Diff OK + tests pass → Merge в dev
2+ неудачных попытки → Забрать локально

---

Iron Law

NO MERGE WITHOUT make check PASSING LOCALLY

Codegen агент может пропустить lint/mypy/tests. ВСЕГДА проверяй make check на PR ветке перед merge.

Red Flags

Отговорка	Реальность
"Тесты прошли у агента"	Агент мог пропустить mypy strict, ruff, или test pollution
"Scope маленький, review не нужен"	Даже 1-строчный diff может сломать import chain или typing
"Промпт и так понятный"	Codegen видит ТОЛЬКО клон репо + промпт — без context из head = слепая работа
"Сделаю review потом"	PR без review = tech debt, который копится
"3+ файла — нормально"	Scope > 3 файлов → декомпозируй на подзадачи

Примеры задач для делегирования

# Тесты
/delegate Добавить тесты для app/mcp/tools/curation.py — classify_tracks, analyze_library_gaps

# Lint fix
/delegate Исправить все mypy ошибки в app/services/set_generation.py

# Рефакторинг
/delegate Извлечь общий паттерн из TrackRepository и PlaylistRepository в BaseFilterRepository

# Документация
/delegate Добавить docstrings к всем публичным методам в app/services/transition_scoring.py