Opus claude-opus-5-5 · effort xhigh срез: 2026-09-27 источников: 96 слов: 23414 complete

Проектирование систем для параллельной разработки ИИ-агентами: границы, контракты, тестирование и экономия токенов

Каталог из 38 стратегий, методика нарезки на зоны, правила контрактов и таблица перепроверки для параллельной разработки ИИ-агентами. Главный вывод: скорость дают модульный монолит с машиночитаемыми контрактами, линтером границ, выбором тестов по графу зон и одним агентом на зону, но только вместе с ускорением приёмки, малыми партиями и экономией контекста. Ограничение: прямых исследований эффекта архитектуры на продуктивность агентов нет, вывод опирается на косвенную эмпирику и документацию.

Вердикт

Параллельная разработка ИИ-агентами ускоряет работу, только если вместе с генерацией кода масштабируются проверка, интеграция и приёмка: при росте потока PR время ревью растёт кратно, а рост внедрения ИИ связан со снижением стабильности поставки эмпирика [S1, S2, S3].

  • Для кого и что выбрать. Одному человеку или команде до 10 человек с несколькими агентами лучше всего подходит модульный монолит, нарезанный на зоны по изменчивым решениям и предметным подобластям, с машиночитаемыми контрактами, линтером границ в CI, выбором тестов по графу зон и одним агентом на зону в изолированной копии гипотеза.
  • Механизм выигрыша. Непересекающиеся множества файлов убирают конфликты, которые без координации возникают в 19,8–41,7 % одновременных PR агентов эмпирика [S4], проверка затронутого заменяет полный прогон, а маленькая зона с паспортом экономит контекст — главный ресурс агента вендор [S5].
  • Подход пользователя «ящики → контракты по семи вопросам → трассы → детализация» совпадает с классикой по смыслу границ, но остаётся документным: ему не хватает схем, контрактных тестов, заглушек, линтера границ, правил совместимости и полей для ошибок, арендатора и тестовых обязательств, а детализацию после фиксации контрактов можно вести параллельно (раздел 5.4).
  • Векторы, которых нет в постановке (раздел 1.8):
  • приёмка как главное узкое место: доказательства, хук-гейт, ревью по риску;
  • малые партии;
  • лимиты уходят на контекст, а не на код: свежие сессии, субагенты, хуки-фильтры, кеш;
  • детерминированные скрипты и генераторы вместо рассуждений модели;
  • единая очередь задач с WIP-лимитом против дублей и брошенных PR.
  • Ключевое ограничение. Контролируемых исследований о влиянии архитектуры на продуктивность агентов не найдено, и вывод собран из косвенной эмпирики, документации производителей и классических аргументов модульности.
  • Сильнейшая альтернатива. Для прототипов и маленьких систем выигрывает однопоточная работа с одним агентом без зон, а частям, которым нужна независимая эксплуатация, подходит выделение двух-трёх сервисов при модульном монолите для остального.
  • Уверенность средняя. Механизмы (конфликты, деградация контекста, узкое место ревью) подтверждены данными и документацией, но размер ускорения для конкретной команды нужно измерять метриками раздела 8, а не ощущением, которое в среднем ошибается на 40 п. п. эмпирика [S6].

Что это и как работает

1.1. Определение и границы предмета

Проектирование для параллельной агентной разработки — набор архитектурных, тестовых, процессных и контекстных приёмов, при которых типичное изменение локально: задача затрагивает одну зону кода, проверяется тестами этой зоны и контрактами её границ и сливается без ожидания остальной системы. Цель — чтобы несколько ИИ-агентов (и людей) могли одновременно писать код в разных зонах, а проверка каждой итерации стоила пропорционально размеру изменения, а не размеру системы.

Предметом не являются:

  • мультиагентная оркестрация как таковая: способ запуска агентов (субагенты, команды агентов, облачные задачи) — это исполнение, а не нарезка системы, и без границ в коде она порождает конфликты;
  • микросервисы: это один из способов провести границы, самый дорогой по эксплуатации;
  • spec-driven development (разработка от спецификаций): это способ постановки задач; здесь из него берутся только контракты и границы;
  • экономия счёта за API: при подписках главная цель — реже упираться в лимиты окна и недели и меньше делать ненужной работы.

1.2. Почему итерации медленные: модель цикла

Время одной итерации складывается из последовательных шагов: постановка задачи, сборка контекста агентом, генерация кода, автотесты и CI, ревью кода, ручная проверка человеком, интеграция с параллельной работой и, с некоторой вероятностью, переделка. ИИ резко сокращает только шаг генерации, а остальные шаги либо не меняются, либо растут, потому что кода и PR становится больше. Это следует из данных телеметрии: в командах с высоким внедрением ИИ выполнено на 21 % больше задач и слито на 98 % больше PR, но время ревью выросло на 91 %, а размер PR — на 154 % эмпирика [S1]. В отчёте 2026 года на 22 тыс. разработчиков медианное время ревью выросло на 441,5 %, а доля PR, слитых вообще без ревью, — на 31,3 % эмпирика [S2].

Авторская модель цикла (используется далее в разделах 4, 5, 8):

T_итерации ≈ T_постановка + T_контекст + T_генерация + T_тесты + T_ревью + T_ручная + T_интеграция
             + p_переделки × (T_итерации повторно)
Ускорение от N параллельных агентов ≤ 1 / (s + (1 − s) / N),
где s — доля последовательной работы (ревью, ручная проверка, интеграция, общая постановка).

Вторая строка — закон Амдала, применённый к разработке: если человек тратит на приёмку половину цикла (s = 0,5), то даже бесконечное число агентов ускорит работу не более чем вдвое гипотеза. Поэтому скорость за счёт параллелизма достигается только одновременным сокращением последовательной части: приёмки, интеграции и переделок, а не добавлением агентов.

Ощущение ускорения ненадёжно как метрика. В рандомизированном исследовании METR опытные разработчики с ИИ работали на 19 % медленнее, хотя ожидали ускорения на 24 % и после работы считали, что ускорились на 20 % эмпирика [S7]. METR также отмечает, что люди в среднем переоценивают влияние ИИ на своё время на 40 процентных пунктов эмпирика [S6].

1.3. Что даёт изоляция: механизм

Изоляция работает через четыре механизма, каждый из которых известен давно, но для агентов получил новое значение.

Механизм Классическое основание Что меняется для агентов
Сокрытие решений за интерфейсом Парнас: модуль прячет трудное или вероятно меняющееся решение; выгода — сокращение сроков, потому что «отдельные группы работают над модулями почти без общения» факт [S8] Агенту нужно прочитать зону и контракты соседей, а не всю систему; контекст — главный ограниченный ресурс агента вендор [S5]
Глубокие модули Остерхаут: простой интерфейс над сложной реализацией факт [S9] Узкий интерфейс = меньше токенов на понимание соседа и меньше мест для несовместимых решений гипотеза
Непересекающиеся множества записи Конфликты слияния возникают при правке общих файлов У одновременных PR однотипных агентов текстовые конфликты в 19,8 % случаев, у разных агентов — в 41,7 % эмпирика [S4]; команды агентов Claude Code не изолируются автоматически, поэтому работу делят так, чтобы каждый владел своим набором файлов вендор [S10]
Локальность проверки Выбор тестов по графу зависимостей (Nx affected, Bazel) факт [S11, S12] Перепроверяется затронутая зона, её потребители и контракты, а полный прогон переносится в фон

Контекст агента деградирует с ростом объёма: документация Claude Code прямо называет окно контекста самым важным ресурсом, а производительность модели падает по мере его заполнения вендор [S5]. Независимое исследование 18 моделей показало падение качества с ростом длины входа даже на простых задачах и сильное влияние тематически похожих, но нерелевантных фрагментов эмпирика [S13]. Отсюда следствие для архитектуры: зона, которую агент может прочитать целиком вместе с контрактами соседей в небольшой доле окна, дешевле и надёжнее в разработке, чем зона, требующая поиска по всему репозиторию гипотеза.

Закон Конвея утверждает, что организации производят проекты, копирующие их структуру коммуникаций факт [S14]. Для агентов его прямое следствие: границы доступа, инструменты и каналы обмена между агентами становятся швами получающейся архитектуры, поэтому структуру агентов выводят из желаемой структуры кода, а не наоборот мнение [S15, S16].

1.4. Составные части по уровням

Уровень Что входит Ключевые приёмы
Архитектура Зоны, их публичные API, направления зависимостей, события Ограниченные контексты DDD, модульный монолит с контролем зависимостей, порты и адаптеры, вертикальные срезы, контракт-первым факт [S17, S18, S19, S20, S21, S22]
Тесты Тесты зоны, контрактные тесты, сквозные трассы, выбор и кеширование Пирамида и её варианты, контракты потребителя, выбор по изменениям, герметичность факт [S23, S24, S25, S26, S27, S28, S11, S12]
Процесс Нарезка задач, изоляция агентов, слияние, приёмка Worktree и облачные задачи, магистральная разработка, малые партии, флаги функций факт [S29, S30, S31, S32, S33]
Контекст агентов Файлы правил, карты, субагенты, хуки, выбор модели CLAUDE.md и AGENTS.md, карта репозитория, субагенты, хуки-фильтры факт [S5, S34, S35, S36, S37]

1.5. Формальная сторона: правила зависимостей, влияния и совместимости

Граф зон. Зоны образуют ориентированный граф зависимостей, который обязан быть ацикличным; инструменты модульных монолитов проверяют это автоматически (Packwerk, Spring Modulith, import-linter, tach) факт [S18, S19, S20, S38]. Зона открывает наружу только публичный API; внутренности недоступны (в Spring Modulith это базовый пакет модуля против подпакетов, в tach — объявленные интерфейсы) факт [S19, S38].

Правило влияния. Множество перепроверки после изменения:

Перепроверить(Δ) = тесты(зоны, где Δ)
                 ∪ тесты(зон, зависящих от изменённого публичного API)   — только если API изменился
                 ∪ контрактные тесты этого API у всех потребителей
                 ∪ сквозные трассы, проходящие через изменённую границу
Полный прогон — по расписанию, перед релизом и при изменении общих основ (lock-файл, настройки, ядро).

Так работает Nx affected: изменённые файлы → проекты → зависящие от них проекты факт [S11]; так же Spring Modulith запускает тесты изменённого модуля и модулей, транзитивно от него зависящих, и отступает к полному прогону при изменении файлов сборки факт [S39]. Изменение lock-файла пакетного менеджера по умолчанию делает затронутыми все проекты Nx факт [S11]. Инструменты на графе проектов консервативнее приведённого правила: они перезапускают зависящие зоны при любом изменении, а оптимистичное условие «только если публичный API изменился» требует снимка API зоны и его сравнения (схема, сигнатуры) гипотеза.

Правило совместимости контракта. Добавление необязательного поля или нового сообщения совместимо, удаление, переименование и смена типа — несовместимы. Инструменты формализуют это для protobuf (категории FILE, PACKAGE, WIRE_JSON, WIRE) и OpenAPI факт [S40, S41]. Несовместимое изменение проводится как expand → migrate → contract: сначала интерфейс поддерживает старую и новую версии, затем мигрируют потребители, затем старая версия удаляется факт [S42]. Потребитель читает терпимо: берёт только нужные поля и игнорирует незнакомые (Tolerant Reader) факт [S43].

1.6. Анатомия потерь: шесть источников времени

Для каждого источника ниже указаны механизм, признаки и стратегии из каталога раздела 4 (коды A1–D8).

Ручная проверка человеком

  • Механизм. Агент останавливается, когда работа «выглядит готовой»; без исполняемой проверки человек сам становится циклом проверки, и каждая ошибка ждёт его внимания вендор [S5]. В проекте OpenAI, где код полностью писали агенты, узкое место сместилось с написания кода на ёмкость QA людей вендор [S44, S45].
  • Как распознать. Человек открывает приложение после каждой задачи; задачи висят в статусе «ждёт проверки»; одна и та же проверка повторяется руками.
  • Что закрывает. B6 (эталонные тесты и скриншоты), C6 (приёмка по доказательствам и автоматическим гейтам), B1 (сквозные трассы как тесты), C9 (критерии приёмки в постановке).

Долгие автотесты и CI

  • Механизм. Полный прогон стоит одинаково для правки в одну строку и для большой фичи; при выборе по зависимостям в монорепозитории выбирается до четверти всех тестов, а большинство из них не находит регрессий факт [S27]. Нестабильные тесты добавляют повторные прогоны и ложные сигналы; 75 % нестабильных тестов падают кластерами с общей причиной эмпирика [S46].
  • Как распознать. Время CI растёт линейно с размером системы; агенты запускают весь набор тестов после каждой правки; повторный запуск «пока не позеленеет».
  • Что закрывает. B3 (выбор тестов), B4 (кеш), B5 (изолированные окружения), B7 (карантин нестабильных), A4 (порты и адаптеры для быстрых тестов ядра), B9 (уровни прогона).

Ревью кода

  • Механизм. Больше PR и крупнее PR при прежнем числе ревьюеров: время ревью +91 % и размер PR +154 % в 2025 году [S1], медианное время ревью +441,5 % в 2026 году [S2] эмпирика. DORA описывает спираль: тяжёлое ревью заставляет копить изменения, а большие ревью откладываются из-за сложности факт [S31]. Практик, работающий с несколькими агентами, формулирует ограничение так: он может ревьюить и сливать только одно значимое изменение за раз мнение [S47].
  • Как распознать. Растёт время до первого ревью; PR от агентов крупнее человеческих; ревьюер пропускает части диффа.
  • Что закрывает. C3 (малые партии), C5 (стекированные изменения), C6 (независимый агент-ревьюер и ревью по риску), A3 (линтер границ снимает архитектурные замечания с человека), C1 (задача в одной зоне).

Поломки на стыках после параллельной работы

  • Механизм. Параллельные агенты принимают неявные несовместимые решения; действия несут неявные решения, и конфликтующие решения дают плохой результат мнение [S48]. Среди 142 тыс. PR агентов 27,67 % имели конфликты слияния эмпирика [S49]; около 42 % конфликтов структурные (изменение против удаления, одновременное добавление) эмпирика [S4]. В таксономии отказов мультиагентных систем целая категория — рассогласование между агентами эмпирика [S50].
  • Как распознать. Каждый PR по отдельности зелёный, а после слияния падают сквозные сценарии; повторяются правки одних и тех же общих файлов; интеграция занимает больше, чем разработка.
  • Что закрывает. A7 (контракт-первым), B2 (контракты потребителя), A8 (заглушки по контракту), A3 (контроль зависимостей), A11 (устранение горячих общих файлов), C2 (изоляция агентов), C7 (одна точка интеграции).

Переделки из-за неточной постановки

  • Механизм. Агент решает не ту задачу, если постановка не содержит критериев проверки и границ; Anthropic рекомендует разделять исследование, план и реализацию именно для того, чтобы не решать неправильную задачу вендор [S5]. Среди отклонённых PR агентов 23 % — дубликаты уже сделанной работы и 4 % — нежелательная функциональность эмпирика [S51].
  • Как распознать. Больше двух исправлений подряд в одной сессии; доля PR, требующих доработки человеком (в выборке Claude Code — 45,1 % слитых PR) эмпирика [S52]; задачи возвращаются с формулировкой «не то».
  • Что закрывает. C9 (спецификация и интервью до кода), C1 (карточка задачи с критериями и «чего не делать»), B1 (тест как критерий), A1 (паспорт зоны).

Повторное чтение кода и сборка контекста агентом

  • Механизм. Каждая новая сессия заново изучает репозиторий; длинная сессия пересылает всю историю с каждым запросом, поэтому однострочный вопрос в сессии, открытой весь день, расходует лимит на весь разговор вендор [S37]. Мультиагентные системы расходуют около 15x токенов чата, одиночные агенты — около 4x вендор [S53].
  • Как распознать. Большая доля токенов уходит на чтение файлов до первой правки; агент ищет по всему репозиторию то, что описано в одном месте; в /usage отмечены длинный контекст и промахи кеша вендор [S37].
  • Что закрывает. D1 (короткие иерархические файлы правил), D2 (карта зон и паспорта зон), D3 (размер зоны под окно), D4 (субагенты для исследования), D5 (хуки и скрипты), D7 (гигиена сессий).

1.7. Классификация «глупой» работы

«Глупая» работа — действия агента или человека, которых при другой организации процесса не было бы. Классификация ниже авторская, по аналогии с потерями бережливого производства; примеры и доли взяты из источников гипотеза.

Вид потерь Как выглядит Причина Где устраняется
Пересборка контекста Новая сессия заново читает 30 файлов, чтобы понять зону Нет карты зон и паспорта зоны D1, D2, D3
Раздутый постоянный контекст Длинный CLAUDE.md, десяток MCP-серверов в каждой сессии Всё «на всякий случай» D1; Anthropic советует держать CLAUDE.md до ~200 строк и переносить редкое в skills вендор [S37]
Перепроверка незатронутого Полный прогон после правки одной зоны Нет графа зон и выбора тестов B3, B4, B9
Ожидание PR ждёт ревью часами, агент простаивает Ревью — единственный гейт C3, C5, C6
Дубли и брошенная работа Два агента сделали одно и то же; PR брошен Нет владельца очереди задач C1, C8; 38 % отклонённых PR агентов брошены без участия ревьюера, 23 % — дубликаты эмпирика [S51]
Стыковые переделки Фронтенд и сервер по-разному поняли поле Контракт устный или неявный A7, A8, B2
Переделка из-за постановки Сделано «не то» Нет критериев приёмки и запретов C9, C1
Рассуждение вместо скрипта Модель читает 10 тыс. строк лога Нет фильтра или генератора D5; хук может сократить контекст с десятков тысяч токенов до сотен вендор [S37]
Погоня за замечаниями ревьюера Агент-ревьюер находит «пробелы», их чинят, код переусложняется Ревьюеру не заданы критерии значимости C6; Anthropic предупреждает о переусложнении при погоне за каждым замечанием вендор [S5]
Нестабильные тесты Перезапуск CI до зелёного Общие ресурсы, сеть, время B5, B7
Дрейф и дублирование кода Копии вместо переиспользования Агент не видит существующего C10, D2; доля перемещённого кода упала с 25 % до <10 %, копипаста выросла с 8,3 % до 12,3 % в 2021–2024 эмпирика [S54]
Дорогая модель на простой задаче Флагманская модель переименовывает переменные Одна модель на всё D6
Промахи кеша Возврат к сессии после часа паузы пересчитывает весь контекст TTL кеша на подписке — час вендор [S37] D7

1.8. Что не видно в постановке задачи

Ниже векторы оптимизации, которые не названы в исходной формулировке, но по источникам дают сопоставимый или больший эффект, чем нарезка на зоны.

Вектор Что это Почему важно Где раскрыто
Приёмка — главное узкое место Оптимизировать проверку и ревью, а не генерацию Рост ревью съедает выигрыш генерации эмпирика [S1, S2]; закон Амдала ограничивает ускорение от числа агентов гипотеза 1.2, 4 (C6), 8
Малые партии Задача на часы, PR на сотни строк DORA называет малые партии противовесом нестабильности от ИИ мнение [S32]; неслитые PR агентов крупнее слитых эмпирика [S51] 4 (C3), 5
Лимиты тратятся на контекст, а не на код Свежая сессия на задачу, субагенты для шумной работы, кеш Длинный контекст, промахи кеша, субагенты и команды агентов — главные статьи расхода; команды агентов ~7x токенов вендор [S37] 10, 4 (D-блок)
Детерминированные инструменты вместо рассуждений Генераторы, линтеры, хуки, скрипты проверки Сообщение линтера может сразу содержать инструкцию исправления вендор [S44]; хук-фильтр экономит порядки токенов вендор [S37] 4 (D5, A3), 6
Тест как постановка Сначала тест или эталон, потом код Тесты в промпте повышают долю решённых задач эмпирика [S55]; исполняемая проверка замыкает цикл без человека вендор [S5] 4 (B1, B6), 6
Горячие общие файлы Реестры, маршрутизаторы, настройки, миграции, lock-файлы Структурные конфликты — ~42 % всех конфликтов агентов эмпирика [S4] 4 (A11), 5
Очередь задач с владельцем Одна очередь, WIP-лимит, никакой самодеятельности агентов Дубли и брошенные PR — большинство разобранных отказов эмпирика [S51] 4 (C1, C8), 8
Уборка энтропии Регулярные фоновые задачи против дрейфа Рост дублирования кода эмпирика [S54]; «сборка мусора» в проекте OpenAI вендор [S44] 4 (C10)
Замер вместо ощущения Метрики цикла, а не впечатление Ошибка самооценки до 40 п. п. эмпирика [S6] 8
Параллелизм по ёмкости внимания Число одновременных агентов = число результатов, которые человек успевает принять Узкое место ревью у практиков мнение [S47] 5, 10

Актуальность и доказательная база на дату среза

2.1. Распространённость и тренд

Тренд растущий по всем сегментам. ИИ в разработке стал нормой, а параллельный запуск агентов — штатной функцией всех ведущих инструментов:

  • DORA 2025: почти 5000 респондентов, 90 % используют ИИ в работе, более 80 % считают, что он повысил их продуктивность, 30 % мало или совсем не доверяют сгенерированному коду эмпирика [S56];
  • Faros 2026: 80 % команд превышают порог 50 % еженедельно активных пользователей ИИ, доля принятых предложений выросла с 20 % до 60 % эмпирика [S2];
  • METR в 2026 году столкнулся с тем, что разработчики отказываются работать без ИИ, а 30–50 % участников не отправляли задачи, которые не хотели делать без ИИ эмпирика [S57]; в опросе 349 технических специалистов половина регулярно использует Claude Code эмпирика [S6];
  • формат AGENTS.md используют более 60 тыс. открытых проектов, его поддерживают Codex, Jules, Devin, агент Copilot, Cursor, Aider и другие инструменты вендор [S34];
  • наборы данных PR, созданных агентами: 33 596 PR пяти агентов за декабрь 2024 — июль 2025 [S51, S4] и более 142 тыс. PR [S49] факт;
  • параллельные режимы есть у Claude Code (worktree, субагенты, команды агентов, фоновые сессии) [S58], Codex cloud [S30], Cursor cloud agents [S59], агента GitHub Copilot [S60], Jules [S61], Devin [S62], Kiro с параллельными волнами задач [S63] факт.

Сегменты: у одиночных разработчиков и малых команд параллельные сессии в worktree стали массовой практикой по описаниям практиков мнение [S47]; у крупных организаций данные телеметрии показывают рост объёма работы при ухудшении стабильности эмпирика [S2]. Доли по сегментам в процентах источники не дают.

2.2. Эффект ИИ на скорость: исследования

