gendesign/.claude/rules/delegation.md
bot-backend 79e4528eeb chore(claude): port delegation limits to repo rules, fix git-pr staleness
- new rules/delegation.md (always-loaded): subagent budget, oversized escalation,
  единые пороги дробления, parallel-default — портировано из memory 2026-06-27
- git-pr.md: parallel-default вместо sequential (supersedes), list_pull_reviews,
  фактические worktree settings, typos
- CLAUDE.md: merge-политика 2026-06-27, tradein/delegation в списке rules,
  auto-* vs Task-spawn различие
2026-07-02 17:28:05 +03:00

2.3 KiB
Raw Blame History

Delegation & task sizing

Без paths: — загружается в каждой сессии. Канон лимитов делегирования (портировано из memory-фидбека 2026-06-27).

Бюджет одного сабагента (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 = дубли и мусор.

Эскалация oversized-задачи (worker)

Issue/задача выглядит больше одного захода (эвристика: >5 файлов, ИЛИ >500 строк diff, ИЛИ >2ч) → НЕ исполнять целиком:

  • bot-pipeline: комментарий с планом сплита + label status/needs-analysis, снять claim
  • interactive: вернуть main-сессии план сплита вместо результата

Единые пороги дробления (analyst / main)

  • Estimate S(<2h) / M(2-8h) / L(>8h) → обязан дробиться дальше (до S/M)
  • Issue ≥1.5 дня → 3-4 sub-PR (Foundation → Schema → Workers → Integration), каждый ~200-500 строк — см. git-pr.md § Split big issues
  • 1 sub-issue ≈ 1-2 worker-захода, single-scope (не смешивать backend+frontend в одном issue)

Параллелизм

Default = parallel на непересекающихся файлах (per-task worktree). Sequential — только overlap / hot-files / зависимый стек (git-pr.md § Parallel vs sequential PRs).