From d4f4fd417b3997be63db711b41e08591b4fdc94d Mon Sep 17 00:00:00 2001 From: bot-backend Date: Thu, 2 Jul 2026 18:52:30 +0300 Subject: [PATCH] =?UTF-8?q?docs(claude):=20delegation.md=20=E2=80=94=20rou?= =?UTF-8?q?ting-=D1=82=D0=B0=D0=B1=D0=BB=D0=B8=D1=86=D0=B0=20(Explore/Plan?= =?UTF-8?q?/worker/verify),=20effort-=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB?= =?UTF-8?q?=D0=B0,=20=D1=8D=D0=BA=D0=BE=D0=BD=D0=BE=D0=BC=D0=B8=D0=BA?= =?UTF-8?q?=D0=B0=20=D0=BF=D0=B0=D1=87=D0=B5=D0=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Канонизация практик из верифицированного ресёрча CC v2.1.198 (2026-07-02): built-in Explore/Plan для разведки, fresh-context verify, SendMessage вместо re-spawn, лестница масштаба пачки, effort per agent, cache-окна для циклов. --- .claude/rules/delegation.md | 25 +++++++++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/.claude/rules/delegation.md b/.claude/rules/delegation.md index 51a4b223..2483f5a0 100644 --- a/.claude/rules/delegation.md +++ b/.claude/rules/delegation.md @@ -1,14 +1,26 @@ # Delegation & task sizing -> Без `paths:` — загружается в каждой сессии. Канон лимитов делегирования (портировано из memory-фидбека 2026-06-27). +> Без `paths:` — загружается в каждой сессии. Канон лимитов делегирования (портировано из memory-фидбека 2026-06-27, routing/effort — из верифицированного ресёрча 2026-07-02). + +## Routing (кому отдавать) + +| Задача | Агент | +|---|---| +| Разведка: найти файлы / понять структуру | **Explore** (Haiku, read-only, дёшев) — НЕ general-purpose | +| Спроектировать подход | **Plan** | +| Код | доменный worker (backend/frontend/database/devops) + `isolation: "worktree"` | +| Проверить результат | отдельный агент **в fresh context** — видит только diff и критерии, без bias автора | + +- Продолжение работы существующего агента → `SendMessage` по agentId (контекст цел), НЕ новый спавн с пересказом. +- Масштаб пачки: 1-3 независимых → параллельные Agent-вызовы одним сообщением; конвейер / 10+ агентов → Workflow (pipeline-default, `schema`-выход, adversarial verify находок). Caps на выборках — логируй отброшенное, молчаливое усечение читается как «покрыто всё». ## Бюджет одного сабагента (hard limits) - **1 сабагент = 1 узкий deliverable.** Ориентиры: ~≤10 мин работы, ~≤20 tool-calls, ~≤150k токенов. Эмпирика 2026-06-27: агент-аудитор на 186k tok / 33 calls упал на StructuredOutput; 5 мелких параллельных прошли. - Поверхность больше бюджета → **дели на N узких сабагентов** (parallel при непересекающихся файлах, sequential при зависимостях). НЕ один большой. -- Read-only разведка (найти файлы/понять структуру) → лёгкий Explore-agent, не general-purpose worker. - Промпт сабагенту: конкретный deliverable + формат ответа + границы («что НЕ делать»). Расплывчатый scope = дубли и мусор. +- Windows: очень длинный промпт субагенту может упасть на лимите командной строки (~8191 символ) — ещё один довод за компактность. ## Эскалация oversized-задачи (worker) @@ -25,3 +37,12 @@ Issue/задача выглядит больше одного захода (эв ## Параллелизм Default = parallel на непересекающихся файлах (per-task worktree). Sequential — только overlap / hot-files / зависимый стек (git-pr.md § Parallel vs sequential PRs). + +**Усилие ∝ сложности**: простой факт-запрос = 1 агент / 3-10 tool-calls; сложный разбор = N узких параллельных. Ширина пачки дешева, толщина одного агента — дорога и хрупка. Параллельные сессии/окна: практический потолок 3-5 (bottleneck — review, не Claude). + +## Effort / model per agent + +- Наследовать по умолчанию; модель НЕ переопределять без нужды (Explore и так на Haiku). +- `effort: low/medium` — механика: точечные правки по списку, сбор данных, mass-grep, формат-конверсии. +- `effort: high+` — только verify/judge-этапы, архитектурный синтез, решения. +- Циклы/поллинг: prompt-cache живёт 5 мин — тик либо <~4.5 мин (кэш тёплый), либо сразу 20-30 мин; интервалы 5-15 мин = worst case (полный re-read контекста каждый тик без амортизации). -- 2.45.3