Исследование Дизайн и выборка Результат Ограничения
METR, 2025 [S7] РКИ, 16 опытных разработчиков открытых проектов, 246 задач в своих репозиториях, Cursor с Claude 3.5/3.7 Замедление на 19 %; ожидали +24 %, после работы считали +20 % эмпирика [S7] Малая выборка, знакомые большие кодовые базы, инструменты начала 2025 года
METR, обновление 2026 [S57] 57 разработчиков, 143 репозитория, 800+ задач Вернувшиеся участники: −18 % (ДИ от −38 % до +9 %), новые: −4 % (ДИ от −15 % до +9 %) эмпирика [S57] Сильный эффект отбора; сам METR считает, что результат недооценивает ускорение, и меняет дизайн
Google, 2024 [S64] РКИ, 96 инженеров, одна сложная корпоративная задача ~21 % быстрее, широкий доверительный интервал эмпирика [S64] Одна задача, внутренние инструменты лета 2024 года
Microsoft, Accenture, Fortune 100 [S65] Три полевых РКИ, 4867 разработчиков +26,08 % завершённых задач (SE 10,3 %), больше у менее опытных эмпирика [S65] Автодополнение, а не агенты
Стэнфорд, доклад Y. Denisov-Blanch (пересказ) [S66] ~100 тыс. разработчиков, 600+ компаний, оценка коммитов алгоритмом Чистый выигрыш ~15–20 %; 30–40 % на простых новых задачах, 0–10 % на сложных в существующем коде; выигрыш резко падает с ростом кодовой базы эмпирика [S66] Доклад, а не рецензируемая статья; прочитан пересказ
METR, опрос 2026 [S6] 349 специалистов, удобная выборка Самооценка ценности 1,4–2x, скорости 3x эмпирика [S6] Самооценки систематически завышены

Выводы из таблицы гипотеза: эффект положителен на изолированных, чётко заданных задачах и падает на сложных задачах в больших знакомых кодовых базах. Это прямо поддерживает тезис об изоляции: чем меньше и понятнее зона, в которой работает агент, тем ближе задача к «новой и простой».

2.3. Эффект на стабильность, качество и переделки

  • DORA 2024: рост внедрения ИИ на 25 % связан со снижением пропускной способности поставки на 1,5 % и стабильности на 7,2 % эмпирика [S3]; DORA 2025: внедрение ИИ положительно связано с пропускной способностью и отрицательно — со стабильностью эмпирика [S56].
  • Faros 2025 (10 тыс.+ разработчиков, 1255 команд, корреляционный анализ): +21 % задач, +98 % PR, +91 % время ревью, +154 % размер PR, +9 % багов на разработчика эмпирика [S1].
  • Faros 2026 (22 тыс. разработчиков, 4000+ команд, сравнение периодов низкого и высокого внедрения внутри организаций): +66 % эпиков, +33,7 % задач, +54 % багов на разработчика, отношение инцидентов к PR +242,7 %, отток кода +861 %, PR без ревью +31,3 %, ежедневные контексты PR на разработчика +67,4 % эмпирика [S2].
  • GitClear (211 млн изменённых строк, 2020–2024, корреляция): доля рефакторинга и перемещённого кода упала с 25 % до менее 10 %, копипаста выросла с 8,3 % до 12,3 % эмпирика [S54].
  • PR агентов: из 33 596 PR слито 71,48 %; неслитые крупнее, затрагивают больше файлов и чаще падают в CI; среди 600 вручную разобранных отклонённых PR 38 % брошены без участия ревьюера, 23 % — дубликаты, 17 % — падения CI/тестов эмпирика [S51]. В выборке 567 PR Claude Code слито 83,8 %, из них 54,9 % без правок эмпирика [S52].
  • Конфликты: 27,67 % PR агентов с конфликтами слияния эмпирика [S49]; 19,8 % текстовых конфликтов у одновременных PR однотипных агентов и 41,7 % у разных, ~42 % конфликтов структурные эмпирика [S4].

2.4. Параллельность и мультиагентность

  • Anthropic: агенты расходуют ~4x токенов чата, мультиагентные системы ~15x; в оценке исследовательского агента объём токенов объяснял 80 % дисперсии качества; мультиагентность плохо подходит задачам с общим контекстом и многими зависимостями, и кодинг приведён как пример вендор [S53].
  • Cognition (Devin): параллельные субагенты без общего контекста принимают конфликтующие неявные решения; рекомендован однопоточный агент со сжатием контекста мнение [S48].
  • MAST: 1600+ трасс семи мультиагентных фреймворков, 14 видов отказов в трёх категориях — проектирование системы, рассогласование агентов, проверка задачи эмпирика [S50].
  • Claude Code: команды агентов расходуют примерно в 7 раз больше токенов, чем обычная сессия, когда участники работают в режиме плана; рекомендовано 3–5 участников и 5–6 задач на участника вендор [S37, S10].
  • Кейс OpenAI (harness engineering): команда из 3, затем 7 инженеров за 5 месяцев выпустила ~1 млн строк и ~1500 PR, 3,5 PR в день на инженера, без ручного кода; архитектура закреплена слоями и линтерами вендор [S44, S45]. Оригинал недоступен (403), данные из двух независимых конспектов факт [S67].

Контролируемых исследований, которые сравнивали бы архитектуры (модульная против немодульной) по продуктивности агентов, не найдено. Связь «изоляция → скорость агентов» опирается на косвенные данные гипотеза: падение выигрыша с ростом кодовой базы [S66], деградацию качества с ростом контекста [S13], данные о конфликтах [S4, S49] и классические аргументы модульности [S8].

2.5. Тестирование без полного прогона

  • Meta: предиктивный выбор тестов ловит более 99,9 % регрессий, запуская около трети тестов, транзитивно зависящих от изменения, и вдвое повышает эффективность тестовой инфраструктуры эмпирика [S27]. Это внутренняя система вендора с огромной историей прогонов; переносимость на малые проекты не показана.
  • CloudBees Smart Tests (бывший Launchable) заявляет сокращение времени выполнения тестов «до 80 %» вендор [S68].
  • Нестабильность: 75 % нестабильных тестов падают кластерами, в промышленном кейсе разработчики тратили 1,28 % времени на их починку эмпирика [S46].
  • Тесты как постановка: добавление тестов к условию задачи повышает долю решённых задач у GPT-4 и Llama 3 на MBPP и HumanEval эмпирика [S55].
  • Горизонт задач: METR измеряет длительность задач, которые агент решает с вероятностью 50 %, на чётко заданных задачах и предупреждает, что на реальных работах с неясными критериями успех ниже факт [S69].

2.6. Практическая база и вендорские данные

  • Стоимость: средний расход Claude Code в корпоративных развёртываниях около $13 на разработчика в активный день и $150–250 в месяц, у 90 % пользователей ниже $30 в день вендор [S37].
  • Лимиты подписок: окно 5 часов плюс недельный лимит у Claude Max [S70]; у Codex локальные сообщения и облачные задачи делят один лимит, число сообщений за 5 часов зависит от модели на порядок вендор [S71].
  • Shopify: монолит 2,8 млн строк Ruby, 37 компонентов, Packwerk проверяет зависимости за минуты вендор [S18]; ретроспектива 2024 года: проверки приватности удалены, разработчики группируют код по смысловым признакам, мало связанным с фактическим исполнением вендор [S72].
  • Devin: задачи до ~3 часов человеческой работы с явными критериями успеха вендор [S62].

2.7. Мнения отрасли

Позиция Кто Аргумент
Модульный монолит вместо микросервисов Fowler, Shopify Неверные границы между сервисами дорого исправлять; распределённость — наценка мнение [S73, S74, S18]
Малые партии и магистральная разработка обязательны при ИИ DORA ИИ провоцирует крупные изменения, которые трудно ревьюить и интегрировать мнение [S31, S32]
ИИ — усилитель существующих практик DORA 2025 Сильные платформы и практики дают больший выигрыш эмпирика [S56]
Сильные основы не защищают Faros 2026 Деградация ниже по потоку наблюдается и у зрелых организаций эмпирика [S2]
Против мультиагентности в кодинге Cognition, Anthropic для задач с общим контекстом Неявные решения и общий контекст мнение [S48, S53]
Скепсис к тяжёлым SDD-процессам Böckeler Избыточны для мелких задач, markdown тяжело ревьюить, агенты не всегда следуют спецификации мнение [S75]
Модули по фактическому исполнению, а не по смыслу Shopify Семантические пакеты не дают реальной изоляции вендор [S72]

2.8. Главные споры

  1. Ускоряет ли ИИ опытных разработчиков в знакомом большом коде. РКИ METR показало замедление эмпирика [S7], РКИ Google и Microsoft — ускорение эмпирика [S64, S65]; различаются задачи (своя сложная кодовая база против изолированной задачи) и инструменты.
  2. Один агент с хорошим контекстом или много агентов. Anthropic использует мультиагентность для исследований и оговаривает её слабость в кодинге вендор [S53], Cognition против мнение [S48], документация Claude Code советует команды агентов для исследования, ревью и независимых модулей вендор [S10].
  3. Ревью человеком или агентом. В кейсе OpenAI ревью сдвинуто к агент-агент вендор [S45]; Faros фиксирует рост PR без ревью вместе с ростом инцидентов эмпирика [S2].
  4. Спецификация как источник истины или код. Böckeler сравнивает spec-as-source с неудачами модельно-ориентированной разработки мнение [S75].

2.9. Что изменилось за 2023–2026 годы

  • Генерация кода подешевела до почти нулевой предельной стоимости, а проверка, ревью и интеграция стали доминирующими статьями времени эмпирика [S1, S2].
  • Появились фоновые и облачные агенты, работающие параллельно в изолированных средах, и встроенная изоляция worktree в Claude Code факт [S30, S60, S59, S29].
  • Подписки получили окна лимитов (5 часов и неделя), поэтому экономия контекста стала вопросом доступности работы, а не только денег факт [S70, S71].
  • Сложился стандарт файлов правил AGENTS.md и инструменты spec-driven development факт [S34, S76, S63].

Следствие для выводов: архитектура, оптимизированная под параллельную агентную работу, оптимизирует прежде всего стоимость проверки и интеграции, а не стоимость написания кода гипотеза.

Где применимо и где нет, плюсы и минусы

Ниже «предмет» — зонная архитектура для агентов: модульный монолит (или монорепозиторий) с контрактами между зонами, автоматическим контролем зависимостей, выбором тестов по графу зон и параллельными агентами в изолированных копиях.

Подходит, когда

  • В системе есть устойчивые подобласти с разным языком и темпом изменений (арендаторы и доступ, биллинг, уведомления, отчёты, интеграции). Границы ограниченных контекстов проходят там, где меняются язык и модель факт [S17], поэтому зоны получаются стабильными и не требуют постоянного пересмотра.
  • Одновременно работают два и более агента или человека. Без непересекающихся множеств файлов конфликты возникают в 19,8–41,7 % одновременных PR агентов эмпирика [S4]; зоны делают множества записи раздельными по построению.
  • Полный прогон тестов заметно дольше цикла агента (ориентир: больше 5–10 минут, гипотеза). Тогда выбор тестов по зонам окупает настройку графа, как в Nx affected и Spring Modulith факт [S11, S39].
  • Веб-приложение с фоновыми задачами. Очереди, воркеры и задачи по расписанию — естественные асинхронные границы с явными сообщениями, которые описываются схемой (AsyncAPI) и тестируются без запуска всей системы факт [S77, S39].
  • Кодовая база растёт, и выигрыш от ИИ падает. По пересказу стэнфордских данных выигрыш резко снижается с ростом кодовой базы и сложности эмпирика [S66]; зона возвращает агенту «маленькую кодовую базу» гипотеза.
  • Существующая система с болезненными конфликтами и долгим CI. Модульный монолит внедряется постепенно, с фиксацией текущих нарушений и запретом новых, как делал Shopify вендор [S18, S72].

Не подходит, когда

  • Домен ещё не понятен (прототип, поиск продукта). Ранние границы почти наверняка окажутся неверными; Fowler указывает, что установить правильные ограниченные контексты трудно даже опытным архитекторам мнение [S73]. Лучше один агент в одной сессии и быстрый выброс кода.
  • Система маленькая, полный прогон занимает секунды (ориентир: до ~10 тыс. строк, гипотеза). Контракты, графы и паспорта зон стоят дороже, чем экономят.
  • Изменение по своей природе сквозное (обновление фреймворка, переименование по всей системе, миграция стиля). Здесь подходит веерная раздача однотипной правки по файлам (/batch на 5–30 субагентов в worktree факт [S58]) или один агент, а не зоны.
  • Узкое место — продуктовые решения, а не код. Если задачи ждут решения человека, параллельные агенты производят невостребованную работу; 38 % отклонённых PR агентов брошены без участия ревьюера эмпирика [S51].
  • Нет CI и автотестов. Без исполняемой проверки зоны не дают локальной приёмки, и человек остаётся циклом проверки вендор [S5].

Плюсы

  • Параллельность без конфликтов. Каждый агент пишет только в свою зону и свой пакет тестов; общие файлы вынесены или генерируются.
  • Короткий цикл проверки. Прогоняются тесты зоны, контракты и затронутые трассы; полный прогон уходит в фон и по расписанию факт [S11, S39].
  • Меньше токенов на задачу. Агент читает паспорт зоны, её код и контракты соседей вместо поиска по репозиторию; контекст — главный ресурс агента вендор [S5, S78].
  • Локальное ревью. Дифф ограничен зоной, архитектурные нарушения ловит линтер, человек смотрит смысл, а не границы гипотеза; линтеры границ существуют для Python и TypeScript факт [S20, S79].
  • Работа до готовности соседа. Заглушки и мок-серверы по контракту позволяют начинать зоны одновременно факт [S80, S21].
  • Ограниченный радиус поражения. Ошибка агента остаётся внутри зоны и её тестов гипотеза.

Минусы

  • Стоимость проектирования на входе. Нужно нарезать зоны, написать контракты и настроить контроль зависимостей; для новой системы это дни работы (оценка в разделе 5) гипотеза.
  • Неверные границы дорого переносить. В монолите дешевле, чем между сервисами мнение [S73], но перенос ответственности между зонами требует смены контрактов и тестов.
  • Семантические границы могут не совпасть с исполнением. Shopify обнаружил, что разрешение нарушений Packwerk не гарантирует работающую изолированную систему вендор [S72].
  • Выбор тестов может пропустить регрессию. Покрытие не отслеживает статические файлы и внешние сервисы факт [S28], поэтому обязателен регулярный полный прогон.
  • Изменение контракта сериализует работу. Пока версия контракта не согласована, зоны-потребители ждут; нужна дисциплина expand → contract факт [S42].
  • Дублирование между зонами. Изоляция поощряет копии вспомогательного кода гипотеза; рост клонов кода уже наблюдается при ИИ эмпирика [S54].
  • Кеш и выбор тестов требуют герметичности. Недетерминированная генерация файлов, системные бинарники и правка исходников во время сборки ломают кеш факт [S12].

Альтернативы и дерево решений

Раздел состоит из пяти частей: сравнение предмета с альтернативами (4.1), каталог стратегий (4.2), сводная матрица стратегий (4.3), разбор альтернатив (4.4) и дерево решений.

4.1. Предмет и альтернативы: сравнительная таблица

Предмет сравнения — зонная архитектура для агентов (раздел 3). Альтернативы того же класса — другие способы получить скорость разработки с агентами.

Вариант Потенциал параллельности Стоимость проверки итерации Расход лимитов Цена входа Эксплуатационная цена Риск ошибок границ Соло Команда до 10
Зонная архитектура: модульный монолит + контракты + выбор тестов + изолированные агенты высокий низкая (зона + контракты) низкий–средний средняя низкая средний, дёшево исправлять да да
Однопоточная итеративная работа с одним агентом и полным прогоном низкий высокая, растёт с системой средний нулевая низкая нет да, до роста системы нет
Микросервисы с контрактными тестами высокий низкая на сервис, высокая на интеграцию средний высокая высокая высокий, дорого исправлять нет редко
Микрофронтенды + BFF средний (фронтенд) средняя средний высокая высокая средний нет при нескольких фронтенд-командах
SDD-конвейер (Spec Kit, Kiro) с параллельными волнами задач без контроля границ средний средняя средний–высокий (много markdown) низкая низкая высокий (границы не проверяются) для крупных фич для крупных фич
Оркестрация многих агентов (команды агентов) поверх неразрезанного кода средний, падает от конфликтов высокая высокий (~7–15x) низкая средняя высокий нет для исследования и ревью
Предиктивный выбор тестов и распределённый CI без архитектурной изоляции низкий–средний средняя низкий средняя–высокая средняя не решает нет при большом наборе тестов
Облачные фоновые агенты «по тикету» как основной режим средний–высокий средняя средний низкая низкая высокий без границ да, для рутинных задач да, для рутинных задач

Оценки в таблице — авторский синтез по источникам раздела 2 и каталогу 4.2 гипотеза; числа расхода токенов — по данным Anthropic вендор [S37, S53].

4.2. Каталог стратегий

Шкала влияния: «сильное», «среднее», «слабое». Поле «Доказанность» отделяет эмпирику от практики вендоров, мнений и гипотез. Коды A — архитектура, B — тесты, C — процесс, D — контекст агентов и лимиты.

Блок A. Архитектура.

A1. Зоны по сокрытию решений и паспорт зоны

  • Проблема. Неясно, где кончается ответственность куска кода; изменения расползаются по системе, агенту приходится читать всё.
  • Как работает. Систему режут по решениям, которые вероятно изменятся (платёжный провайдер, тарифная модель, канал уведомлений), а не по шагам обработки. У каждой зоны есть паспорт: назначение, «чего зона не делает», публичный API, разрешённые зависимости, команды тестов, владелец (шаблон в разделе 6).
  • Уровень. Архитектура.
  • Параллельность. Сильное влияние: задача попадает в одну зону.
  • Время тестов. Среднее: задаёт единицу выбора тестов.
  • Лимиты и лишняя работа. Сильное: паспорт заменяет разведку репозитория.
  • Цена внедрения. Часы на зону в новой системе; дни или недели на существующую.
  • Риски. Нарезка «по смыслу» может не совпасть с фактическими вызовами вендор [S72].
  • Когда не применять. Прототип с неясным доменом.
  • Инструменты. Markdown-паспорта, вложенные AGENTS.md в папках зон факт [S34].
  • Доказанность. Классический аргумент Парнаса о сокращении сроков за счёт независимых групп факт [S8]; прямых измерений для агентов нет гипотеза.

A2. Ограниченные контексты и карта контекстов

  • Проблема. Одна общая модель данных порождает противоречивые смыслы одних и тех же слов («клиент», «заказ») факт [S17].
  • Как работает. Границы проводят там, где меняется язык предметной области; карта контекстов фиксирует отношения между контекстами и способы трансляции понятий факт [S17].
  • Уровень. Архитектура и организация.
  • Параллельность. Сильное влияние на верхнем уровне нарезки.
  • Время тестов. Среднее.
  • Лимиты и лишняя работа. Среднее: словарь зоны снижает недопонимание в промптах гипотеза.
  • Цена внедрения. Дни на разбор домена.
  • Риски. Неверные контексты в новом домене мнение [S73].
  • Когда не применять. Небольшое CRUD-приложение с одним языком.
  • Инструменты. Карта контекстов в markdown или диаграмме.
  • Доказанность. Мнение практиков мнение [S17, S73].

A3. Модульный монолит с автоматическим контролем зависимостей

  • Проблема. Границы стираются: агент импортирует внутренности соседа, потому что так короче.
  • Как работает. Модули живут в одном развёртывании; линтер в CI запрещает импорт внутренностей, циклы и незаявленные зависимости; существующие нарушения фиксируются списком и не растут факт [S18, S20, S38].
  • Уровень. Архитектура и CI.
  • Параллельность. Сильное.
  • Время тестов. Среднее: даёт граф для выбора тестов; Spring Modulith запускает тесты только изменённых модулей и их зависимых факт [S39].
  • Лимиты и лишняя работа. Сильное: сообщение линтера учит агента без участия человека; в проекте OpenAI линтеры писались так, чтобы текст ошибки был инструкцией по исправлению вендор [S44].
  • Цена внедрения. Часы на настройку; недели на разбор старых нарушений.
  • Риски. Смысловые пакеты не гарантируют изоляцию исполнения; динамические импорты не отслеживаются вендор [S72].
  • Когда не применять. Нужны независимые развёртывание и масштабирование частей — тогда A10.
  • Инструменты. import-linter и tach для Python и Django, Packwerk для Ruby, Spring Modulith для Java, правило границ Nx для TypeScript факт [S20, S38, S18, S19, S79].
  • Доказанность. Кейсы Shopify и OpenAI вендор [S18, S72, S44]; контролируемых исследований нет.

A4. Порты и адаптеры

  • Проблема. Бизнес-логика смешана с БД, HTTP и брокером, поэтому тесты медленные и требуют окружения.
  • Как работает. Ядро зоны общается с миром через порты; к порту подключаются адаптеры — БД, HTTP, очередь, тестовая обвязка, хранилище в памяти; приложение можно запускать без UI и БД для регрессионных тестов факт [S21].
  • Уровень. Архитектура и тесты.
  • Параллельность. Среднее: адаптер соседа заменяется фейком.
  • Время тестов. Сильное: ядро тестируется за секунды.
  • Лимиты и лишняя работа. Среднее: короткие выводы тестов.
  • Цена внедрения. Среднее: дополнительные интерфейсы.
  • Риски. Мелкие абстракции-прокладки без смысла; Bogard критикует избыточные слои мнение [S22].
  • Когда не применять. Тонкие CRUD-зоны без логики.
  • Инструменты. Средства языка; фейки в памяти.
  • Доказанность. Паттерн и мнение практиков мнение [S21].

A5. Вертикальные срезы внутри зоны

  • Проблема. Горизонтальные слои (контроллеры, сервисы, репозитории) заставляют каждую фичу править общие файлы слоёв.
  • Как работает. Фича — папка со своим обработчиком, схемой и тестами; минимум связности между срезами, максимум внутри среза мнение [S22].
  • Уровень. Архитектура внутри зоны.
  • Параллельность. Сильное: два агента на двух фичах одной зоны не трогают одних файлов.
  • Время тестов. Среднее: тесты среза.
  • Лимиты и лишняя работа. Сильное: агент читает одну папку.
  • Цена внедрения. Низкая для нового кода.
  • Риски. Дублирование между срезами; требует навыка рефакторинга мнение [S22].
  • Когда не применять. Много общей доменной логики, которую срезы начнут копировать.
  • Инструменты. Структура папок, генератор среза (D5).
  • Доказанность. Мнение практиков мнение [S22].

A6. События и фоновые задачи как граница

  • Проблема. Синхронные вызовы связывают зоны по времени ответа, отказам и тестам.
  • Как работает. Зона публикует доменное событие со схемой; воркеры и задачи по расписанию подписываются; контракт — схема сообщения плюс гарантии (доставка не менее одного раза, идемпотентность обработчика, порядок) гипотеза. AsyncAPI описывает каналы, сообщения, производителей и потребителей факт [S77].
  • Уровень. Архитектура.
  • Параллельность. Сильное: производитель и потребитель разрабатываются по схеме независимо.
  • Время тестов. Сильное: сценарий «опубликовать событие → дождаться результата» проверяет зону без остальной системы, как в Scenario API Spring Modulith факт [S39].
  • Лимиты и лишняя работа. Среднее.
  • Цена внедрения. Средняя: брокер, повторы, идемпотентность.
  • Риски. Итоговая согласованность, более трудная отладка, скрытая связность через состав события.
  • Когда не применять. Нужен немедленный согласованный ответ пользователю.
  • Инструменты. AsyncAPI, события Spring Modulith факт [S77, S39].
  • Доказанность. Инструменты описаны в документации факт [S77, S39]; эффект на скорость агентов — гипотеза.

A7. Контракт-первым: машиночитаемая схема и проверка совместимости

  • Проблема. Агенты фронтенда, сервера и воркера по-разному понимают интерфейс.
  • Как работает. Сначала пишется схема (OpenAPI, JSON Schema, AsyncAPI, protobuf) в пакете контрактов; из неё генерируются типы и клиенты; CI сравнивает схему с предыдущей версией и блокирует несовместимые изменения факт [S40, S41].
  • Уровень. Архитектура и CI.
  • Параллельность. Сильное.
  • Время тестов. Среднее: проверка схемы идёт секунды.
  • Лимиты и лишняя работа. Сильное: схема — компактный контекст вместо кода соседа гипотеза.
  • Цена внедрения. Низкая–средняя.
  • Риски. Проверка по схеме не доказывает, что потребитель вызывает поставщика правильно факт [S26].
  • Когда не применять. Вызовы внутри одной зоны.
  • Инструменты. buf breaking, oasdiff, генераторы клиентов факт [S40, S41].
  • Доказанность. Инструменты описаны в документации факт [S40, S41]; эффект — гипотеза.

A8. Заглушки и фейки по контракту

  • Проблема. Зона-потребитель ждёт готовности зоны-поставщика.
  • Как работает. Мок-сервер из OpenAPI, фейк-адаптер порта в памяти, фикстуры событий; потребитель разрабатывается против заглушки, затем подключается реальный поставщик факт [S80, S21].
  • Уровень. Тесты и процесс.
  • Параллельность. Сильное.
  • Время тестов. Сильное для тестов потребителя.
  • Лимиты и лишняя работа. Среднее.
  • Цена внедрения. Низкая.
  • Риски. Заглушка расходится с поставщиком; закрывается контрактными тестами B2.
  • Когда не применять. Поставщик уже готов и стабилен.
  • Инструменты. Prism (мок и прокси-валидация) факт [S80].
  • Доказанность. Инструменты описаны в документации факт [S80]; эффект — гипотеза.

A9. Версии контрактов и expand → contract

  • Проблема. Несовместимое изменение ломает параллельную работу всех потребителей.
  • Как работает. По умолчанию только совместимые (добавляющие) изменения; несовместимое — новая версия рядом со старой, миграция потребителей, удаление старой факт [S42]; потребители читают терпимо факт [S43]; изменение оформляется записью решения со статусом факт [S81].
  • Уровень. Архитектура и процесс.
  • Параллельность. Сильное: потребители мигрируют независимо.
  • Время тестов. Среднее.
  • Лимиты и лишняя работа. Слабое.
  • Цена внедрения. Низкая–средняя, временное дублирование.
  • Риски. Забытые старые версии.
  • Когда не применять. Потребитель один и меняется в том же PR.
  • Инструменты. buf, oasdiff, ADR факт [S40, S41, S81].
  • Доказанность. Устоявшаяся практика мнение [S42].

A10. Микросервисы и микрофронтенды

  • Проблема. Нужны независимые развёртывание, масштабирование или технологический стек частей.
  • Как работает. Компоненты вне процесса со своей БД и конвейером факт [S82]; микрофронтенды собираются в целое во время выполнения факт [S83].
  • Уровень. Архитектура и эксплуатация.
  • Параллельность. Сильное для команд; для агентов не больше, чем у модульного монолита с контролем границ гипотеза.
  • Время тестов. CI сервиса короткий, но интеграция требует контрактных тестов и сред.
  • Лимиты и лишняя работа. Смешанное: контекст сервиса мал, но сквозное изменение требует нескольких репозиториев и сессий.
  • Цена внедрения. Высокая: развёртывание, мониторинг, отказы, итоговая согласованность мнение [S74]; у микрофронтендов — дублирование зависимостей и операционная сложность мнение [S83].
  • Риски. Ошибки границ дороже, чем в монолите мнение [S73].
  • Когда не применять. Один человек или команда до 10 человек без требований независимого масштабирования.
  • Инструменты. Контрактные тесты (B2), мок-серверы (A8).
  • Доказанность. Мнение практиков мнение [S73, S74].

A11. Устранение горячих общих файлов

  • Проблема. Даже при разных зонах агенты правят общие реестры: корневой маршрутизатор, список приложений в настройках, DI-контейнер, таблицу маршрутов фронтенда, файлы переводов, журнал изменений.
  • Как работает. Автообнаружение (зона регистрирует себя сама), файл маршрутов на зону, миграции в папке зоны, генерируемые индексы, фрагменты журнала изменений; lock-файл меняет только выделенная задача гипотеза.
  • Уровень. Архитектура и процесс.
  • Параллельность. Сильное.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Среднее: меньше циклов разрешения конфликтов.
  • Цена внедрения. Низкая.
  • Риски. Неявная регистрация хуже читается.
  • Когда не применять. Один агент за раз.
  • Инструменты. Средства фреймворка (автообнаружение), генераторы.
  • Доказанность. Около 42 % конфликтов агентов структурные, 84,4 % конфликтных файлов — исходный код, lock-файлы — лишь 3,9 % эмпирика [S4]; сам приём — гипотеза.

Блок B. Тесты.

B1. Форма набора тестов на зону

  • Проблема. Полный сквозной набор медленный и нестабильный, а мелкие тесты на детали реализации ломаются при каждом рефакторинге агентом.
  • Как работает. В зоне — быстрые тесты ядра (A4) и интеграционные тесты зоны через её публичный API с настоящей БД в контейнере; между зонами — контрактные тесты; сквозные тесты — только для критических трасс. Это соответствует «сотам» Spotify (упор на интеграционные тесты сервиса в изоляции, отказ от integrated-тестов, зависящих от чужих систем) и «трофею» (статические проверки, немного unit, в основном интеграционные) мнение [S24, S25]; пирамида рекомендует опускать тест как можно ниже и держать сквозных тестов минимум мнение [S23].
  • Уровень. Тесты.
  • Параллельность. Сильное: каждый агент владеет тестами своей зоны.
  • Время тестов. Сильное.
  • Лимиты и лишняя работа. Среднее: короткие и адресные выводы.
  • Цена внедрения. Средняя.
  • Риски. Пробелы на стыках, если нет контрактных тестов.
  • Когда не применять. Никогда полностью; меняется только пропорция.
  • Инструменты. pytest, Jest или Vitest, Testcontainers факт [S84].
  • Доказанность. Мнение практиков мнение [S23, S24, S25].

B2. Контракты, задаваемые потребителем

  • Проблема. Изменение поставщика ломает потребителя только после интеграции.
  • Как работает. Тесты потребителя порождают контракт (pact); поставщик проверяет его в своём CI; проверяются только реально используемые части взаимодействия факт [S26]. Идея восходит к консолидированному контракту из ожиданий всех потребителей факт [S43].
  • Уровень. Тесты.
  • Параллельность. Сильное.
  • Время тестов. Сильное: заменяет интеграционную среду «поднять весь мир» вендор [S26].
  • Лимиты и лишняя работа. Среднее.
  • Цена внедрения. Средняя: брокер контрактов, дисциплина версий.
  • Риски. Избыточны внутри одного процесса с типизированными интерфейсами, где компилятор и тесты модуля уже проверяют вызовы гипотеза.
  • Когда не применять. Вызовы внутри модульного монолита на типизированном языке; применять на HTTP-границе с фронтендом, между процессами и на событиях.
  • Инструменты. Pact факт [S26].
  • Доказанность. Практика и мнение мнение [S26, S23].

B3. Выбор тестов по изменениям

  • Проблема. Полный прогон на каждой итерации.
  • Как работает. Три семейства: по графу проектов (Nx affected, Bazel, Spring Modulith) факт [S11, S12, S39]; по покрытию — pytest-testmon хранит связи тестов и исполненного кода и повторяет упавшие тесты факт [S28]; предиктивный выбор машинным обучением (Meta, CloudBees Smart Tests) факт [S27, S85].
  • Уровень. Тесты и CI.
  • Параллельность. Среднее: короче очередь CI.
  • Время тестов. Сильное.
  • Лимиты и лишняя работа. Сильное: агент запускает меньше тестов и читает короче вывод.
  • Цена внедрения. Низкая (testmon) — высокая (Bazel).
  • Риски. Пропуски: testmon не отслеживает статические файлы и внешние сервисы [S28], lock-файл делает затронутым всё [S11] факт; нужен регулярный полный прогон.
  • Когда не применять. Полный прогон короче минуты.
  • Инструменты. Nx, Bazel, Spring Modulith, pytest-testmon, CloudBees Smart Tests.
  • Доказанность. Meta: более 99,9 % регрессий при трети тестов эмпирика [S27]; CloudBees: «до 80 %» вендор [S68].

B4. Кеширование сборки и результатов тестов

  • Проблема. Одинаковые тесты повторно запускаются в каждом worktree, в каждом агенте и в CI.
  • Как работает. Герметичное действие с теми же входами даёт тот же результат, поэтому его результат берётся из кеша, в том числе удалённого факт [S12, S11].
  • Уровень. Тесты и CI.
  • Параллельность. Среднее: параллельные копии делят удалённый кеш.
  • Время тестов. Сильное при герметичности.
  • Лимиты и лишняя работа. Слабое напрямую.
  • Цена внедрения. Средняя–высокая.
  • Риски. Негерметичность (время, системные бинарники, правка исходников при сборке) ломает кеш факт [S12].
  • Когда не применять. Небольшой проект на интерпретируемом языке с быстрыми тестами.
  • Инструменты. Bazel, Nx с удалённым кешем.
  • Доказанность. Документация инструментов факт [S12, S11].

B5. Изолированные воспроизводимые окружения

  • Проблема. Параллельные агенты сталкиваются портами, общей БД и состоянием; появляются нестабильные тесты.
  • Как работает. Одноразовые контейнеры зависимостей со случайными портами для каждого прогона факт [S84]; копирование .env в новые worktree через .worktreeinclude факт [S29]; облачные окружения со скриптами установки факт [S30, S59].
  • Уровень. Тесты и инфраструктура разработки.
  • Параллельность. Сильное.
  • Время тестов. Среднее; снижает нестабильность.
  • Лимиты и лишняя работа. Среднее: агент не тратит сессию на починку окружения.
  • Цена внедрения. Средняя.
  • Риски. Медленный старт контейнеров; различия локальной и облачной среды.
  • Когда не применять. Нет внешних зависимостей.
  • Инструменты. Testcontainers, devcontainer, облачные среды агентов.
  • Доказанность. Cursor называет настройку окружения самым важным шагом для эффективности облачных агентов вендор [S59].

B6. Эталонные тесты и снимки

  • Проблема. Сложные выходы (отчёты, письма, страницы, ответы API) проверяются глазами человека.
  • Как работает. Тест сравнивает полученный результат с одобренным файлом; при расхождении человек один раз одобряет новый эталон или признаёт ошибку факт [S86]; для UI — сравнение скриншотов.
  • Уровень. Тесты.
  • Параллельность. Среднее.
  • Время тестов. Среднее.
  • Лимиты и лишняя работа. Сильное: снимает повторную ручную проверку.
  • Цена внедрения. Низкая.
  • Риски. Одобрение снимков не глядя; хрупкость к несущественным изменениям.
  • Когда не применять. Выход недетерминирован (время, случайность) без нормализации.
  • Инструменты. ApprovalTests, снимки Jest, визуальное сравнение.
  • Доказанность. Практика мнение [S86].

B7. Управление нестабильными тестами

  • Проблема. Ложные падения запускают повторные прогоны и лишние сессии агента.
  • Как работает. Обнаружение, карантин вне критического пути, повтор только для помеченных тестов факт [S87]; починка по кластерам с общей причиной (сеть, внешние зависимости, файловая система, время) эмпирика [S46].
  • Уровень. Тесты.
  • Параллельность. Слабое.
  • Время тестов. Среднее.
  • Лимиты и лишняя работа. Среднее.
  • Цена внедрения. Низкая–средняя.
  • Риски. Карантин как кладбище тестов.
  • Когда не применять. Не бывает.
  • Инструменты. Отчёты CI, B5.
  • Доказанность. 75 % нестабильных тестов в кластерах эмпирика [S46].

B8. Статические проверки как первый уровень

  • Проблема. Ошибки типов и границ находятся только в долгом прогоне.
  • Как работает. Типы, линтеры, проверка границ и сравнение схем идут за секунды после каждой правки; плагины кодового анализа в Claude Code сообщают об ошибках типов сразу после правки вендор [S37].
  • Уровень. Тесты.
  • Параллельность. Слабое.
  • Время тестов. Сильное.
  • Лимиты и лишняя работа. Среднее: переход к определению заменяет поиск и чтение нескольких файлов вендор [S37].
  • Цена внедрения. Низкая.
  • Риски. Ложное чувство безопасности.
  • Когда не применять. Не бывает.
  • Инструменты. mypy или pyright, tsc, ESLint, import-linter.
  • Доказанность. Практика мнение [S25].

B9. Уровни прогона

  • Проблема. Один уровень прогона либо слишком медленный для итерации, либо слишком слабый для релиза.
  • Как работает. L0 — секунды, внутри сессии агента: статические проверки и тесты зоны, закреплённые хуком остановки, который не даёт завершить ход до прохождения проверки вендор [S5]. L1 — PR: затронутые зоны, контракты, трассы через изменённые границы. L2 — после слияния в основную ветку: расширенный набор. L3 — ночной и перед релизом: полный прогон и сквозные тесты гипотеза.
  • Уровень. Тесты и процесс.
  • Параллельность. Среднее.
  • Время тестов. Сильное.
  • Лимиты и лишняя работа. Среднее.
  • Цена внедрения. Низкая.
  • Риски. Регрессии, найденные только на L3, приходят поздно; нужен владелец ночного прогона.
  • Когда не применять. Полный прогон короче минуты.
  • Инструменты. Хуки Claude Code, CI.
  • Доказанность. гипотеза на основе практик [S5, S11].

Блок C. Процесс.

C1. Карточка задачи для агента

  • Проблема. Размытая задача порождает переделки, дубли и расползание изменений.
  • Как работает. Одна задача — одна зона или один контракт; в карточке цель, зона, разрешённые файлы, «чего не делать», команды и тесты приёмки, ссылки на контракты, размер. Документация Claude Code советует самодостаточные спецификации: назвать файлы и интерфейсы, указать, что вне рамок, закончить сквозной проверкой вендор [S5]. Anthropic требует от поручения субагенту цели, формата результата, указаний по инструментам и чётких границ задачи, иначе агенты дублируют работу вендор [S53]. Devin рекомендует задачи до ~3 часов человеческой работы с явными критериями успеха вендор [S62].
  • Уровень. Процесс.
  • Параллельность. Сильное.
  • Время тестов. Среднее: критерии приёмки становятся тестами.
  • Лимиты и лишняя работа. Сильное: меньше разведки и переделок.
  • Цена внедрения. Минуты на карточку.
  • Риски. Карточка-формуляр без смысла; избыточная детализация мелких правок.
  • Когда не применять. Правка, описываемая одной фразой: документация Claude Code советует пропускать план, если дифф описывается одним предложением вендор [S5].
  • Инструменты. Шаблон в разделе 6, трекер задач.
  • Доказанность. Рекомендации вендоров вендор [S5, S53, S62].

C2. Изоляция агентов: worktree, клоны, контейнеры, облако

  • Проблема. Агенты в одной рабочей копии перезаписывают друг друга.
  • Как работает. Каждая сессия получает свою рабочую копию: claude --worktree создаёт копию и ветку, субагент с isolation: worktree работает в собственной копии факт [S29, S36]; практик использует отдельные свежие клоны вместо worktree мнение [S47]; облачные агенты работают в отдельных контейнерах или ВМ факт [S30, S60, S59].
  • Уровень. Процесс и инструменты.
  • Параллельность. Сильное.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Нейтрально; параллельные сессии умножают расход токенов вендор [S58].
  • Цена внедрения. Низкая: диск и настройка окружения.
  • Риски. Worktree делит .git и не содержит неотслеживаемых файлов вроде .env факт [S29]; столкновения портов и БД закрываются B5.
  • Когда не применять. Задачи в одних и тех же файлах — изоляция лишь откладывает конфликт до слияния.
  • Инструменты. git worktree, Claude Code, Codex cloud, Cursor cloud agents, агент Copilot.
  • Доказанность. Документация факт [S29, S58].

C3. Магистральная разработка и малые партии

  • Проблема. Долгоживущие ветки агентов расходятся с основной и дают «большой взрыв» интеграции.
  • Как работает. Не больше трёх активных веток, слияние в основную ветку не реже раза в день, без заморозок и фаз интеграции факт [S31]; работа нарезается на задачи от часов до пары дней факт [S32].
  • Уровень. Процесс.
  • Параллельность. Сильное: конфликты мелкие и частые вместо крупных и редких.
  • Время тестов. Среднее.
  • Лимиты и лишняя работа. Среднее.
  • Цена внедрения. Низкая технически, высокая по дисциплине.
  • Риски. Требует быстрых проверок и флагов для незавершённого.
  • Когда не применять. Не бывает для кода, идущего в прод.
  • Инструменты. CI, флаги (C4).
  • Доказанность. DORA связывает эти практики с более высокой эффективностью поставки по исследованиям 2016–2017 годов эмпирика [S31]; для ИИ — рекомендация как противовес нестабильности мнение [S32].

C4. Флаги функций

  • Проблема. Незавершённую фичу нельзя слить, и ветка живёт неделями.
  • Как работает. Флаги выпуска позволяют сливать скрытый код; у флагов есть стоимость владения, их удаляют после выпуска, а тестируют как ожидаемую прод-конфигурацию, так и выключенное состояние факт [S33].
  • Уровень. Процесс и архитектура.
  • Параллельность. Сильное.
  • Время тестов. Слабое отрицательное: больше комбинаций.
  • Лимиты и лишняя работа. Слабое.
  • Цена внедрения. Низкая.
  • Риски. Накопление мёртвых флагов.
  • Когда не применять. Фича целиком помещается в одну малую задачу.
  • Инструменты. Любая система флагов; таймер удаления.
  • Доказанность. Мнение практиков мнение [S33].

C5. Стекированные изменения

  • Проблема. Зависимые изменения ждут ревью предыдущих.
  • Как работает. Цепочка малых зависимых PR, каждый ревьюится и сливается отдельно; разработка продолжается поверх ещё не принятых изменений мнение [S88].
  • Уровень. Процесс.
  • Параллельность. Среднее.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Слабое.
  • Цена внедрения. Низкая с инструментом.
  • Риски. Перебазирование цепочки при правке нижнего PR.
  • Когда не применять. Независимые задачи в разных зонах — их лучше вести параллельно, а не стеком.
  • Инструменты. Graphite и аналоги.
  • Доказанность. Вендор и практики вендор [S88].

C6. Приёмка по доказательствам

  • Проблема. Ревью человеком — последовательная часть цикла и главное узкое место (раздел 1.2).
  • Как работает. Четыре ступени: агент показывает доказательства (вывод тестов, команду и результат, скриншот), потому что проверить доказательство быстрее, чем повторить проверку; хук остановки запрещает завершить работу до прохождения проверки; независимый субагент-ревьюер со свежим контекстом видит только дифф и критерии; ревьюеру велено сообщать лишь пробелы корректности, иначе погоня за замечаниями ведёт к переусложнению вендор [S5]. Человек смотрит по риску: контракты, миграции данных, безопасность, деньги и права доступа — всегда; внутренности зоны с зелёными тестами — выборочно гипотеза.
  • Уровень. Процесс.
  • Параллельность. Сильное: снимает последовательную часть.
  • Время тестов. Нейтрально.
  • Лимиты и лишняя работа. Среднее: ревьюер-субагент расходует лимит, но экономит часы человека.
  • Цена внедрения. Низкая.
  • Риски. Полный отказ от ревью: в 2026 году рост PR без ревью на 31,3 % сопровождался ростом отношения инцидентов к PR на 242,7 % эмпирика [S2].
  • Когда не применять. Сквозные изменения прав доступа и данных — только с человеком.
  • Инструменты. /code-review, субагенты, хуки Stop, /goal в Claude Code факт [S5].
  • Доказанность. Рекомендации вендора вендор [S5]; корреляционные данные о рисках отказа от ревью эмпирика [S2].

C7. Одна точка интеграции

  • Проблема. Несколько агентов одновременно сливают изменения и по-разному разрешают одни и те же конфликты.
  • Как работает. Слияние выполняет один интегратор (человек или выделенный агент) по очереди; каждая ветка перед слиянием перебазируется на свежую основную ветку и проходит L1; конфликт возвращается агенту-владельцу зоны гипотеза.
  • Уровень. Процесс.
  • Параллельность. Среднее: сериализует только короткий шаг.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Среднее: нет двойного разрешения конфликтов.
  • Цена внедрения. Низкая.
  • Риски. Интегратор становится узким местом при десятках PR в день.
  • Когда не применять. Один агент.
  • Инструменты. Очередь слияния в хостинге репозитория.
  • Доказанность. Частота конфликтов у PR агентов 27,67 % эмпирика [S49]; приём — гипотеза.

C8. Владение зонами, очередь задач и закон Конвея для агентов

  • Проблема. Агенты делают одно и то же, бросают работу, лезут в чужие зоны.
  • Как работает. У зоны один владелец-человек и не больше одной активной задачи агента; все задачи идут из одной очереди с WIP-лимитом, равным ёмкости приёмки; топология «оркестратор плюс изолированные исполнители», где один агент владеет планом и итогом, а исполнители работают изолированно мнение [S15]; в командах агентов каждый участник владеет своим набором файлов вендор [S10].
  • Уровень. Организация и процесс.
  • Параллельность. Сильное.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Сильное: меньше дублей и брошенных PR.
  • Цена внедрения. Низкая.
  • Риски. Владелец-человек в отпуске блокирует зону.
  • Когда не применять. Не бывает при двух и более агентах.
  • Инструменты. CODEOWNERS, трекер, общий список задач команд агентов.
  • Доказанность. 23 % отклонённых PR агентов — дубликаты, 38 % брошены эмпирика [S51]; приём — мнение.

C9. Спецификация до кода в меру

  • Проблема. Агент начинает писать до понимания задачи.
  • Как работает. Для крупных фич агент интервьюирует человека и пишет SPEC.md, затем реализация идёт в новой сессии с чистым контекстом вендор [S5]; для мелких задач план пропускается вендор [S5]; полные SDD-конвейеры тяжелы для мелких задач мнение [S75].
  • Уровень. Процесс.
  • Параллельность. Среднее: спецификация задаёт контракты заранее.
  • Время тестов. Среднее.
  • Лимиты и лишняя работа. Сильное для крупных фич, отрицательное для мелких.
  • Цена внедрения. Низкая.
  • Риски. «Спецификационный театр»: много markdown, который никто не читает мнение [S75].
  • Когда не применять. Задача описывается одним предложением.
  • Инструменты. Режим плана Claude Code, Spec Kit, Kiro факт [S5, S76, S63].
  • Доказанность. Рекомендации вендоров и мнение вендор [S5]; мнение [S75].

C10. Уборка энтропии

  • Проблема. Код агентов дрейфует от принятых образцов, растёт дублирование.
  • Как работает. Регулярные фоновые задачи сверяют код с «золотыми принципами» и открывают небольшие PR рефакторинга вендор [S44].
  • Уровень. Процесс.
  • Параллельность. Слабое.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Среднее в долгую: меньше путаницы для следующих сессий.
  • Цена внедрения. Низкая.
  • Риски. Шум мелких PR в очереди ревью.
  • Когда не применять. Первые недели проекта.
  • Инструменты. Задачи по расписанию агентов, линтеры.
  • Доказанность. Рост дублирования кода эмпирика [S54]; приём — вендор [S44].

Блок D. Контекст агентов и лимиты.

D1. Короткие иерархические файлы правил

  • Проблема. Длинный файл правил загружается в каждую сессию, тратит контекст, и правила в нём теряются.
  • Как работает. Корневой CLAUDE.md или AGENTS.md короткий и служит оглавлением; в папках зон лежат свои файлы, и ближайший к редактируемому файлу побеждает факт [S34]; редко нужное выносится в skills, которые загружаются по требованию; Anthropic советует держать CLAUDE.md до ~200 строк вендор [S37] и для каждой строки спрашивать, приведёт ли её удаление к ошибкам вендор [S5]. В проекте OpenAI AGENTS.md — оглавление на ~100 строк со ссылками на структурированную папку docs вендор [S44].
  • Уровень. Контекст агентов.
  • Параллельность. Среднее: у каждой зоны свои правила.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Сильное.
  • Цена внедрения. Низкая.
  • Риски. Устаревшие правила; противоречия между уровнями.
  • Когда не применять. Не бывает.
  • Инструменты. CLAUDE.md, AGENTS.md, skills, /context для проверки загрузки факт [S5].
  • Доказанность. Рекомендации вендоров вендор [S5, S37].

D2. Карта зон и паспорта зон как контекст

  • Проблема. Агент тратит токены на поиск структуры, которую знает человек.
  • Как работает. Короткая карта зон (список зон, назначение, зависимости, контракты) и паспорта зон подгружаются по мере надобности; Aider строит карту репозитория из ключевых символов, ранжированных по графу ссылок, в бюджете около 1000 токенов факт [S35]; Anthropic предлагает skill с обзором архитектуры вместо чтения многих файлов вендор [S37] и загрузку контекста «точно в срок» по лёгким идентификаторам вендор [S78].
  • Уровень. Контекст агентов.
  • Параллельность. Среднее.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Сильное.
  • Цена внедрения. Низкая; карту можно генерировать скриптом из конфигурации контроля зависимостей гипотеза.
  • Риски. Устаревание ручной карты.
  • Когда не применять. Репозиторий из десятка файлов.
  • Инструменты. Карта репозитория Aider, skills, генерация из import-linter или Nx.
  • Доказанность. Практика инструментов факт [S35]; эффект — гипотеза.

D3. Размер зоны под окно контекста

  • Проблема. Зона, которую нельзя прочитать целиком, заставляет агента работать по фрагментам и ошибаться на стыках внутри неё.
  • Как работает. Зона дробится, пока её код и контракты соседей не помещаются в небольшую долю окна (ориентир: до ~20–30 % окна, гипотеза); качество моделей падает с ростом длины входа эмпирика [S13], поэтому запас важнее формального предела окна.
  • Уровень. Архитектура и контекст.
  • Параллельность. Среднее.
  • Время тестов. Среднее: меньше тестов на зону.
  • Лимиты и лишняя работа. Сильное.
  • Цена внедрения. Средняя для существующих систем.
  • Риски. Слишком мелкие зоны увеличивают число контрактов и стыков.
  • Когда не применять. Когда дробление режет цельное решение, которое меняется вместе.
  • Инструменты. Подсчёт токенов зоны скриптом.
  • Доказанность. гипотеза на основе [S13, S5].

D4. Субагенты для шумной работы

  • Проблема. Поиск по коду, прогоны тестов и чтение логов забивают основной контекст.
  • Как работает. Субагент работает в своём окне и возвращает только сводку факт [S36]; сводки субагентов обычно 1000–2000 токенов вендор [S78]; для простых субагентов выбирают меньшую модель вендор [S37]. Субагенты расходуют те же лимиты, что и основная сессия факт [S36].
  • Уровень. Контекст агентов.
  • Параллельность. Среднее.
  • Время тестов. Слабое.
  • Лимиты и лишняя работа. Сильное для основного контекста; общий расход может вырасти.
  • Цена внедрения. Низкая.
  • Риски. Потеря деталей в сводке; параллельные субагенты с неявными решениями мнение [S48].
  • Когда не применять. Исследование на пару файлов.
  • Инструменты. Субагенты Explore и Plan, свои субагенты в .claude/agents/ факт [S36].
  • Доказанность. Документация вендор [S36, S37].

D5. Хуки, скрипты и генераторы вместо рассуждений

  • Проблема. Модель тратит токены на механическую работу: чтение логов, шаблонный код, повторяющиеся проверки.
  • Как работает. Хук фильтрует вывод тестов до строк с ошибками и сокращает контекст с десятков тысяч токенов до сотен вендор [S37]; генератор создаёт каркас нового среза или эндпоинта из контракта гипотеза; линтер сообщает агенту, как исправить нарушение вендор [S44]; CLI-инструменты экономнее по контексту, чем MCP-серверы вендор [S37]. Хуки детерминированы, а инструкции в CLAUDE.md лишь рекомендательны вендор [S5].
  • Уровень. Контекст и инструменты.
  • Параллельность. Слабое.
  • Время тестов. Среднее.
  • Лимиты и лишняя работа. Сильное.
  • Цена внедрения. Низкая: скрипт может написать сам агент.
  • Риски. Фильтр скрывает важный контекст ошибки.
  • Когда не применять. Разовые задачи.
  • Инструменты. Хуки Claude Code, скрипты, генераторы кода.
  • Доказанность. Документация вендор [S37, S5].

D6. Выбор модели и уровня рассуждения

  • Проблема. Флагманская модель с максимальным рассуждением тратит лимит на простые правки.
  • Как работает. Средняя модель для большинства задач, флагман — для архитектурных решений и многошагового рассуждения, маленькая — для простых субагентов; уровень рассуждения снижается для простых задач вендор [S37]. У Codex число локальных сообщений за 5 часов различается по моделям на порядок (например, 5–45 против 350–3000 на плане Plus) вендор [S71].
  • Уровень. Контекст и лимиты.
  • Параллельность. Среднее: больше агентов в том же лимите.
  • Время тестов. Нейтрально.
  • Лимиты и лишняя работа. Сильное.
  • Цена внедрения. Низкая.
  • Риски. Слабая модель на сложной задаче порождает переделки дороже экономии.
  • Когда не применять. Задачи на стыках и контракты — только сильная модель гипотеза.
  • Инструменты. /model, /effort, поле model субагента факт [S37, S36].
  • Доказанность. Рекомендации вендоров вендор [S37, S71].

D7. Гигиена сессий и кеш промптов

  • Проблема. Длинные сессии пересылают всю историю с каждым запросом; после паузы кеш остывает.
  • Как работает. /clear между несвязанными задачами; после двух неудачных исправлений — новая сессия с лучшей постановкой вендор [S5]; кеш живёт час на подписке и пять минут при оплате кредитами или по API вендор [S37]; чтение из кеша стоит 0,1 базовой цены входа у большинства моделей факт [S89]; смена определений инструментов инвалидирует весь кеш факт [S89]; компактизация сама является большим запросом, а /clear бесплатен вендор [S37].
  • Уровень. Контекст и лимиты.
  • Параллельность. Слабое.
  • Время тестов. Нейтрально.
  • Лимиты и лишняя работа. Сильное.
  • Цена внедрения. Нулевая.
  • Риски. Потеря полезного контекста при частой очистке; записывать выводы в файлы заметок вендор [S78].
  • Когда не применять. Глубокая отладка одной сложной проблемы, где история ценна вендор [S5].
  • Инструменты. /clear, /compact, /rewind, статистика кеша в /usage факт [S37].
  • Доказанность. Документация вендор [S5, S37, S89].

D8. Бюджет параллелизма под лимиты подписок

  • Проблема. Параллельные агенты быстро выбирают пятичасовое окно и недельный лимит.
  • Как работает. Число одновременных агентов ограничивается меньшим из двух: ёмкостью приёмки и бюджетом лимита, делённым на средний расход задачи гипотеза. Параллельные сессии умножают расход токенов вендор [S58]; команды агентов расходуют примерно в 7 раз больше токенов в режиме плана вендор [S37]; у Max окно 5 часов плюс недельный лимит факт [S70]; у Codex локальные и облачные задачи делят один лимит вендор [S71].
  • Уровень. Процесс и лимиты.
  • Параллельность. Ограничивающее.
  • Время тестов. Нейтрально.
  • Лимиты и лишняя работа. Сильное.
  • Цена внедрения. Нулевая.
  • Риски. Упор в недельный лимит в середине недели.
  • Когда не применять. Оплата по API без жёстких лимитов — тогда ограничение денежное.
  • Инструменты. /usage с разбивкой по субагентам, skills и MCP факт [S37].
  • Доказанность. Документация вендор [S37, S58, S70, S71].

4.3. Сводная матрица стратегий

Код Стратегия Уровень Параллельность Время тестов Лимиты и потери Цена Доказанность
A1 Зоны по сокрытию решений, паспорт архитектура сильное среднее сильное низкая классика, гипотеза для агентов
A2 Ограниченные контексты архитектура сильное среднее среднее средняя мнение
A3 Модульный монолит + контроль зависимостей архитектура, CI сильное среднее сильное низкая–средняя вендорские кейсы
A4 Порты и адаптеры архитектура среднее сильное среднее средняя мнение
A5 Вертикальные срезы архитектура сильное среднее сильное низкая мнение
A6 События как граница архитектура сильное сильное среднее средняя гипотеза
A7 Контракт-первым + проверка совместимости архитектура, CI сильное среднее сильное низкая инструменты, гипотеза
A8 Заглушки по контракту тесты сильное сильное среднее низкая инструменты
A9 Expand → contract процесс сильное среднее слабое низкая мнение
A10 Микросервисы, микрофронтенды архитектура сильное для команд смешанное смешанное высокая мнение
A11 Без горячих общих файлов архитектура сильное слабое среднее низкая эмпирика о конфликтах
B1 Набор тестов на зону тесты сильное сильное среднее средняя мнение
B2 Контракты потребителя тесты сильное сильное среднее средняя мнение
B3 Выбор тестов по изменениям тесты среднее сильное сильное низкая–высокая эмпирика (Meta)
B4 Кеш сборки и тестов тесты среднее сильное слабое средняя–высокая документация
B5 Изолированные окружения тесты сильное среднее среднее средняя вендор
B6 Эталонные тесты тесты среднее среднее сильное низкая мнение
B7 Нестабильные тесты тесты слабое среднее среднее низкая эмпирика
B8 Статические проверки тесты слабое сильное среднее низкая мнение
B9 Уровни прогона тесты, процесс среднее сильное среднее низкая гипотеза
C1 Карточка задачи процесс сильное среднее сильное низкая вендор
C2 Изоляция агентов процесс сильное слабое нейтрально низкая документация
C3 Магистраль и малые партии процесс сильное среднее среднее низкая эмпирика DORA
C4 Флаги функций процесс сильное слабое слабое низкая мнение
C5 Стекированные изменения процесс среднее слабое слабое низкая вендор
C6 Приёмка по доказательствам процесс сильное нейтрально среднее низкая вендор, эмпирика о рисках
C7 Одна точка интеграции процесс среднее слабое среднее низкая гипотеза
C8 Владение зонами, очередь, WIP организация сильное слабое сильное низкая эмпирика о дублях, мнение
C9 Спецификация в меру процесс среднее среднее сильное для крупных низкая вендор, мнение
C10 Уборка энтропии процесс слабое слабое среднее низкая вендор
D1 Короткие файлы правил контекст среднее слабое сильное низкая вендор
D2 Карта и паспорта зон контекст среднее слабое сильное низкая инструменты
D3 Зона под окно контекст среднее среднее сильное средняя гипотеза
D4 Субагенты для шума контекст среднее слабое сильное низкая вендор
D5 Хуки и генераторы контекст слабое среднее сильное низкая вендор
D6 Модель и рассуждение по задаче лимиты среднее нейтрально сильное низкая вендор
D7 Гигиена сессий, кеш лимиты слабое нейтрально сильное нулевая вендор
D8 Бюджет параллелизма лимиты ограничивающее нейтрально сильное нулевая вендор

4.4. Разбор альтернатив

Для каждой альтернативы из таблицы 4.1 — когда она целесообразнее предмета, её плюсы и минусы относительно него.

Однопоточная итеративная работа. Целесообразнее для прототипов, небольших систем и глубокой отладки одной проблемы, где история контекста ценна вендор [S5]. Плюсы относительно предмета: нулевая цена входа, нет стыков и неявных решений между агентами мнение [S48]. Минусы: время проверки растёт с системой, параллельности нет, человек — единственный цикл проверки.

Микросервисы. Целесообразнее при требованиях независимого масштабирования, развёртывания или изоляции данных (как вынос хранилища данных платёжных карт и рендеринга витрин в Shopify) вендор [S18]. Плюсы: жёсткая изоляция процессов и данных, независимые конвейеры. Минусы: наценка распределённости мнение [S74], дорогие ошибки границ мнение [S73], сквозные изменения требуют нескольких репозиториев и сессий агента.

Микрофронтенды. Целесообразнее при нескольких фронтенд-командах с независимыми релизами мнение [S83]. Плюсы: независимое развёртывание частей интерфейса. Минусы: дублирование зависимостей, различие сред разработки и прода, операционная сложность мнение [S83]; для одного человека с агентами те же выгоды дают папки-срезы фронтенда с правилом границ гипотеза.

SDD-конвейер как основной процесс. Целесообразнее для крупных фич с неясными требованиями. Плюсы: формализация требований, Kiro сам выделяет независимые задачи и выполняет их волнами факт [S63]. Минусы: избыточен для мелких задач, markdown тяжело ревьюить, агенты не всегда следуют спецификации мнение [S75]; без контроля границ параллельные задачи по-прежнему правят общие файлы гипотеза.

Оркестрация многих агентов поверх неразрезанного кода. Целесообразнее для исследования, ревью и отладки с конкурирующими гипотезами вендор [S10]. Плюсы: быстрый старт, встроенный общий список задач. Минусы: команды агентов не изолируют участников по копиям и требуют ручного раздела файлов вендор [S10]; расход токенов кратно выше вендор [S37, S53]; отдельная категория отказов — рассогласование агентов эмпирика [S50].

Предиктивный выбор тестов без изоляции. Целесообразнее в большом существующем монорепозитории с огромной историей прогонов, где перестройка архитектуры невозможна эмпирика [S27]. Плюсы: не требует менять код. Минусы: не уменьшает конфликты, контекст агента и ревью; вендорские числа не проверены независимо вендор [S68].

Облачные фоновые агенты по тикету. Целесообразнее для потока рутинных изолированных задач: документация, тесты, мелкие баги эмпирика [S51]. Плюсы: не занимают машину, работают параллельно в своих контейнерах факт [S30, S59]. Минусы: без границ дают конфликты и дубли эмпирика [S4, S51]; у агента Copilot ограничение одним репозиторием, одним PR на задачу и 59 минутами факт [S60].

Дерево решений

  • Если домен ещё не понятен (прототип, поиск продукта)→однопоточная работа с одним агентом, без зон и контрактов; нарезку проводить после стабилизации 2–3 устойчивых подобластей
  • Если задача по природе сквозная и однотипная (обновление библиотеки, переименование, миграция стиля)→веерная раздача правки по файлам (/batch или цикл claude -p), без зон
  • Если нужна независимая эксплуатация частей (отдельное масштабирование, изоляция чувствительных данных, разные языки)→сервисы только для этих частей, остальное — модульный монолит
    • Если частей не больше двух-трёх и есть ресурсы на эксплуатацию→выделить только эти части в сервисы с контрактными тестами (B2), остальное — модульный монолит
    • Иначе→модульный монолит с событиями на месте будущих границ сервисов
  • Если над кодом одновременно работают два и более агента или человека→зонная архитектура: зоны, контроль зависимостей (A3), изоляция агентов (C2)
    • Если полный прогон тестов короче ~5 минут→зоны, контроль зависимостей (A3), изоляция агентов (C2), полный прогон на каждой итерации
    • Если полный прогон дольше ~5 минут→зоны плюс выбор тестов по графу зон (B3) и уровни прогона (B9)
      • Если стек TypeScript-монорепозиторий→зоны + правило границ Nx + nx affected + удалённый кеш
      • Если стек Python или Django→зоны + import-linter или tach + pytest-testmon для локального цикла и выбор по графу зон в CI
      • Если стек Java или Spring→Spring Modulith (verify, тесты модулей, запуск только изменённых модулей)
      • Если система очень большая и многоязычная→Bazel с удалённым кешем
    • Если зоны общаются по HTTP или событиям→контракт-первым (A7) + заглушки (A8); контракты потребителя (B2) — только на межпроцессных границах
  • Если узкое место — ревью человеком→приёмка по доказательствам (C6) + малые партии (C3) + WIP-лимит по ёмкости приёмки (C8)
  • Если упор в лимиты подписки→блок D каталога, начиная с диагностики по /usage
    • Если сессии длинные и в /usage отмечены длинный контекст или промахи кеша→гигиена сессий (D7) и свежая сессия на задачу
    • Если много чтения кода до первой правки→паспорта и карта зон (D2), короткие файлы правил (D1)
    • Если много шумного вывода (тесты, логи)→хуки-фильтры и субагенты (D5, D4)
    • Иначе→выбор модели и уровня рассуждения по задаче (D6) и бюджет параллелизма (D8)
  • Если частые поломки на стыках после слияния→контракт-первым (A7), контракты потребителя на межпроцессных границах (B2), устранение горячих общих файлов (A11), одна точка интеграции (C7)
  • Иначе→зонная архитектура в минимальной форме: паспорта зон, правило границ в CI, тесты зоны, worktree на агента

Практическое применение

5.1. Пошаговая методика нарезки новой системы на зоны

Методика авторская, собрана из классических критериев модульности и практик раздела 4 гипотеза. Каждый шаг заканчивается проверяемым артефактом.

  1. Выписать изменчивые решения и подобласти. Список решений, которые вероятно изменятся (платёжный провайдер, тарифная модель, каналы уведомлений, правила доступа, формат отчётов), и подобластей со своим языком. Критерий Парнаса — начинать с трудных и вероятно меняющихся решений, а не с блок-схемы обработки факт [S8]. Артефакт: список на одну страницу.
  2. Черновые зоны. Одна зона — одна подобласть или одно изменчивое решение; плюс ядро платформы (арендатор, пользователь, права, конфигурация, outbox событий) и пакет контрактов. Проверка зоны: у неё есть ответ «чего она не делает», она владеет своими таблицами, у неё 3–7 публичных операций или событий (ориентир, гипотеза). Артефакт: карта зон (раздел 6).
  3. Направления зависимостей. Граф ацикличен; ядро ни от кого не зависит; функциональные зоны зависят от ядра и контрактов; обратные потоки идут событиями. Артефакт: конфигурация линтера границ (раздел 6).
  4. Владение данными. Каждая таблица принадлежит одной зоне; чужие данные читаются через API или через проекцию, построенную по событиям; в многоарендной системе идентификатор арендатора входит в каждый контракт гипотеза.
  5. Контракты на каждом ребре графа. Шаблон контракта раздела 6: машиночитаемая схема плюс гарантии, запреты, ошибки, версия, тестовые обязательства.
  6. Инвентаризация горячих файлов. Корневые маршруты, список приложений, DI, таблица маршрутов фронтенда, переводы, миграции, lock-файл; каждый заменяется автообнаружением или файлом на зону (A11).
  7. Сквозные трассы. 5–10 критических сценариев, проходящих через границы; каждая трасса — тест уровня L1 (если проходит через изменённую границу) или L3.
  8. Проверка размеров. Код зоны плюс контракты соседей помещаются в небольшую долю окна агента (D3); у одного человека не больше 3–5 одновременно активных зон (ориентир, гипотеза).
  9. Механизация. Линтер границ в CI, выбор тестов по графу зон, заглушки по контрактам, генератор нового среза, паспорта зон, таблица «что изменилось → что перепроверить».
  10. Пилот. Две параллельные задачи в двух зонах; замер метрик раздела 8 до и после; коррекция границ, где задачи всё равно пересеклись по файлам.

5.2. Порядок внедрения в существующей системе

  1. Замерить базу: время CI, долю PR с конфликтами, время до первого ревью, размер PR, долю переделок, расход лимита на слитый PR (раздел 8).
  2. Построить фактический граф импорта инструментом (tach show, import-linter, граф Nx) и найти кластеры факт [S38, S20, S79].
  3. Объявить зоны по кластерам и изменчивым решениям; включить линтер в режиме «не хуже»: текущие нарушения заморожены, новые запрещены. Shopify так удержал базовый слой без нарушений и зависимостей вендор [S72].
  4. Паспорта зон и вложенные AGENTS.md в папках зон факт [S34].
  5. Эталонные тесты вокруг зон до рефакторинга агентом: approval-тесты предназначены в том числе для унаследованного кода факт [S86].
  6. Выбор тестов и уровни прогона: pytest-testmon или affected на графе, ночной полный прогон.
  7. Постепенный вынос горячих файлов и перевод синхронных вызовов на события там, где зоны связаны по времени.
  8. Параллелить агентов сначала на исследовании и ревью, затем на реализации в разных зонах; так рекомендует документация команд агентов Claude Code вендор [S10].

5.3. Сквозной пример: многоарендное веб-приложение

Все числа в этом подразделе — иллюстрация, а не измерения.

Система (пример). B2B-сервис заявок и счетов для малых компаний: арендаторы, пользователи и роли, каталог услуг, заявки, тарифы и счета с внешним платёжным провайдером, уведомления (почта, SMS, push) через воркер, ночные отчёты, вебхуки и импорт CSV, клиентский и административный интерфейсы. Стек примера: Django, Celery, Redis, PostgreSQL, React с TypeScript. Размер для иллюстрации — около 60 тыс. строк.

Карта зон (пример).

Зона Отвечает за Чего не делает Публичный API и события Размер, иллюстрация
platform арендатор, аутентификация, права, настройки, outbox, флаги бизнес-логики current_tenant(), check_permission(), публикация событий 6 тыс. строк
identity пользователи, роли, приглашения биллинга и уведомлений /users, событие UserInvited.v1 4 тыс.
catalog услуги и цены заявок и счетов /catalog, PriceChanged.v1 4 тыс.
orders жизненный цикл заявки расчёта денег и отправки писем /orders, OrderPlaced.v1, порт BillingLimits 9 тыс.
billing тарифы, счета, адаптер провайдера решений о том, кого уведомлять /billing, InvoiceIssued.v1, PaymentFailed.v1 8 тыс.
notifications шаблоны, каналы, доставка в воркере решений, когда уведомлять потребитель событий, /notifications/preferences 6 тыс.
reporting проекции и ночные агрегаты записи в чужие таблицы /reports, задачи по расписанию 5 тыс.
integrations вебхуки наружу, импорт CSV бизнес-правил /integrations, потребитель событий 5 тыс.
web-shell маршрутизация, вход, дизайн-система логики функций компоненты, хук сессии 5 тыс.
web-features папки функций UI по зонам обращения к API в обход клиента страницы, сгенерированный клиент API 8 тыс.
contracts OpenAPI, схемы событий, сгенерированные типы кода логики схемы и типы 1 тыс.

Правила зависимостей (пример). Серверные зоны независимы друг от друга и импортируют только platform.api и contracts; reporting получает данные только из событий; фронтенд-функции импортируют только web-shell и сгенерированный клиент. Проверяются import-linter или tach на сервере и правилом границ Nx или ESLint на фронтенде (конфигурации в разделе 6).

Фича (пример). «Тарифы с лимитом заявок, автоматическим счётом и письмом об оплате». Затрагивает billing, orders, notifications и страницу биллинга во фронтенде.

Шаг Кто Длительность, иллюстрация Артефакт
1. Контракты человек + один агент 1,5 ч billing.openapi.yaml v1.3 (/billing/plans, /billing/usage), InvoiceIssued.v1, OrderLimitExceeded.v1, запись решения
2. Заглушки агент 15 мин мок-сервер по OpenAPI, фейк-адаптер BillingLimits, фикстуры событий
3. Четыре задачи параллельно 4 агента в своих worktree 2–3 ч каждая PR billing, PR orders (против фейка), PR notifications (по фикстурам), PR фронтенда (против мок-сервера)
4. Приёмка каждого PR субагент-ревьюер + человек ~15 мин человека на PR доказательства: вывод L0 и L1, скриншот страницы, дифф контракта пуст
5. Интеграция интегратор 30 мин слияние по очереди, L1 после каждого слияния, трассы T3 и T5
6. Ночной прогон CI 22 мин полный набор и сквозные тесты

Сравнение циклов (иллюстрация).

Показатель Однопоточно, полный прогон Зонно, параллельно
Прогон на итерацию 22 мин полного набора L0 20–90 с в сессии, L1 5–7 мин на PR
Число полных прогонов за фичу 6–8 1 ночной
Ревью один PR ~1600 строк, 90+ мин четыре PR по 300–450 строк, ~15 мин каждый
Календарное время фичи 2–3 дня 1 день
Параллельных сессий 1 4 (окно подписки выбирается быстрее, см. D8)

Выигрыш в примере создаёт не число агентов, а три вещи: контракты и заглушки до начала работы, короткий цикл L0 внутри зоны и малые PR с доказательствами гипотеза.

Вариант для команды из 10 человек (пример). Три продуктовых разработчика владеют по 2–3 зоны, у каждого 2–3 агента; один инженер платформы владеет platform, contracts, CI и линтерами; изменения контрактов проходят еженедельное короткое согласование и записываются решениями; очередь слияния одна; WIP — не больше одной активной задачи агента на зону.

5.4. Сопоставление с подходом пользователя

Подход пользователя: ящики с границами «чего блок не делает» → контракты между ящиками «как чёрными ящиками» по семи вопросам (кто отправляет, кто принимает, событие, что передаётся, гарантии, запреты, гейт) → сквозные трассы → детализация ящик за ящиком; изменение контракта оформляется решением с версией.

Где совпадает с практикой.

Элемент подхода Соответствие в практике
Ящики с «чего не делает» Сокрытие решений Парнаса [S8], ограниченные контексты [S17], указание того, что вне рамок, в спецификации для агента [S5] факт
Контракт «как чёрный ящик» Контракты поставщика и потребителя [S43], предусловия, постусловия и инварианты Design by Contract [S90], производители и потребители AsyncAPI [S77] факт
Гарантии и запреты Постусловия и предусловия [S90]; гарантии доставки и идемпотентности для событий факт
Сквозные трассы Малое число сквозных тестов на критические сценарии [S23], сценарные тесты модулей [S39] мнение
Решение с версией ADR со статусами и заменой [S81], expand → contract [S42] факт
Детализация по одному ящику Одна задача — одна зона (C1)

Где отстаёт и чего не хватает гипотеза:

  1. Машиночитаемость. Семь вопросов в прозе не проверяются CI; к каждому контракту нужна схема (OpenAPI, AsyncAPI, JSON Schema) и автоматическое сравнение версий, для которого есть готовые инструменты факт [S40, S41].
  2. Исполняемость. Нет контрактных тестов и заглушек, которые позволяют начинать ящики одновременно; оба вида инструментов существуют факт [S26, S80].
  3. Контроль границ в коде. «Чего ящик не делает» записано, но не запрещено линтером импорта, хотя такие линтеры есть факт [S20, S38].
  4. Правила совместимости. Не определено, что считается несовместимым изменением и как долго живёт старая версия; в практике для этого есть Tolerant Reader и expand → contract факт [S43, S42].
  5. Ошибки и отказ. Среди семи вопросов нет семантики ошибок, повторов, таймаутов, идемпотентности, порядка, объёмов.
  6. Арендатор и права. Для многоарендной системы — контекст арендатора и проверка прав на границе.
  7. Владение данными. Кому принадлежат таблицы и кто пишет миграции.
  8. Тестовые обязательства. Какие тесты есть у поставщика, у потребителя и какая трасса покрывает контракт.
  9. Контекст для агента. Паспорт ящика в папке кода (вложенный AGENTS.md) и размер ящика относительно окна.
  10. Параллельность детализации. «Детализация по одному» последовательна; при контрактах со схемами и заглушками ящики детализируются параллельно разными агентами.
  11. Гейт. Один гейт стоит заменить уровнями L0–L3 и указанием, кто принимает (тест, агент-ревьюер, человек).
  12. Таблица перепроверки. Из графа ящиков и контрактов выводится таблица «что изменилось → что перепроверить» (раздел 6).

Итог сопоставления: подход пользователя совпадает с классикой по смыслу границ и контрактов, но остаётся документным; главный недостающий слой — механизация (схемы, линтеры, контрактные тесты, заглушки, выбор тестов по графу), которая и превращает границы в скорость гипотеза. Расширенный шаблон контракта — в разделе 6.

5.5. Типичные ошибки первого применения

  • Зоны по техническим слоям (backend, frontend, база) вместо предметных: каждая фича трогает все зоны, параллельности нет.
  • Слишком мелкие зоны: контрактов больше, чем логики; каждая задача меняет контракт.
  • Общая модель данных: все зоны читают все таблицы, скрытая связность ломает изоляцию тестов.
  • Контракты только в прозе: расхождения обнаруживаются при интеграции.
  • Пять агентов до готовности приёмки: очередь ревью растёт, PR бросаются; 38 % отклонённых PR агентов брошены без участия ревьюера эмпирика [S51].
  • Параллельные агенты в одном окружении: общие порты и БД дают нестабильные тесты.
  • Одна длинная сессия на фичу: контекст деградирует, лимит расходуется на пересылку истории вендор [S37].
  • Полный прогон в каждой сессии агента: лимит и время уходят на вывод тестов.
  • Ставка на команды агентов вместо нарезки: команды не изолируют участников по копиям вендор [S10].
  • Отказ от ревью человеком совсем эмпирика [S2].

5.6. Что происходит через месяцы

  • Эрозия границ без механизации. Shopify за годы убрал проверки приватности как неработающие и сместился к упаковке по фактическому исполнению; удержание базового слоя без нарушений сработало вендор [S72].
  • Энтропия кода агентов. Дрейф от образцов и рост дублирования требуют регулярной уборки вендор [S44]; в отрасли доля копипасты росла, а доля рефакторинга падала эмпирика [S54].
  • Рост оттока кода и инцидентов при высоком внедрении ИИ без изменения процесса эмпирика [S2].
  • Накопление нестабильных тестов и версий контрактов: нужен владелец карантина и график удаления старых версий.

5.7. Стоимость входа

Статья Один человек, новая система Команда до 10, существующая система
Время на нарезку и контракты 1–3 дня (иллюстрация) 2–6 недель постепенного внедрения (иллюстрация)
Настройка CI, линтеров, выбора тестов 0,5–2 дня (иллюстрация) 1–2 недели инженера платформы (иллюстрация)
Подписки на 2026-09-27 Claude Pro $20, Max 5x $100 в месяц [S91]; Codex Plus $20, Pro от $100 [S71] факт Claude Team $25 или $125 за место [S91], Codex Business $20–25 за пользователя [S71] факт
Компетенции предметное моделирование, дизайн тестов, базовый CI то же плюс владение платформой и контрактами

Артефакты

Шаблоны ниже авторские, собраны из практик разделов 4 и 5 гипотеза; примеры относятся к иллюстративной системе раздела 5.3.

6.1. Карта зон

  • Назначение. Единый список зон, их ответственности, зависимостей и контрактов; первый файл, который читает агент или новый участник.
  • Структура. Таблица: зона, отвечает за, не делает, владелец, разрешённые зависимости, публикует, потребляет, путь к паспорту.
  • Жизненный цикл. Создаёт архитектор или владелец платформы на шаге 2 методики; меняется только вместе с конфигурацией линтера границ; устаревает, если карту правят руками без линтера — поэтому раздел зависимостей лучше генерировать из конфигурации гипотеза.
  • Пример.
| Зона | Отвечает за | Не делает | Владелец | Зависит от | Публикует | Потребляет |
|---|---|---|---|---|---|---|
| billing | тарифы, счета, платёжный адаптер | не решает, кого уведомлять | Анна | platform, contracts | InvoiceIssued.v1, PaymentFailed.v1 | OrderPlaced.v1 |
| notifications | шаблоны, каналы, доставка | не решает, когда уведомлять | Борис | platform, contracts | — | InvoiceIssued.v1, UserInvited.v1 |

6.2. Паспорт зоны (вложенный AGENTS.md или CLAUDE.md)

  • Назначение. Контекст зоны для агента вместо разведки кода; ближайший к редактируемому файлу AGENTS.md имеет приоритет факт [S34].
  • Поля. Назначение; чего зона не делает; публичный API (модуль или файл); события; таблицы; разрешённые импорты; команды L0; ловушки; ссылки на контракты.
  • Жизненный цикл. Создаёт владелец зоны; обновляет агент в той же задаче, где меняется публичный API; проверка — на ревью по доказательствам.
  • Пример.
Зона: billing
Назначение: тарифы, лимиты, счета, приём оплат через адаптер провайдера.
Не делает: не отправляет уведомлений, не меняет заявки, не читает таблицы других зон.
Публичный API: app/billing/api.py (BillingLimits, get_plan, issue_invoice).
События: публикует InvoiceIssued.v1, PaymentFailed.v1 (contracts/events/billing/*.json).
Таблицы: billing_plan, billing_invoice, billing_payment. Миграции только в app/billing/migrations.
Импорты: только app.platform.api и contracts; внутренности — app/billing/internal/*.
L0: make check ZONE=billing   # pyright + lint-imports + pytest app/billing --testmon
Ловушки: суммы в копейках (int); провайдер в тестах — FakePaymentAdapter.

6.3. Контракт между зонами

  • Назначение. Договорённость «как между чёрными ящиками», достаточная, чтобы две стороны разрабатывались одновременно разными агентами.
  • Структура. Семь вопросов подхода пользователя плюс поля, которых не хватает (раздел 5.4). Источник истины — машиночитаемая схема; markdown поясняет её.
Поле Содержание
1. Отправитель Зона-поставщик или производитель события
2. Получатель Зоны-потребители (список)
3. Событие или операция Имя, вид (синхронный вызов, HTTP, событие, задача)
4. Что передаётся Ссылка на схему (OpenAPI, AsyncAPI, JSON Schema, protobuf) и пример
5. Гарантии Постусловия, доставка (не менее одного раза), идемпотентность по ключу, порядок, задержка, объём
6. Запреты Предусловия и что стороны не делают (не читать чужие таблицы, не полагаться на порядок полей)
7. Гейт Какие проверки должны пройти: сравнение схемы, контрактные тесты, трасса, уровень L1/L3, кто принимает
8. Ошибки Коды и типы ошибок, повторы, таймауты, поведение потребителя при отказе
9. Арендатор и права Как передаётся арендатор, где проверяются права
10. Версия и совместимость Текущая версия, политика совместимых изменений, срок жизни старой версии
11. Тестовые обязательства Тесты поставщика, тесты потребителя, заглушка, трасса
12. Владелец и решения Владелец контракта и ссылки на записи решений
  • Жизненный цикл. Создаётся до реализации сторон отдельной задачей и отдельным PR; меняется только записью решения; устаревшая версия удаляется по сроку после миграции потребителей (expand → contract) факт [S42].
  • Пример.
Контракт: InvoiceIssued v1
1 Отправитель: billing   2 Получатели: notifications, reporting, integrations
3 Событие: InvoiceIssued (асинхронно, через outbox → Redis/Celery)
4 Данные: contracts/events/billing/invoice_issued.v1.json
  {tenant_id, invoice_id, customer_user_id, amount_minor, currency, due_date, issued_at}
5 Гарантии: доставка ≥1 раза; ключ идемпотентности invoice_id; порядок не гарантирован;
  публикуется после фиксации транзакции
6 Запреты: потребители не читают billing_*; не опираются на порядок событий
7 Гейт: schema-diff без несовместимых изменений; тесты потребителей на фикстурах v1;
  трасса T5 на L1 при изменении схемы; принимает владелец billing
8 Ошибки: при сбое обработчика — повтор с экспоненциальной задержкой, после 5 — dead letter
9 Арендатор: tenant_id обязателен; права потребителя не проверяются (внутреннее событие)
10 Версия: v1; новые поля только необязательные; v1 живёт ≥30 дней после выхода v2
11 Тесты: billing — публикация по сценарию; notifications — обработчик по фикстуре, повтор идемпотентен
12 Владелец: Анна; решения: docs/decisions/0012-invoice-issued.md

6.4. Правила контракта для параллельной разработки агентами

  1. Контракт сливается в основную ветку до начала реализации обеих сторон; без слитого контракта задачи реализации не выдаются.
  2. Источник истины — схема; проза не противоречит схеме, генерируемые типы не редактируются руками.
  3. Агент реализации не меняет контракт в том же PR; нужна правка — агент останавливается и описывает её в отчёте.
  4. По умолчанию только совместимые изменения; несовместимое — новая версия рядом со старой, запись решения, срок удаления старой факт [S42, S81].
  5. Потребитель читает терпимо: игнорирует незнакомые поля факт [S43].
  6. Из контракта генерируется заглушка; потребитель разрабатывается против неё, поставщик проверяется контрактными тестами факт [S80, S26].
  7. Контракт называет ошибки, повторы, идемпотентность, порядок и арендатора; без этих полей контракт не считается готовым.
  8. У каждого контракта есть трасса и тестовые обязательства обеих сторон.
  9. Изменение схемы автоматически запускает перепроверку по таблице 6.8.
  10. Общих изменяемых структур вне контрактов нет: ни общих таблиц, ни глобальных объектов состояния.

6.5. Запись решения об изменении контракта

  • Назначение. Сохранить причину изменения и версию, чтобы следующие сессии агентов не откатывали решение по незнанию.
  • Структура. По Nygard: заголовок, контекст, решение, статус (предложено, принято, устарело, заменено), последствия факт [S81]; плюс версия контракта, затронутые зоны, срок удаления старой версии.
  • Жизненный цикл. Создаётся в задаче изменения контракта; при замене получает статус «заменено» со ссылкой на новое.
  • Пример. 0012 — InvoiceIssued v1: сумма в минорных единицах. Контекст: округления в notifications. Решение: amount_minor:int, currency:str. Статус: принято. Последствия: notifications и reporting переходят на v1 до 2026-10-31; v0 удаляется после миграции.

6.6. Конфигурация контроля зависимостей

  • Назначение. Превратить «чего зона не делает» в правило, которое проверяет CI и объясняет агенту.
  • Жизненный цикл. Создаётся на шаге 3 методики; новые нарушения блокируют PR; старые заморожены списком и убывают.
  • Пример для Python. import-linter поддерживает контракты forbidden, protected, layers, independence и acyclic siblings факт [S20].
[tool.importlinter]
root_package = "app"

[[tool.importlinter.contracts]]
name = "Функциональные зоны независимы"
type = "independence"
modules = ["app.identity", "app.catalog", "app.orders", "app.billing",
           "app.notifications", "app.reporting", "app.integrations"]

[[tool.importlinter.contracts]]
name = "reporting читает только события"
type = "forbidden"
source_modules = ["app.reporting"]
forbidden_modules = ["app.orders", "app.billing", "app.catalog"]
  • Пример для TypeScript. Правило границ Nx задаёт теги проектов и ограничения depConstraints факт [S79].
"@nx/enforce-module-boundaries": ["error", {
  "depConstraints": [
    { "sourceTag": "scope:billing", "onlyDependOnLibsWithTags": ["scope:billing", "scope:shared"] },
    { "sourceTag": "type:feature", "onlyDependOnLibsWithTags": ["type:ui", "type:data-access", "type:util"] }
  ]
}]

6.7. Сквозная трасса

  • Назначение. Проверить, что зоны вместе реализуют критический сценарий; трасса — единственный вид теста, которому разрешено проходить через много зон.
  • Поля. Идентификатор, сценарий, зоны и контракты по порядку, ожидаемые наблюдаемые результаты, уровень прогона, триггеры перепроверки.
  • Жизненный цикл. Пишется на шаге 7 методики до реализации (как спецификация), реализуется как тест после готовности зон; удаляется вместе со сценарием.
  • Пример. T5 «Счёт → письмо»: billing.issue_invoice → InvoiceIssued.v1 → notifications.handle → письмо в тестовом почтовом ящике с суммой и ссылкой оплаты. Уровень: L1 при изменении billing, notifications или схемы InvoiceIssued; иначе L3.

6.8. Таблица «что изменилось → что перепроверить»

Что изменилось Что перепроверить Что не перепроверять Кто принимает
Внутренности зоны, публичный API не изменён Статические проверки, тесты зоны, снимок публичного API не изменился Тесты других зон, контракты Тесты + агент-ревьюер; человек выборочно
Публичный API зоны, совместимое изменение Тесты зоны, сравнение схемы на совместимость, контрактные тесты потребителей, регенерация клиентов Трассы, не проходящие через изменённую операцию Человек смотрит дифф контракта
Несовместимое изменение контракта Запись решения, тесты поставщика по обеим версиям, тесты всех потребителей, трассы через границу — Владелец контракта и владельцы потребителей
Схема события (новое необязательное поле) Сравнение схемы, тесты потребителей на фикстурах, сценарный тест производителя Синхронные API Владелец производителя
Миграция БД зоны Тесты зоны на мигрированной БД, проверка отката, проекции, построенные по событиям зоны Другие зоны Человек всегда
Ядро platform (арендатор, права, outbox) Полный прогон L3 и трассы безопасности — Человек всегда
Lock-файл, версия языка или фреймворка Полный прогон (Nx по умолчанию считает затронутым всё факт [S11]) — Интегратор
Флаг функции или конфигурация зоны Тесты зоны при включённом и выключенном флаге факт [S33] Другие зоны Владелец зоны
Фронтенд-функция без изменения клиента API Тесты функции, визуальные снимки её страниц Серверные тесты Агент-ревьюер + скриншоты
Общий UI-кит Снимки всех страниц, использующих компонент Серверные тесты Владелец web-shell
Воркер или задача по расписанию Тест обработчика, повторная доставка (идемпотентность), сценарный тест Синхронные API Владелец зоны
Общие тестовые фикстуры и утилиты Тесты всех зон, использующих фикстуру Остальное Интегратор
Файлы правил агентов и документация Проверка ссылок Все тесты Агент-ревьюер
Конфигурация CI, линтера границ, выбора тестов Полный прогон один раз — Владелец платформы
  • Жизненный цикл. Выводится из карты зон и контрактов; строки автоматизируются в CI по путям изменённых файлов гипотеза.

6.9. Корневой файл правил агента

  • Назначение. Минимум, который нужен каждой сессии: карта, правила границ, команды проверки. Всё остальное — в паспортах зон и skills вендор [S37].
  • Структура. Проект в одну строку; где карта и паспорта; правила границ; уровни проверки и команды; требования к отчёту; что запрещено. Целевой размер — десятки строк, не больше ~100–200 вендор [S44, S37].
  • Жизненный цикл. Правится как код; строка удаляется, если без неё агент не ошибается вендор [S5]; то, что должно выполняться всегда, переносится в хуки вендор [S5].
  • Пример.
Проект: сервис заявок и счетов.
Карта зон: docs/zones.md. Перед работой прочитай паспорт своей зоны: app/<zone>/AGENTS.md.
Границы:
- Работай только в зоне из карточки задачи. Чужие зоны — только через contracts/ и app/platform/api.
- Не меняй contracts/ в задаче реализации. Нужна правка контракта — остановись и опиши её.
- Маршруты, миграции, переводы — только в папке своей зоны.
Проверка:
- L0 до завершения: make check ZONE=<zone>. Полный набор тестов не запускай.
- В отчёте: вывод make check, список изменённых файлов, скриншот для UI.

6.10. Карточка задачи для агента

  • Назначение. Самодостаточная постановка, по которой агент работает без уточнений.
  • Поля. Цель; зона; разрешённые пути; контракты (ссылки и версии); чего не делать; критерии приёмки как команды или тесты; трассы; размер; модель и уровень рассуждения; формат отчёта.
  • Жизненный цикл. Создаётся из очереди задач владельцем зоны или оркестратором; закрывается вместе с PR; переделка оформляется новой карточкой с уточнённой постановкой.
  • Пример.
Задача ORD-41: проверка лимита заявок по тарифу
Зона: orders. Пути: app/orders/**, web/features/orders/**.
Контракты: billing.openapi.yaml v1.3 (/billing/usage), OrderLimitExceeded.v1.
Не делать: не менять billing и contracts; не отправлять уведомлений.
Приёмка: make check ZONE=orders; тест test_order_rejected_over_limit; трасса T3 на заглушке billing.
Размер: ≤ 400 строк диффа. Модель: средняя; рассуждение: обычное.
Отчёт: вывод проверок, изменённые файлы, открытые вопросы.

6.11. Пакет доказательств приёмки

  • Назначение. Позволить принять PR без повторения проверок; проверять доказательство быстрее, чем повторять проверку вендор [S5].
  • Поля. Команды и их вывод (L0, L1), дифф контракта (ожидаемо пустой или ссылка на решение), скриншоты для UI, замечания агента-ревьюера и что с ними сделано, открытые риски.
  • Жизненный цикл. Генерируется агентом в конце задачи, прикладывается к PR, хранится вместе с PR.

С чем используется в связке

7.1. Типичные комбинации

Связка Зачем вместе Источник
Модульный монолит + магистральная разработка + флаги функций Зоны дают раздельные файлы, магистраль — частую интеграцию, флаги — слияние незавершённого мнение [S18, S31, S33]
Контракт-первым + мок-сервер + сравнение схем + контракты потребителя Схема задаёт интерфейс, заглушка снимает ожидание, сравнение блокирует поломку, контрактные тесты проверяют фактическое использование факт [S41, S80, S26]
Worktree на агента + одноразовые контейнеры + выбор тестов Изоляция файлов, окружения и объёма проверки на одной машине факт [S29, S84, S28, S11]
Интервью и SPEC.md + карточка задачи + субагент-ревьюер Точная постановка, чистый контекст реализации, независимая проверка вендор [S5]
Платформенная команда + владельцы зон Платформа по Team Topologies снимает когнитивную нагрузку с потоковых команд; у агентов роль платформы — CI, линтеры, шаблоны, хуки мнение [S92, S16]
Способности модели DORA для ИИ Практики контроля версий, малые партии, качественная внутренняя платформа, доступ ИИ к внутреннему контексту эмпирика [S93]

7.2. Что предшествует и что следует

  • Предшествует: базовый CI с автотестами (без исполняемой проверки зоны не дают локальной приёмки вендор [S5]); разбор предметной области и списка изменчивых решений; практика записей решений факт [S81].
  • Следует: измерение потока (раздел 8), регулярная уборка энтропии (C10), ночной полный прогон, пересмотр границ по данным о задачах, которые всё равно пересекают зоны.

7.3. Конфликты и несовместимости

  • Долгоживущие ветки агентов против магистральной разработки. Ветки, живущие дни, превращают параллельность в «большой взрыв» интеграции; DORA требует слияния не реже раза в день факт [S31].
  • Команды агентов без раздела файлов. Команды агентов Claude Code не изолируют участников по worktree; два участника в одном файле перезаписывают друг друга вендор [S10].
  • Тяжёлый SDD-конвейер и мелкие задачи. Для мелкой правки конвейер требует непропорционально много шагов мнение [S75].
  • Микросервисы и один разработчик. Наценка распределённости не окупается без требований масштабирования мнение [S74].
  • Выбор тестов и негерметичные тесты. Кеш и выбор по изменениям ошибаются при зависимостях от времени, сети и системных файлов факт [S12, S28].
  • Флаги функций и объём тестов. Каждый флаг удваивает число значимых конфигураций, если его не удалять факт [S33].
  • Отказ от ревью при высоком потоке PR. Рост PR без ревью сопровождается ростом инцидентов на PR эмпирика [S2].
  • Кеш промптов и частая смена инструментов. Изменение определений инструментов или подключённых MCP-серверов инвалидирует весь кеш факт [S89].
  • Проверки «приватности» пакетов и соглашения фреймворка. Shopify удалил их, потому что они ломали соглашения Rails и превращали инструмент зависимостей в инструмент дизайна API вендор [S72].

Метрики здоровья и антипаттерны

Метрики сгруппированы по трём целям пользователя: скорость, расход лимитов, лишняя работа. Там, где источник не даёт нормы, значение помечено как ориентир.

Признак Здоровая норма Симптом деградации Источник
Доля задач, затрагивающих одну зону ориентир: ≥ 80 % большинство задач трогают 3+ зон авторский ориентир гипотеза
Новые нарушения границ в CI 0 новых; замороженный список убывает список нарушений растёт практика Shopify «не хуже» [S72] вендор
Время проверки L0 в сессии агента ориентир: секунды — 2 мин; агент запускает отдельные тесты, а не весь набор агент запускает полный набор после каждой правки рекомендация предпочитать отдельные тесты [S5] вендор
Время CI на PR (L1) ориентир: ≤ 10 мин и не растёт с размером системы растёт линейно с системой ориентир гипотеза; механизм affected [S11]
Доля тестов, запускаемых на PR заметно меньше 100 %; в Meta — около трети транзитивно зависящих при >99,9 % пойманных регрессий 100 % на каждой итерации [S27] эмпирика
Нестабильные тесты ориентир: < 1–2 % прогонов с повтором; кластеры чинятся по общей причине перезапуск до зелёного стал нормой [S46] эмпирика; норма — ориентир
Доля PR с конфликтами слияния ориентир: < 10 % на уровне базовой линии PR агентов в открытых проектах: 27,67 % [S49] эмпирика
Размер PR агента ориентир: ≤ 400 строк диффа рост размера PR (+154 % в данных Faros 2025) [S32] мнение; [S1] эмпирика
Время до первого ревью ориентир: в пределах рабочего дня рост (+156,6 % медианы в Faros 2026) [S2] эмпирика
Доля слитых PR агентов без правок человека растёт; база 54,9 % в выборке Claude Code падает [S52] эмпирика
Дубли и брошенные PR агентов ориентир: дублей нет; брошенные — единицы 23 % дубликатов и 38 % брошенных среди отклонённых PR [S51] эмпирика
PR, слитые без ревью не растут вместе с потоком рост (+31,3 %) вместе с инцидентами на PR (+242,7 %) [S2] эмпирика
Исправлений подряд в одной сессии ≤ 2, затем новая сессия с лучшей постановкой длинные цепочки исправлений [S5] вендор
Доля входа из кеша промптов в основной сессии ориентир: ≥ 80–90 % (пример в документации — 91 %) частые промахи, флаг в /usage [S37] вендор
Поведение, занимающее ≥ 10 % расхода (длинный контекст, промахи кеша) не отмечено в /usage отмечено постоянно [S37] вендор
Расход лимита на слитый PR снижается от месяца к месяцу растёт при том же типе задач ориентир гипотеза; атрибуция в /usage [S37]
Размер корневого файла правил ~100 строк оглавления; до ~200 строк растёт, правила игнорируются [S44, S37] вендор
Инциденты и баги на PR стабильны при росте потока растут быстрее потока (+54 % багов на разработчика в Faros 2026) [S2] эмпирика
Отток и дублирование кода стабильны отток растёт (+861 % в Faros 2026), доля копипасты растёт [S2, S54] эмпирика

Антипаттерны

Рой в одной папке

Как выглядит. Четыре агента получили четыре задачи «про биллинг»; каждый правит billing/services.py, корневой маршрутизатор и общие настройки; к вечеру три PR в конфликте, а после ручного слияния падают сквозные сценарии.

Почему возникает. Параллельность запускается раньше, чем нарезка: задачи делятся по фичам, а не по файлам и зонам; горячие общие файлы не устранены. Конфликты у одновременных PR агентов — 19,8 % у однотипных и 41,7 % у разных агентов эмпирика [S4].

Как чинить. Одна задача — одна зона (C1), вертикальные срезы внутри зоны (A5), автообнаружение вместо общих реестров (A11), worktree на агента (C2), одна точка интеграции (C7).

Когда менять практику. Если после нарезки больше 20 % задач всё равно пересекаются по файлам (ориентир, гипотеза), границы зон проведены неверно — пересобрать карту зон по фактическим изменениям.

Затор приёмки

Как выглядит. Агенты открывают по 10 PR в день, человек ревьюит два; очередь растёт, PR устаревают и конфликтуют, часть молча бросается.

Почему возникает. Генерация масштабируется, приёмка — нет; время ревью растёт кратно при росте потока эмпирика [S1, S2]; практик с несколькими агентами может принять одно значимое изменение за раз мнение [S47].

Как чинить. WIP-лимит по ёмкости приёмки (C8), малые PR (C3), доказательства и хук остановки (C6), субагент-ревьюер для первого прохода, человек — по риску (контракты, миграции, права, деньги).

Когда менять практику. Если время до первого ревью стабильно дольше рабочего дня, сократить число параллельных агентов, а не добавлять ревьюеров-агентов без критериев.

Библия агента

Как выглядит. Корневой CLAUDE.md на 800 строк с историей проекта, описанием каждого файла и десятком «ВАЖНО»; агент всё равно нарушает правила, а каждая сессия начинается с тысяч токенов.

Почему возникает. Каждая ошибка агента лечится новой строкой; правила не удаляются. Документация прямо предупреждает, что раздутый файл заставляет агента игнорировать инструкции вендор [S5].

Как чинить. Оглавление на ~100 строк со ссылками вендор [S44], паспорта зон во вложенных файлах (D1), редкое — в skills, обязательное — в хуки вендор [S5, S37].

Когда менять практику. Если агент задаёт вопросы, ответ на которые есть в файле, или игнорирует явные правила, — файл слишком длинный или двусмысленный вендор [S5].

Большой взрыв интеграции

Как выглядит. Каждый агент неделю работает в своей ветке; в пятницу пять веток сливаются, половина сквозных сценариев падает, и следующая неделя уходит на стыки.

Почему возникает. Изоляция воспринимается как разрешение не интегрироваться; контракты не зафиксированы до начала работы, заглушки расходятся с реальностью.

Как чинить. Слияние не реже раза в день и не больше трёх активных веток факт [S31]; контракт до реализации (6.4); флаги для незавершённого (C4); трассы на L1 при изменении границ.

Когда менять практику. Если интеграция занимает больше времени, чем разработка зон, задачи слишком крупные или контракты недоопределены.

Спецификационный театр

Как выглядит. На правку в одну строку генерируются requirements.md, design.md и tasks.md; человек не читает их, агент частично им не следует.

Почему возникает. Процесс SDD применяется одинаково ко всем задачам; Böckeler зафиксировала избыточность для мелких задач, тяжесть ревью markdown и неполное следование агентов спецификации мнение [S75].

Как чинить. Спецификация пропорционально размеру: для задачи, описываемой одним предложением, план пропускается вендор [S5]; для крупных фич — интервью и SPEC.md; долговечны только контракты, паспорта и решения.

Когда менять практику. Если время на спецификации сопоставимо с временем реализации для большинства задач или спецификации расходятся с кодом.

Инструменты и софт

9.1. Категории

Категория Продукты Что даёт в предмете
Агенты с параллельной работой Claude Code, Codex (CLI и cloud), Cursor cloud agents, агент GitHub Copilot, Jules, Devin Исполнители задач в изолированных копиях или средах факт [S58, S30, S59, S60, S61, S62]
Спецификации Spec Kit, Kiro Конвейер требования → план → задачи, в Kiro — параллельные волны независимых задач факт [S76, S63]
Контекст AGENTS.md, CLAUDE.md, карта репозитория Aider Правила и карта для агента факт [S34, S35]
Контроль границ import-linter, tach, Packwerk, Spring Modulith, правило границ Nx Запрет незаявленных зависимостей и циклов факт [S20, S38, S18, S19, S79]
Выбор тестов и кеш Nx affected, Bazel, Spring Modulith, pytest-testmon, CloudBees Smart Tests Перепроверка затронутого и повторное использование результатов факт [S11, S12, S39, S28, S85]
Контракты OpenAPI + oasdiff, protobuf + buf, AsyncAPI, Pact, Prism Схемы, проверка совместимости, контракты потребителя, заглушки факт [S41, S40, S77, S26, S80]
Окружения Testcontainers, облачные среды агентов Одноразовые зависимости, параллельные прогоны без конфликтов портов факт [S84]
Эталонные тесты ApprovalTests, снимки Проверка сложных выходов без ручного просмотра факт [S86]
Стек изменений Graphite Цепочки малых PR факт [S88]

9.2. Функциональный разбор ведущих агентов

Цены и лимиты проверены 2026-09-27 по страницам производителей.

Claude Code

  • Сущности. Сессии; worktree; субагенты (.claude/agents/, модель и инструменты на субагента, isolation: worktree); skills; хуки; CLAUDE.md; MCP-серверы; команды агентов (экспериментально); фоновые сессии в agent view (предварительная версия); динамические workflows факт [S36, S29, S58, S10].
  • Ключевые операции. claude --worktree <имя> — сессия в своей копии и ветке; claude -p с выводом JSON — запуск без интерфейса в скриптах и CI; /batch делит крупное изменение на 5–30 субагентов в worktree; /code-review — проверка диффа субагентом со свежим контекстом; хук Stop блокирует завершение до прохождения проверки; /usage показывает расход, долю кеша и атрибуцию по субагентам, skills и MCP факт [S5, S37, S58].
  • Интеграции. CLI gh и другие CLI, MCP, IDE, десктоп, облачные сессии, обмен сообщениями между своими сессиями факт [S5, S58].
  • Ограничения. Субагенты расходуют те же лимиты факт [S36]; команды агентов не изолируют участников по worktree, не восстанавливаются при /resume, одна команда на сессию факт [S10]; worktree не копирует неотслеживаемые файлы без .worktreeinclude факт [S29].
  • Цена входа. Pro $20 в месяц, Max 5x $100 в месяц, Team $25 (стандартное место) или $125 (премиальное место); Claude Code входит во все платные планы факт [S91]; лимиты — пятичасовое окно и недельный лимит факт [S70]; цену Max 20x страница показала неоднозначно, поэтому она здесь не приводится.

Codex (CLI и cloud)

  • Сущности. Локальные сессии, облачные задачи в изолированных окружениях с настраиваемыми зависимостями и скриптами установки, AGENTS.md факт [S30, S34].
  • Ключевые операции. Делегирование задач в облако и параллельная работа нескольких задач; запуск из PR GitHub, MR и задач GitLab, задач Linear и Slack; просмотр сводки и диффа, открытие PR факт [S30].
  • Интеграции. GitHub, GitLab, Linear, Slack факт [S30].
  • Ограничения. Локальные сообщения и облачные задачи делят один лимит; число локальных сообщений за 5 часов зависит от модели на порядок; облачные задачи могут расходовать больше ресурсов, чем локальная работа вендор [S71].
  • Цена входа. Plus $20, Pro от $100 (варианты 5x и 20x лимитов), Business $20 за пользователя в месяц при годовой оплате и $25 при помесячной факт [S71]. Советы производителя по экономии: точные инструкции без лишнего контекста, меньший AGENTS.md через вложенную организацию, отключение неиспользуемых MCP-серверов вендор [S71].

Cursor cloud agents

  • Сущности. Облачные агенты в изолированных ВМ с полной средой разработки; конфигурация среды .cursor/environment.json и снимки факт [S59].
  • Ключевые операции. Запуск из десктопа, веба, мобильного приложения, Slack, комментариев GitHub или Bitbucket, Linear, API; работа в нескольких репозиториях; PR с артефактами (скриншоты, видео, логи) факт [S59].
  • Ограничения. Эффективность ограничена настройкой среды: производитель называет её самым важным шагом вендор [S59].
  • Цена входа. Оплата по тарифам API в зависимости от модели и размера контекста с обязательным лимитом расходов факт [S59].

Агент GitHub Copilot

  • Сущности. Задача (issue), ветка, PR; среда на GitHub Actions факт [S60].
  • Ключевые операции. Назначение задачи агенту, работа в ветке, открытие PR для ревью факт [S60].
  • Ограничения. Один репозиторий за сессию, одна ветка и один PR на задачу, максимум 59 минут, только GitHub; правила защиты веток могут блокировать доступ факт [S60].
  • Цена входа. Расходует минуты GitHub Actions и кредиты ИИ; в пределах включённых объёмов платных планов Copilot без доплаты факт [S60].

Кратко о прочих: Jules — асинхронный агент в облачной ВМ с утверждением плана до изменений факт [S61], платные уровни с лимитами в 5 и 20 раз выше базового факт [S94]; Devin — параллельные сессии, задачи до ~3 часов с явными критериями вендор [S62].

9.3. Что выбрать

Масштаб Агенты Архитектура и тесты Контракты
Один человек Claude Code или Codex CLI локально, worktree на задачу; облачные задачи (Codex cloud, Copilot agent) для рутины import-linter или tach (Python), правило границ Nx или ESLint (TypeScript); pytest-testmon или nx affected OpenAPI + oasdiff, мок-сервер Prism; Pact не нужен внутри одного процесса
Команда до 10 То же плюс облачные агенты для бэклога рутинных задач; общая очередь задач То же плюс удалённый кеш Nx или Bazel; ночной полный прогон; очередь слияния Pact на межпроцессных границах (фронтенд и сервер при раздельном развёртывании, внешние интеграции); buf для protobuf
Организация Корпоративные планы с аналитикой и управляемыми настройками факт [S37] Bazel или Nx с распределённым выполнением; предиктивный выбор тестов при большой истории прогонов [S27, S85] Реестр схем, обязательное сравнение в CI

Выбор в таблице — авторская рекомендация по данным разделов 4 и 9 гипотеза.

Адаптация под LLM и агентов

10.1. Что автоматизируется и что остаётся человеку

Работа Агент Человек
Выписать изменчивые решения и подобласти черновик по интервью решение о границах
Контракты черновик схемы, заглушки, генерация типов утверждение контракта и несовместимых изменений
Реализация зоны полностью, в своей копии —
Тесты зоны, эталоны написание и запуск одобрение новых эталонов
Контроль границ линтер и его сообщения правила границ
Первый проход ревью субагент со свежим контекстом [S5] вендор ревью по риску: контракты, миграции, права, деньги
Интеграция перебазирование, разрешение конфликтов своей зоны порядок слияния, спорные конфликты
Уборка энтропии фоновые задачи [S44] вендор «золотые принципы»
Приоритизация и критерии приёмки — полностью; в кейсе OpenAI люди расставляют приоритеты и переводят обратную связь в критерии приёмки [S44] вендор

10.2. Изоляция контекста

  • Субагенты. Работают в своём окне с собственным системным промптом, инструментами и правами; не получают историю разговора и возвращают сводку факт [S36]. Вложенность по умолчанию до трёх уровней, до 20 одновременных субагентов на сессию факт [S36].
  • Форки. Форк наследует всю историю родителя и не изолирован по контексту факт [S36]; использовать, когда нужна преемственность, а не чистый лист.
  • Worktree. Изолирует файлы, но не контекст и не лимиты факт [S29].
  • Свежая сессия после спецификации. Реализация в новой сессии с чистым контекстом по SPEC.md вендор [S5].
  • Заметки вне окна. Агент записывает выводы в файлы и подгружает их при необходимости; это альтернатива длинной истории вендор [S78].

10.3. Как устроены и расходуются лимиты подписок

Claude. У Max сессионный лимит сбрасывается каждые пять часов, поверх действует недельный лимит на все модели факт [S70]; у Team и Enterprise место имеет пятичасовое и недельное окна, общие с чатом Claude факт [S37]. Расход зависит от длины сообщений и разговора, вложений, инструментов, модели и уровня рассуждения вендор [S95]; фиксированного числа сообщений на прочитанных страницах поддержки нет факт [S70, S95]. Механика расхода в Claude Code вендор [S37]:

  • каждый запрос несёт весь разговор; вызовы инструментов порождают новые запросы с результатами;
  • с кешем история перечитывается по сниженной ставке, но однострочный вопрос в длинной сессии всё равно расходует лимит на весь разговор;
  • первый запрос после паузы дольше времени жизни кеша (час на подписке) пересчитывает весь контекст;
  • задачи по расписанию, сообщения между сессиями, проверки целей, субагенты и участники команд агентов отправляют собственные запросы;
  • /compact сам по себе крупный запрос, /clear бесплатен.

Codex. Локальные сообщения и облачные задачи делят один лимит; количество сообщений за 5 часов различается по моделям (на Plus: 5–45, 15–150 или 350–3000 в зависимости от модели), крупные задачи и длинные сессии расходуют заметно больше на сообщение вендор [S71].

Правило бюджета (авторская модель, гипотеза).

Агентов одновременно ≤ min( ёмкость приёмки в задачах за окно,
                            бюджет окна / средний расход задачи )
Средний расход задачи ≈ (постоянный контекст + чтение зоны + итерации × (вывод проверок + дифф))
                        × (1 + доля субагентов)

Из формулы видно, какие рычаги уменьшают расход: постоянный контекст (D1), чтение зоны (D2, D3), вывод проверок (D5, B3), число итераций (C1, C9) и доля субагентов и команд (D4, D8).

10.4. Субагенты и оркестрация: какой режим когда

Режим Когда Цена Источник
Субагент в сессии Побочная задача засорила бы контекст: поиск, логи, прогоны Ниже, чем у команд; сводка возвращается родителю [S36, S10] факт
Writer/Reviewer Независимая проверка кода, который только что написан Одна дополнительная сессия [S5] вендор
Ручные параллельные сессии в worktree Независимые задачи в разных зонах Линейно по числу сессий [S29, S58] факт
/batch или цикл claude -p Однотипная правка по многим файлам 5–30 субагентов [S5, S58] факт
Динамический workflow Работа больше нескольких субагентов, нужна перекрёстная проверка Высокая [S58] факт
Команды агентов Исследование, ревью по разным критериям, отладка конкурирующих гипотез, независимые модули ~7x токенов в режиме плана; 3–5 участников [S37, S10] вендор
Облачные агенты Рутина из бэклога, работа при выключенной машине Отдельная среда; общий лимит у Codex [S30, S71, S60, S59] факт

Практическая топология для кода — оркестратор (человек или ведущая сессия) плюс изолированные исполнители, каждый в своей зоне и копии мнение [S15]. Anthropic отмечает, что кодинг хуже параллелится, чем исследование, из-за общего контекста и зависимостей вендор [S53]; зоны и контракты как раз убирают общий контекст между исполнителями гипотеза.

10.5. Выбор модели и уровня рассуждения под задачу

Задача Класс модели Рассуждение
Поиск и чтение кода (Explore) малая или средняя низкое
Проектирование зон и контрактов сильнейшая высокое
Реализация внутри зоны по контракту средняя обычное
Однотипные правки веером малая или средняя низкое
Ревью диффа и проверка по критериям сильная, свежий контекст обычное–высокое
Разбор вывода тестов и логов малая, через субагента низкое

Таблица — авторская рекомендация гипотеза, опирающаяся на совет производителя: средняя модель для большинства задач, сильнейшая — для архитектуры и многошагового рассуждения, малая — для простых субагентов, пониженный уровень рассуждения для простых задач вендор [S37].

10.6. Детерминированные скрипты вместо рассуждений

  • Проверки: make check ZONE=<zone> как единая точка L0, хук Stop, который не даёт завершить работу без зелёной проверки вендор [S5].
  • Фильтры вывода: хук, оставляющий только падения тестов вендор [S37].
  • Генераторы: каркас среза, клиента API и типов из схемы; паспорт зоны и карта из конфигурации линтера гипотеза.
  • Линтеры с инструкцией в сообщении: сообщение об ошибке одновременно говорит агенту, как исправить вендор [S44].
  • CLI вместо MCP, где есть выбор: меньше постоянного контекста вендор [S37].

10.7. Риски

  • Мнимый успех. Агент останавливается, когда работа выглядит готовой; нужны исполняемые проверки и доказательства вендор [S5].
  • Неявные решения параллельных агентов и рассогласование мнение [S48]; эмпирика [S50].
  • Отказ от ревью при высоком потоке PR эмпирика [S2].
  • Расход лимитов командами агентов и субагентами вендор [S37].
  • Права и безопасность. Сообщение одного агента не может подтвердить разрешение от имени человека, в автоматическом режиме классификатор проверяет сообщения между агентами факт [S10]; фоновые агенты с широкими правами требуют песочницы вендор [S5].
  • Быстрое устаревание сведений об инструментах. Одна страница документации Claude Code о worktree описывает изменения поведения в десятках версий, от v2.1.198 до v2.1.281 факт [S29]; выводы о конкретных функциях нужно перепроверять при каждом обновлении гипотеза.

10.8. Открытые репозитории и инструменты (доступ 2026-09-27)

  • github/spec-kit — конвейер SDD с командами constitution, specify, plan, tasks, implement факт [S76].
  • tach-org/tach — контроль зависимостей и публичных интерфейсов модулей Python факт [S38].
  • oasdiff/oasdiff — поиск несовместимых изменений OpenAPI факт [S41].
  • import-linter — контракты импорта Python факт [S20].
  • Aider — карта репозитория факт [S35].
  • agents.md — формат файла правил факт [S34].

Происхождение, ключевые фигуры, что читать

11.1. Этапы

Год Событие Какую боль решало Что актуально для агентов
1968 Conway, «How Do Committees Invent?» факт [S14] Почему структура систем повторяет структуру организаций Структура агентов и их прав становится структурой кода
1972 Parnas, критерии декомпозиции на модули; CACM 15(12) факт [S96, S8] Независимая работа групп и изменяемость Зона прячет решение, агент читает только интерфейс соседа
1986 Meyer, Design by Contract факт [S90] Обязательства клиента и поставщика Гарантии и запреты в контракте
2003 Evans, ограниченные контексты DDD (по пересказу Fowler) факт [S17] Невозможность единой модели большой системы Зоны по языку предметной области
2005 Cockburn, порты и адаптеры факт [S21] Логика, связанная с UI и БД, не тестируется Быстрые тесты ядра и фейки соседей
2006 Robinson, контракты, задаваемые потребителем факт [S43] Независимая эволюция сервисов Контрактные тесты и терпимое чтение
2011 Nygard, записи архитектурных решений факт [S81] Потеря причин решений Версия контракта с причиной для следующих сессий
2014–2015 Lewis и Fowler о микросервисах; MonolithFirst; наценка микросервисов факт [S82, S73, S74] Независимое развёртывание и его цена Модульный монолит как стандарт для малых команд
2016–2018 Магистральная разработка и малые партии в исследованиях DORA [S31]; предиктивный выбор тестов Meta [S27]; вертикальные срезы [S22]; практическая пирамида и «соты» [S23, S24] факт Скорость поставки и стоимость тестов Короткие ветки агентов и выбор тестов
2019–2023 Team Topologies: когнитивная нагрузка, типы команд факт [S92, S16] Перегрузка команд Размер зоны под «когнитивную нагрузку» агента — окно контекста
2020–2024 Модульный монолит Shopify и ретроспектива Packwerk факт [S18, S72] Масштаб монолита 2,8 млн строк Механизация границ и её пределы
2024–2026 Агенты, фоновые и облачные задачи, AGENTS.md, SDD, лимиты подписок факт [S58, S30, S34, S76, S70] Генерация кода подешевела Узкое место — проверка, интеграция и контекст

11.2. Ключевые фигуры

  • Melvin Conway — закон о зеркальности структуры организации и системы факт [S14].
  • David Parnas — сокрытие информации и критерии декомпозиции факт [S8].
  • Bertrand Meyer — Design by Contract факт [S90].
  • Eric Evans — ограниченные контексты DDD; книга не прочитана, использован пересказ Fowler факт [S17].
  • Alistair Cockburn — порты и адаптеры факт [S21].
  • John Ousterhout — глубокие модули; книга не прочитана, использован разбор факт [S9].
  • Martin Fowler, James Lewis — микросервисы и их цена, MonolithFirst факт [S82, S73, S74].
  • Matthew Skelton, Manuel Pais — Team Topologies; книга не прочитана, использованы сайт и обзор Fowler факт [S92, S16].
  • Исследователи DORA — связь практик поставки и ИИ с результатами факт [S56, S31, S32].
  • METR — измерения эффекта ИИ и горизонтов задач факт [S7, S57, S69].

11.3. Что читать

Источник Ценность
Parnas через разбор The Morning Paper [S8] Главный критерий нарезки: прятать меняющиеся решения
Fowler, BoundedContext [S17] Коротко о границах по языку и карте контекстов
Cockburn, Hexagonal Architecture [S21] Как отвязать ядро от БД и UI ради тестов
Bogard, Vertical Slice Architecture [S22] Нарезка внутри зоны по фичам
Robinson, Consumer-Driven Contracts [S43] Основа контрактного тестирования и терпимого чтения
Vocke, The Practical Test Pyramid [S23] Где держать тесты и почему сквозных мало
Shopify, Deconstructing the Monolith [S18] Кейс модульного монолита в масштабе
Shopify, A Packwerk Retrospective [S72] Лучший критический разбор механизации границ
Meta, Predictive Test Selection [S27] Почему выбор по зависимостям избыточен и что даёт предсказание
DORA, Working in small batches [S32] Малые партии как противовес нестабильности от ИИ
METR, исследование 2025 и обновление 2026 [S7, S57] Почему ощущение ускорения нельзя принимать за измерение
Faros, AI Engineering Report 2026 [S2] Как поток PR упирается в ревью и качество
Anthropic, Best practices for Claude Code [S5] Проверка, контекст, субагенты, параллельные сессии
Anthropic, Effective context engineering [S78] Контекст как ограниченный ресурс
Anthropic, multi-agent research system [S53] и Cognition, Don't Build Multi-Agents [S48] Две стороны спора о мультиагентности
Böckeler, SDD tools [S75] Критический разбор Kiro, Spec Kit и Tessl
Where Do AI Coding Agents Fail? [S51] Почему PR агентов не сливаются

Открытые вопросы и границы уверенности

12.1. Что не удалось проверить

  • Прямой эффект архитектуры на продуктивность агентов. Контролируемых исследований, сравнивающих модульную и немодульную кодовую базу для агентов, не найдено; вывод опирается на косвенные данные (раздел 2.4).
  • Эффект конкретных приёмов для агентов: паспорта зон, размер зоны под окно, устранение горячих файлов, уровни прогона — это гипотезы автора, собранные из практик; измерений нет.
  • Числа сквозного примера (раздел 5.3) — иллюстрация, а не замер.
  • Нормы метрик раздела 8 без источника — ориентиры.
  • Точные лимиты подписок. Anthropic описывает факторы расхода, но не фиксированное число сообщений факт [S95]; цена Max 20x на странице тарифов не извлечена однозначно; точные лимиты Jules по задачам в день не подтверждены первоисточником, официальный пост указывает только кратность 5x и 20x факт [S94].

12.2. Где источники противоречат друг другу

  • Эффект ИИ на скорость: замедление в РКИ METR эмпирика [S7] против ускорения в РКИ Google и Microsoft эмпирика [S64, S65]; различаются задачи и инструменты, METR сам признаёт эффект отбора в 2026 году эмпирика [S57].
  • ИИ как усилитель практик (DORA 2025) эмпирика [S56] против «сильные основы не защищают» (Faros 2026) эмпирика [S2].
  • Мультиагентность: Anthropic использует её для исследований и советует команды агентов для ряда задач вендор [S53, S10], Cognition — против для большинства случаев мнение [S48].
  • Ревью: кейс OpenAI сдвигает ревью к агентам вендор [S45], данные Faros связывают рост PR без ревью с ростом инцидентов эмпирика [S2].
  • Доли слияния PR агентов: 83,8 % у Claude Code в выборке 567 PR эмпирика [S52] против 59,04 % в выборке 33 596 PR эмпирика [S51]; выборки и периоды различаются.

12.3. Какие данные изменили бы вывод

  • РКИ или квазиэксперимент: одинаковые задачи агентам в модульной (с линтером границ и паспортами) и немодульной версии одной системы, с замером времени, токенов, конфликтов и дефектов.
  • Данные о частоте конфликтов при дисциплине «одна задача — одна зона + worktree» по сравнению с базовой линией 19,8–41,7 % эмпирика [S4].
  • Замеры расхода лимита на слитый PR до и после внедрения стратегий блока D.
  • Независимая проверка вендорских чисел выбора тестов на малых проектах вендор [S68].

12.4. Ограничения доступа

  • Оригинал статьи OpenAI о harness engineering вернул 403; использованы два независимых конспекта [S67, S44, S45] — это вторичный пересказ, атрибуция цифр не подтверждена по первоисточнику.
  • Стэнфордские данные прочитаны в пересказе доклада [S66]; рецензируемой публикации не найдено.
  • Тело поста Google о нестабильных тестах не загрузилось [S87]; часто цитируемые доли нестабильных тестов Google поэтому не приводятся.
  • Страницы ACM Digital Library и ScienceDirect недоступны (403); обзоры нестабильности прочитаны только через открытый препринт [S46].
  • PDF-версии отчётов (DORA 2025, Faros 2026, статья Парнаса) не читались; использованы страницы-обзоры и разборы [S56, S93, S2, S8].
  • Книги Evans, Ousterhout, Skelton и Pais не прочитаны; их идеи приведены по открытым пересказам [S17, S9, S92, S16].
  • Для статей arXiv по конфликтам и принятию PR [S52, S49, S50, S64] прочитаны только аннотации.

Статус отчёта complete: все обязательные разделы заполнены, ограничения перечислены выше.

Реестр источников

IDНазваниеАвтор или издательURLПубликацияДоступ (дата)Вид доступаЧто подтверждает
S1The AI Productivity Paradox Research ReportFaros AIfaros.ai/blog/ai-software-engineering2025-07-232026-09-27полный текстразделы 0, 1, 2, 8: +21 % задач, +98 % PR, +91 % время ревью, +154 % размер PR, +9 % багов; корреляционный анализ 10 тыс.+ разработчиков
S2The AI Engineering Report 2026: The AI Acceleration Whiplash — Ten TakeawaysFaros AIfaros.ai/blog/ai-acceleration-whiplash-takeaways2026-04-122026-09-27полный текстразделы 0, 1, 2, 4, 5, 7, 8, 10, 12: 22 тыс. разработчиков; +66 % эпиков, +54 % багов, медианное время ревью +441,5 %, +31,3 % PR без ревью, инциденты на PR +242,7 %
S3DORA Report 2024 – A Look at Throughput and StabilityRachel Stephens, RedMonkredmonk.com/rstephens/2024/11/26/dora2024/2024-11-262026-09-27полный текстразделы 0, 2: +25 % внедрения ИИ связано с −1,5 % пропускной способности и −7,2 % стабильности
S4AI Agent Pull Requests on GitHub: Frequency, Structure, and Merge Conflict RatesXu, Subramanian, Karthikarxiv.org/html/2607.04697v22026-072026-09-27полный текстразделы 0, 1, 2, 3, 4, 8, 12: конфликты 19,8 % у однотипных агентов и 41,7 % у разных, ~42 % структурные, lock-файлы 3,9 % конфликтных файлов
S5Best practices for Claude CodeAnthropiccode.claude.com/docs/en/best-practicesбез даты2026-09-27полный текстразделы 0, 1, 3–11: контекст как главный ресурс, проверка и доказательства, план, CLAUDE.md, субагенты, writer/reviewer, fan-out, хук Stop
S6Measuring the Self-Reported Impact of Early-2026 AI on Technical Worker ProductivityMETRmetr.org/blog/2026-05-11-ai-usage-survey/2026-05-112026-09-27полный текстразделы 0, 1, 2: опрос 349 человек, самооценка 1,4–2x, переоценка влияния ИИ на 40 п. п.
S7Measuring the Impact of Early-2025 AI on Experienced Open-Source Developer ProductivityMETRmetr.org/blog/2025-07-10-early-2025-ai-experienced-os-dev…2025-07-102026-09-27полный текстразделы 1, 2, 11, 12: РКИ, 16 разработчиков, 246 задач, замедление 19 %, ожидания +24 %
S8On the criteria to be used in decomposing systems into modules (разбор The Morning Paper)Adrian Colyerblog.acolyer.org/2016/09/05/on-the-criteria-to-be-used-in…2016-09-052026-09-27полный текстразделы 1, 2, 4, 5, 11, 12: цитаты Парнаса о выгоде модульности и критерии декомпозиции
S9Modules Should Be Deep!Marco Tulio Valente, Software Engineering: A Modern Approachsoftengbook.org/articles/deep-modulesбез даты2026-09-27полный текстразделы 1, 11, 12: глубокие модули Остерхаута, пример файлового ввода-вывода Unix
S10Orchestrate teams of Claude Code sessionsAnthropiccode.claude.com/docs/en/agent-teamsбез даты2026-09-27полный текстразделы 1, 2, 4, 5, 7, 9, 10, 12: 3–5 участников, 5–6 задач на участника, владение разными файлами, нет изоляции worktree
S11Run only tasks affected by a PR (Nx affected)Nxnx.dev/docs/features/ci-features/affectedбез даты2026-09-27полный текстразделы 1, 3, 4, 6, 7, 8, 9: граф проектов, affected, удалённый кеш, lock-файл делает затронутым всё
S12HermeticityBazelbazel.build/basics/hermeticityбез даты2026-09-27полный текстразделы 1, 3, 4, 7, 9: герметичность, кеш действий и тестов, источники негерметичности
S13Context Rot: How Increasing Input Tokens Impacts LLM PerformanceHong, Troynikov, Huber (Chroma)trychroma.com/research/context-rot2025-07-142026-09-27полный текстразделы 1, 2, 4: 18 моделей, деградация с ростом длины входа, отвлекающие фрагменты
S14How Do Committees Invent?Melvin E. Conwaymelconway.com/Home/Committees_Paper.html1968-042026-09-27полный текстразделы 1, 11: формулировка закона Конвея
S15Conway's Law Comes for Your Agent FleetTian Pantianpan.co/blog/2026/06/30/conways-law-comes-for-your-age…2026-06-302026-09-27полный текстразделы 1, 4, 10: закон Конвея для агентов, оркестратор с изолированными исполнителями (мнение)
S16Team TopologiesMartin Fowlermartinfowler.com/bliki/TeamTopologies.html2023-07-252026-09-27полный текстразделы 1, 7, 11, 12: когнитивная нагрузка, платформенные команды, связь с законом Конвея
S17BoundedContextMartin Fowlermartinfowler.com/bliki/BoundedContext.html2014-01-152026-09-27полный текстразделы 1, 3, 4, 5, 11, 12: ограниченный контекст, карта контекстов
S18Deconstructing the Monolith: Designing Software that Maximizes Developer ProductivityShopify Engineeringshopify.engineering/shopify-monolith2020-09-162026-09-27полный текстразделы 1–4, 7, 9, 11: 2,8 млн строк, 37 компонентов, Packwerk, выделение сервисов только по особым причинам
S19Spring Modulith: FundamentalsSpring (VMware/Broadcom)docs.spring.io/spring-modulith/reference/fundamentals.htmlбез даты2026-09-27полный текстразделы 1, 4, 9: модули-пакеты, API и internal, verify, allowedDependencies
S20Import Linter: Contract typesImport Linter (David Seddon)import-linter.readthedocs.io/en/stable/contract_types/без даты2026-09-27полный текстразделы 1, 3, 4, 5, 6, 9, 10: forbidden, protected, layers, independence, acyclic siblings
S21Hexagonal ArchitectureAlistair Cockburnalistair.cockburn.us/hexagonal-architecture/2005-09-042026-09-27полный текстразделы 1, 3, 4, 11: порты и адаптеры, запуск без UI и БД для тестов
S22Vertical Slice ArchitectureJimmy Bogardjimmybogard.com/vertical-slice-architecture/2018-04-192026-09-27полный текстразделы 1, 4, 11: минимум связности между срезами, максимум внутри
S23The Practical Test PyramidHam Vocke, martinfowler.commartinfowler.com/articles/practical-test-pyramid.html2018-02-262026-09-27полный текстразделы 1, 4, 5, 11: пирамида, CDC-тесты, минимум сквозных тестов
S24Testing of Microservices (Testing Honeycomb)Spotify Engineeringengineering.atspotify.com/2018/01/testing-of-microservices2018-01-112026-09-27полный текстразделы 1, 4, 11: интеграционные тесты сервиса в изоляции, отказ от integrated-тестов
S25The Testing Trophy and Testing ClassificationsKent C. Doddskentcdodds.com/blog/the-testing-trophy-and-testing-classi…2021-06-032026-09-27полный текстразделы 1, 4: статика, unit, integration, e2e; «mostly integration»
S26Pact Docs: IntroductionPact Foundationdocs.pact.io/без даты2026-09-27полный текстразделы 1, 4, 5, 6, 7, 9: контракты, задаваемые потребителем, проверка поставщика, ограниченность проверки по схеме
S27Predictive Test SelectionMeta Engineeringengineering.fb.com/2018/11/21/developer-tools/predictive-…2018-11-212026-09-27полный текстразделы 1, 2, 4, 8, 9, 11: >99,9 % регрессий при ~⅓ тестов, избыточность выбора по зависимостям
S28pytest-testmontestmon.orgtestmon.org/без даты2026-09-27полный текстразделы 1, 3, 4, 7, 9: выбор тестов по покрытию, что не отслеживается
S29Run parallel sessions with worktreesAnthropiccode.claude.com/docs/en/worktreesбез даты2026-09-27полный текстразделы 1, 2, 4, 7, 9, 10: --worktree, .worktreeinclude, что общее с основной копией, версии поведения
S30Codex cloudOpenAIlearn.chatgpt.com/docs/cloudбез даты2026-09-27фрагментразделы 1, 2, 4, 9, 10, 11: изолированные облачные окружения, параллельные задачи, PR, интеграции
S31Trunk-based development (DORA capability)DORAdora.dev/capabilities/trunk-based-development/без даты2026-09-27полный текстразделы 1, 2, 4, 7, 8, 11: ≤3 активных ветки, слияние минимум раз в день, тяжёлое ревью как ловушка
S32Working in small batches (DORA capability)DORAdora.dev/capabilities/working-in-small-batches/без даты2026-09-27полный текстразделы 1, 2, 4, 8, 11: малые партии как противовес нестабильности от ИИ, задачи на часы–пару дней
S33Feature Toggles (aka Feature Flags)Pete Hodgson, martinfowler.commartinfowler.com/articles/feature-toggles.html2017-10-092026-09-27полный текстразделы 1, 4, 6, 7: виды флагов, стоимость владения, тестирование комбинаций
S34AGENTS.mdAgentic AI Foundation (Linux Foundation)agents.md/без даты2026-09-27полный текстразделы 1, 2, 4, 5, 6, 9, 10, 11: формат, вложенные файлы, 60 тыс.+ проектов
S35Repository mapAideraider.chat/docs/repomap.htmlбез даты2026-09-27полный текстразделы 1, 4, 9, 10: карта репозитория, ранжирование по графу ссылок, бюджет 1000 токенов
S36Subagents (Claude Code docs)Anthropiccode.claude.com/docs/en/sub-agentsбез даты2026-09-27полный текстразделы 1, 4, 9, 10: собственное окно контекста, модель на субагента, isolation: worktree, общие лимиты, форки
S37Manage costs effectively (Claude Code)Anthropiccode.claude.com/docs/en/costsбез даты2026-09-27полный текстразделы 1–5, 8–10: $13 в активный день, команды агентов ~7x токенов, хуки-фильтры, CLAUDE.md до ~200 строк, кеш 1 ч на подписке, механика расхода
S38tach: enforce dependencies using modular architecturetach-org (GitHub)github.com/tach-org/tachбез даты2026-09-27полный текстразделы 1, 4, 5, 9, 10: зависимости модулей, публичные интерфейсы, tach check
S39Spring Modulith: Integration Testing Application ModulesSpring (VMware/Broadcom)docs.spring.io/spring-modulith/reference/testing.htmlбез даты2026-09-27полный текстразделы 1, 3, 4, 5, 9: @ApplicationModuleTest, Scenario API, запуск тестов только изменённых модулей
S40Breaking change detection (buf breaking)Bufbuf.build/docs/breaking/без даты2026-09-27полный текстразделы 1, 4, 5, 9: категории FILE, PACKAGE, WIRE_JSON, WIRE; проверка в CI
S41oasdiffoasdiff (GitHub)github.com/oasdiff/oasdiffбез даты2026-09-27полный текстразделы 1, 4, 5, 7, 9, 10: поиск несовместимых изменений OpenAPI, GitHub Action
S42ParallelChangeDanilo Sato, martinfowler.commartinfowler.com/bliki/ParallelChange.html2014-05-132026-09-27полный текстразделы 1, 3, 4, 5, 6: expand → migrate → contract для несовместимых изменений
S43Consumer-Driven Contracts: A Service Evolution PatternIan Robinson, martinfowler.commartinfowler.com/articles/consumerDrivenContracts.html2006-06-122026-09-27полный текстразделы 1, 4, 5, 6, 11: контракты поставщика, потребителя и задаваемые потребителем, Tolerant Reader
S44Harness engineering: leveraging Codex in an agent-first world (конспект)AI Wiki, businessdatasolutionsbusinessdatasolutions.github.io/ai-wiki/sources/2026-02-1…2026-02-112026-09-27полный текстразделы 1, 2, 4–6, 8, 10, 12: 7 инженеров, ~1 млн строк, ~1500 PR, 3,5 PR в день на инженера, слои, линтеры, AGENTS.md ~100 строк, уборка энтропии
S45OpenAI Harness Engineering (заметки)xiaow.devxiaow.dev/claude_notes/2026-03-25---Article---OpenAI-Harn…2026-03-252026-09-27полный текстразделы 1, 2, 12: «corrections are cheap, and waiting is expensive», узкое место сместилось в QA людей, ревью агент-агент
S46Systemic Flakiness: An Empirical Analysis of Co-Occurring Flaky Test FailuresParry, Kapfhammer, Hilton, McMinnarxiv.org/html/2504.167772025-042026-09-27полный текстразделы 1, 2, 4, 8, 12: 75 % нестабильных тестов в кластерах, 1,28 % времени разработчиков на починку
S47Embracing the parallel coding agent lifestyleSimon Willisonsimonwillison.net/2025/Oct/5/parallel-coding-agents/2025-10-052026-09-27полный текстразделы 1, 2, 4, 8: типы задач для параллельных агентов, ревью как узкое место, отдельные клоны
S48Don't Build Multi-AgentsWalden Yan, Cognitioncognition.com/blog/dont-build-multi-agents2025-06-122026-09-27полный текстразделы 1, 2, 4, 10, 11, 12: действия несут неявные решения, конфликт параллельных субагентов
S49AgenticFlict: A Large-Scale Dataset of Merge Conflicts in AI Coding Agent Pull Requests on GitHubOgenrwot, Busingearxiv.org/abs/2604.035512026-04-042026-09-27аннотацияразделы 1, 2, 4, 8, 12: 142 тыс.+ PR агентов, 27,67 % с конфликтами слияния
S50Why Do Multi-Agent LLM Systems Fail?Cemri, Pan, Yang и др. (UC Berkeley)arxiv.org/abs/2503.136572025-03-172026-09-27аннотацияразделы 1, 2, 4, 10, 12: 1600+ трасс, 7 фреймворков, 14 видов отказов в 3 категориях
S51Where Do AI Coding Agents Fail? An Empirical Study of Failed Agentic Pull Requests in GitHubEhsani и др.arxiv.org/html/2601.151952026-01-212026-09-27полный текстразделы 1–5, 8, 11, 12: 33 596 PR, 71,48 % слиты, неслитые крупнее, 38 % отклонённых брошены, 23 % дубликаты
S52On the Use of Agentic Coding: An Empirical Study of Pull Requests on GitHubWatanabe и др.arxiv.org/abs/2509.147452025-09-182026-09-27аннотацияразделы 1, 2, 8, 12: 567 PR Claude Code, 83,8 % слиты, 54,9 % без правок
S53How we built our multi-agent research systemAnthropic Engineeringanthropic.com/engineering/multi-agent-research-system2025-06-132026-09-27полный текстразделы 1, 2, 4, 10, 11, 12: агенты ~4x, мультиагентные ~15x токенов чата; кодинг хуже параллелится; требования к делегированию
S54AI Copilot Code Quality: 2025 Data Suggests 4x Growth in Code ClonesGitCleargitclear.com/ai_assistant_code_quality_2025_research2026-012026-09-27полный текстразделы 1–5, 8: 211 млн строк 2020–2024, доля перемещённого кода 25 % → <10 %, копипаста 8,3 % → 12,3 %, корреляция
S55Test-Driven Development for Code GenerationMathews, Nagappanarxiv.org/abs/2402.135212024-02-212026-09-27аннотацияразделы 1, 2: тесты в промпте повышают долю решённых задач (MBPP, HumanEval)
S56Announcing the 2025 DORA ReportGoogle Cloudcloud.google.com/blog/products/ai-machine-learning/announ…2025-09-242026-09-27полный текстразделы 2, 11, 12: ~5000 респондентов, 90 % используют ИИ, 30 % не доверяют, связь со стабильностью
S57We are Changing our Developer Productivity Experiment DesignMETRmetr.org/blog/2026-02-24-uplift-update/2026-02-242026-09-27полный текстразделы 2, 11, 12: 57 разработчиков, 800+ задач, эффекты отбора, оценки −18 % и −4 %
S58Run agents in parallelAnthropiccode.claude.com/docs/en/agentsбез даты2026-09-27полный текстразделы 2, 3, 4, 9, 10, 11: субагенты, agent view, agent teams, workflows, /batch на 5–30 субагентов, умножение расхода
S59Cloud agents (Cursor docs)Cursor (Anysphere)cursor.com/docs/cloud-agentбез даты2026-09-27полный текстразделы 2, 4, 9, 10: изолированные ВМ, environment.json, оплата по тарифам API
S60About GitHub Copilot coding agentGitHub Docsdocs.github.com/en/copilot/concepts/agents/coding-agent/a…без даты2026-09-27полный текстразделы 2, 4, 9, 10: среда GitHub Actions, один репозиторий, один PR на задачу, лимит 59 минут
S61Jules docsGooglejules.google/docsбез даты2026-09-27фрагментразделы 2, 9: асинхронный агент в облачной ВМ, утверждение плана
S62When to use DevinCognitiondocs.devin.ai/essential-guidelines/when-to-use-devinбез даты2026-09-27полный текстразделы 2, 4, 9: задачи до ~3 часов, явные критерии успеха, параллельные сессии
S63Specs (Kiro docs)Kiro (AWS)kiro.dev/docs/specs/без даты2026-09-27полный текстразделы 2, 4, 9: requirements/design/tasks, параллельные волны независимых задач
S64How much does AI impact development speed? An enterprise-based randomized controlled trialParadis и др. (Google)arxiv.org/abs/2410.129442024-10-162026-09-27аннотацияразделы 2, 12: РКИ, 96 инженеров, ~21 % быстрее, широкий доверительный интервал
S65The Effects of Generative AI on High-Skilled Work: Evidence from Three Field Experiments with Software DevelopersCui, Demirer, Jaffe, Musolff, Peng, Salz (Microsoft Research)microsoft.com/en-us/research/publication/the-effects-of-g…2025-062026-09-27аннотацияразделы 2, 12: 4867 разработчиков, +26,08 % задач (SE 10,3 %), больший эффект у младших
S66Stanford University Study Reveals Real Impact of AI on Developer Productivity (пересказ доклада Y. Denisov-Blanch)Marvin Zhangmarvinzhang.dev/blog/ai-productivity2025-08-052026-09-27полный текстразделы 2, 3, 12: ~100 тыс. разработчиков, выигрыш 30–40 % в простых новых задачах и 0–10 % в сложных в существующем коде; падение с ростом кодовой базы
S67Harness engineering: leveraging Codex in an agent-first world (оригинал)Ryan Lopopolo, OpenAIopenai.com/index/harness-engineering/2026-02-112026-09-27недоступенразделы 2, 12: оригинал вернул 403; содержание взято из конспектов S44, S45
S68CloudBees Smart TestsCloudBeescloudbees.com/capabilities/cloudbees-smart-testsбез даты2026-09-27полный текстразделы 2, 4, 12: «до 80 %» сокращения времени тестов (вендор), бывший Launchable
S69Task-Completion Time Horizons of Frontier AI ModelsMETRmetr.org/time-horizons/2026-05-082026-09-27полный текстразделы 2, 11: определение 50 %-горизонта, оговорки о чётко заданных задачах
S70What is the Max plan?Anthropic Help Centersupport.claude.com/en/articles/11049741-what-is-the-max-planбез даты2026-09-27полный текстразделы 2, 4, 9, 10, 11: окно 5 часов, недельный лимит на все модели, 5x и 20x
S71Codex Pricing (plans and limits)OpenAIlearn.chatgpt.com/docs/pricingбез даты2026-09-27полный текстразделы 2, 4, 5, 9, 10: сообщения за 5 часов по моделям, общий лимит локально и в облаке, Plus $20, Pro от $100, Business $20–25, советы по экономии
S72A Packwerk RetrospectiveShopify Engineeringshopify.engineering/a-packwerk-retrospective2024-02-072026-09-27полный текстразделы 2–5, 7, 8, 11: отказ от проверок приватности, семантическая группировка против фактического исполнения, удержание базового слоя
S73MonolithFirstMartin Fowlermartinfowler.com/bliki/MonolithFirst.html2015-06-032026-09-27полный текстразделы 2, 3, 4, 11: успешные микросервисы начинались с монолита, риск неверных границ
S74MicroservicePremiumMartin Fowlermartinfowler.com/bliki/MicroservicePremium.html2015-05-132026-09-27полный текстразделы 2, 4, 7, 11: цена распределённости, большинству систем — модульный монолит
S75Understanding Spec-Driven-Development: Kiro, spec-kit, and TesslBirgitta Böckeler, martinfowler.commartinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html2025-10-152026-09-27полный текстразделы 2, 4, 7, 8, 11, 12: уровни SDD, избыточность для мелких задач, агенты не всегда следуют спецификации
S76Spec KitGitHubgithub.com/github/spec-kitбез даты2026-09-27полный текстразделы 2, 4, 9, 10, 11: команды constitution/specify/plan/tasks/implement, маркер [P]
S77AsyncAPI ConceptsAsyncAPI Initiativeasyncapi.com/docs/conceptsбез даты2026-09-27фрагментразделы 3, 4, 5, 9: каналы, сообщения, производители и потребители событий
S78Effective context engineering for AI agentsAnthropic Engineeringanthropic.com/engineering/effective-context-engineering-f…2025-09-292026-09-27полный текстразделы 3, 4, 10, 11: context rot, контекст «точно в срок», компактизация, заметки, сводки субагентов 1–2 тыс. токенов
S79Enforce Module BoundariesNxnx.dev/docs/features/enforce-module-boundariesбез даты2026-09-27полный текстразделы 3, 4, 5, 6, 9: теги scope/type, depConstraints, правило линтера
S80Prism OverviewStoplightdocs.stoplight.io/docs/prism/674b27b261c3c-prism-overviewбез даты2026-09-27фрагментразделы 3, 4, 5, 6, 9: мок-сервер из OpenAPI, прокси-валидация
S81Documenting Architecture DecisionsMichael Nygard, Cognitectcognitect.com/blog/2011/11/15/documenting-architecture-de…2011-11-152026-09-27полный текстразделы 4, 5, 6, 7, 11: ADR, статусы, superseded
S82MicroservicesJames Lewis, Martin Fowlermartinfowler.com/articles/microservices.html2014-03-252026-09-27полный текстразделы 4, 11: девять характеристик микросервисов, связь с законом Конвея
S83Micro FrontendsCam Jackson, martinfowler.commartinfowler.com/articles/micro-frontends.html2019-06-192026-09-27полный текстраздел 4: выгоды и цена микрофронтендов
S84Testcontainers: Getting StartedTestcontainers (Docker)testcontainers.com/getting-started/без даты2026-09-27полный текстразделы 4, 7, 9: одноразовые контейнеры, случайные порты, параллельные прогоны
S85Predictive Test Selection (CloudBees Smart Tests docs)CloudBeesdocs.cloudbees.com/docs/cloudbees-smart-tests/latest/feat…без даты2026-09-27полный текстразделы 4, 9: выбор тестов по связи изменённых файлов и тестов, нужна история прогонов
S86ApprovalTestsApprovalTestsapprovaltests.com/без даты2026-09-27полный текстразделы 4, 5, 9: эталонные тесты received/approved, применимость к унаследованному коду
S87Flaky Tests at Google and How We Mitigate ThemGoogle Testing Blogtesting.googleblog.com/2016/05/flaky-tests-at-google-and-…2016-05-272026-09-27фрагментразделы 4, 12: карантин и повторные запуски нестабильных тестов (тело поста не загрузилось)
S88Stacked diffsGraphitegraphite.com/guides/stacked-diffsбез даты2026-09-27полный текстразделы 4, 9: стекированные изменения, работа без ожидания ревью
S89Prompt cachingAnthropic (Claude Platform docs)platform.claude.com/docs/en/build-with-claude/prompt-cachingбез даты2026-09-27полный текстразделы 4, 7: множители записи и чтения кеша, порядок tools → system → messages, что инвалидирует кеш
S90Design by contractWikipediaen.wikipedia.org/wiki/Design_by_contractбез даты2026-09-27полный текстразделы 5, 11: предусловия, постусловия, инварианты (Meyer, 1986)
S91Plans & PricingAnthropicclaude.com/pricingбез даты2026-09-27полный текстразделы 5, 9: Pro $20, Max 5x $100, Team $25/$125 за место, Claude Code во всех платных планах
S92Team Topologies: Key ConceptsTeam Topologiesteamtopologies.com/key-conceptsбез даты2026-09-27полный текстразделы 7, 11, 12: типы команд, режимы взаимодействия, когнитивная нагрузка
S93DORA AI Capabilities Model (обзор в поиске и страница отчёта)DORA, Google Clouddora.dev/ai/capabilities-model/report/2025-092026-09-27фрагментразделы 7, 12: семь способностей, включая работу малыми партиями и контроль версий
S94Jules, Google's asynchronous AI coding agent, is out of public betaGoogleblog.google/technology/google-labs/jules-now-available/2025-08-062026-09-27полный текстразделы 9, 12: тарифы с лимитами 5x и 20x
S95Usage limit best practicesAnthropic Help Centersupport.claude.com/en/articles/9797557-usage-limit-best-p…без даты2026-09-27полный текстразделы 10, 12: факторы расхода лимита
S96Information hidingWikipediaen.wikipedia.org/wiki/Information_hidingбез даты2026-09-27полный текстраздел 11: выходные данные статьи Парнаса (CACM 15(12), 1972)

Словарь терминов

ADR, Architecture Decision Record запись архитектурного решения
короткий документ с контекстом, решением, статусом и последствиями; здесь — форма изменения контракта с версией.
Affected затронутые проекты
множество проектов монорепозитория, изменённых в PR, и зависящих от них; основа выбора тестов в Nx.
Agent ИИ-агент
модель, которая сама читает файлы, запускает команды и правит код в цикле до достижения цели.
Agent teams команды агентов
экспериментальный режим Claude Code, где ведущая сессия раздаёт задачи участникам с общим списком задач и обменом сообщениями.
AGENTS.md файл правил для агентов
открытый формат файла с инструкциями для агентов; во вложенных папках действует ближайший к файлу.
Amdahl's law закон Амдала
ускорение от параллелизма ограничено долей последовательной работы; здесь последовательная часть — приёмка и интеграция.
Approval test, golden master эталонный тест
тест, сравнивающий полученный результат с ранее одобренным файлом.
AsyncAPI спецификация асинхронных API
формат описания каналов, сообщений, производителей и потребителей событий.
Bazel система сборки
сборка и тесты с герметичными действиями, кешем и графом зависимостей.
BFF, Backend for Frontend сервер для конкретного фронтенда
прослойка API, обслуживающая один интерфейс.
Bounded Context ограниченный контекст
часть предметной области со своей моделью и языком; базовая единица нарезки в DDD.
Churn отток кода
доля недавно написанных строк, которые удаляются или переписываются.
CI, Continuous Integration непрерывная интеграция
автоматическая сборка и проверка каждого изменения.
CLAUDE.md файл правил Claude Code
инструкции, которые Claude Code загружает в начале каждой сессии.
Cognitive load когнитивная нагрузка
объём знаний, который команда должна держать в голове; в Team Topologies — ограничение размера зоны ответственности.
Compaction компактизация
сжатие истории разговора в сводку при приближении к пределу контекста.
Consumer-driven contract, CDC контракт, задаваемый потребителем
контракт, составленный из ожиданий потребителей и проверяемый в CI поставщика.
Context engineering инженерия контекста
отбор минимального набора токенов, нужного агенту для задачи.
Context rot гниение контекста
падение точности модели по мере роста длины входа.
Context window окно контекста
максимальный объём текста, который модель обрабатывает за один запрос.
Contract-first контракт-первым
порядок работы, при котором схема интерфейса утверждается до реализации обеих сторон.
CRUD создание, чтение, изменение, удаление
приложение или зона, почти целиком состоящие из операций над записями без сложной логики.
Dead letter очередь недоставленных сообщений
место, куда брокер откладывает сообщение после исчерпания повторов обработки.
DI, dependency injection внедрение зависимостей
передача объектов-зависимостей извне; общий DI-контейнер — типичный горячий файл.
Conway's law закон Конвея
системы повторяют структуру коммуникаций создающих их организаций.
DDD, Domain-Driven Design предметно-ориентированное проектирование
подход к моделированию сложных доменов через язык и ограниченные контексты.
Deep module глубокий модуль
модуль с простым интерфейсом и содержательной реализацией.
Design by Contract проектирование по контракту
описание обязательств через предусловия, постусловия и инварианты.
DORA исследовательская программа DevOps Research and Assessment
ежегодные исследования практик поставки ПО, с 2025 года — влияния ИИ.
Effort уровень рассуждения
настройка объёма рассуждения модели перед ответом; влияет на расход токенов.
Expand/contract, Parallel Change расширение и сжатие
проведение несовместимого изменения через период поддержки обеих версий.
Feature flag, feature toggle флаг функции
переключатель, позволяющий сливать и выкатывать скрытый код.
Flaky test нестабильный тест
тест, который падает и проходит без изменения кода.
Fork форк субагента
субагент, наследующий всю историю родительской сессии.
Harness engineering инженерия обвязки
термин OpenAI для построения среды, линтеров, документации и проверок, в которых агенты пишут код.
Headless mode запуск без интерфейса
неинтерактивный запуск агента из скриптов и CI (claude -p).
Hermeticity герметичность
свойство сборки давать одинаковый результат при одинаковых входах независимо от машины.
Hexagonal architecture, ports and adapters порты и адаптеры
ядро приложения общается с миром через порты, к которым подключаются сменные адаптеры.
Hook хук
скрипт, который инструмент агента запускает в определённой точке цикла; в отличие от инструкций выполняется всегда.
Hot file горячий файл
общий файл, который правят почти все задачи (реестр маршрутов, настройки, DI).
Idempotency идемпотентность
повторная обработка того же сообщения не меняет результат.
import-linter, tach линтеры импортов Python
инструменты, проверяющие разрешённые зависимости между модулями.
Information hiding сокрытие информации
принцип Парнаса прятать в модуле решение, которое вероятно изменится.
Inverse Conway maneuver обратный манёвр Конвея
настройка структуры команд или агентов под желаемую архитектуру.
Lock file файл фиксации версий зависимостей
файл пакетного менеджера с точными версиями; его изменение затрагивает все зоны.
L0–L3 уровни прогона
авторская схема уровней проверки — в сессии, на PR, после слияния, ночной и перед релизом.
MCP, Model Context Protocol протокол контекста модели
стандарт подключения внешних инструментов к агенту.
Merge conflict конфликт слияния
несовместимые правки одних файлов в разных ветках.
Merge queue очередь слияния
последовательное слияние PR с проверкой каждого на актуальной основной ветке.
Microfrontends микрофронтенды
независимо поставляемые части интерфейса, собираемые в целое.
Microservices микросервисы
независимо развёртываемые сервисы со своими данными.
Modular monolith модульный монолит
одно развёртывание с жёстко разделёнными модулями и контролем зависимостей.
Monorepo монорепозиторий
один репозиторий для многих проектов с общим графом зависимостей.
Nx инструмент монорепозиториев
граф проектов, запуск затронутых задач, кеш, правила границ.
OpenAPI спецификация HTTP API
машиночитаемое описание эндпоинтов, запросов и ответов.
Outbox исходящий журнал событий
таблица, в которую событие пишется в той же транзакции, что и данные, а затем публикуется.
Pact инструмент контрактных тестов
реализация контрактов, задаваемых потребителем.
Plan mode режим плана
режим Claude Code, в котором агент исследует и планирует без изменений файлов.
PR, pull request запрос на слияние
единица изменения, проходящая ревью и проверки.
Predictive test selection предиктивный выбор тестов
выбор тестов по модели вероятности падения, обученной на истории.
Prompt caching кеширование промптов
повторное использование обработанного префикса запроса по сниженной цене.
protobuf Protocol Buffers
двоичный формат и язык схем сообщений.
QA, quality assurance обеспечение качества
проверка продукта, в том числе ручная приёмка человеком.
RCT, РКИ рандомизированное контролируемое исследование
эксперимент со случайным распределением участников по условиям.
Scenario API сценарный API тестов Spring Modulith
средство теста «опубликовать событие или вызвать операцию → дождаться ожидаемого события или состояния».
SE, standard error стандартная ошибка
мера точности оценки эффекта в исследовании.
Repo map карта репозитория
сжатое описание файлов и ключевых символов репозитория для контекста модели.
SDD, spec-driven development разработка от спецификаций
процесс, в котором требования, план и задачи пишутся до кода и управляют агентом.
Skill навык агента
файл с инструкциями или процедурой, загружаемый по требованию.
Stacked diffs стекированные изменения
цепочка малых зависимых PR, ревьюемых по отдельности.
Stop hook хук остановки
хук, который не даёт агенту завершить ход, пока проверка не пройдёт.
Subagent субагент
вспомогательный агент в отдельном окне контекста, возвращающий сводку.
Team Topologies топологии команд
модель четырёх типов команд и трёх режимов взаимодействия.
Tenant, multi-tenancy арендатор, многоарендность
изоляция данных и настроек разных клиентов в одной системе.
Testcontainers библиотека тестовых контейнеров
запуск реальных зависимостей в одноразовых контейнерах со случайными портами.
Test pyramid, testing trophy, testing honeycomb пирамида, трофей, соты
модели пропорций уровней тестов.
Time horizon горизонт задач METR
длительность задачи (по времени эксперта), которую агент решает с заданной вероятностью.
Tolerant Reader терпимый читатель
потребитель, который берёт нужные поля и игнорирует незнакомые.
Trunk-based development магистральная разработка
частые слияния малых изменений в одну основную ветку.
TTL, time to live время жизни
срок хранения записи в кеше.
Vertical slice вертикальный срез
фича, собранная в одном месте от входа до хранения.
WIP limit ограничение незавершённой работы
предел числа одновременно открытых задач.
Writer/Reviewer писатель и ревьюер
схема из двух сессий агента, где одна пишет код, а другая со свежим контекстом его проверяет.
Worktree рабочая копия git
отдельная папка с собственной веткой, использующая общий репозиторий.
Зона авторский термин
часть системы с одним владельцем, публичным API, своими данными и тестами; единица параллельной работы агента.
Паспорт зоны авторский термин
короткий файл в папке зоны с назначением, запретами, API, командами проверки и ловушками.
Сквозная трасса термин подхода пользователя
критический сценарий, проходящий через несколько зон и закреплённый тестом.