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. Главные споры
- Ускоряет ли ИИ опытных разработчиков в знакомом большом коде. РКИ METR показало замедление эмпирика [S7], РКИ Google и Microsoft — ускорение эмпирика [S64, S65]; различаются задачи (своя сложная кодовая база против изолированной задачи) и инструменты.
- Один агент с хорошим контекстом или много агентов. Anthropic использует мультиагентность для исследований и оговаривает её слабость в кодинге вендор [S53], Cognition против мнение [S48], документация Claude Code советует команды агентов для исследования, ревью и независимых модулей вендор [S10].
- Ревью человеком или агентом. В кейсе OpenAI ревью сдвинуто к агент-агент вендор [S45]; Faros фиксирует рост PR без ревью вместе с ростом инцидентов эмпирика [S2].
- Спецификация как источник истины или код. 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 с удалённым кешем
- Если стек TypeScript-монорепозиторий→зоны + правило границ Nx +
- Если зоны общаются по 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 гипотеза. Каждый шаг заканчивается проверяемым артефактом.
- Выписать изменчивые решения и подобласти. Список решений, которые вероятно изменятся (платёжный провайдер, тарифная модель, каналы уведомлений, правила доступа, формат отчётов), и подобластей со своим языком. Критерий Парнаса — начинать с трудных и вероятно меняющихся решений, а не с блок-схемы обработки факт [S8]. Артефакт: список на одну страницу.
- Черновые зоны. Одна зона — одна подобласть или одно изменчивое решение; плюс ядро платформы (арендатор, пользователь, права, конфигурация, outbox событий) и пакет контрактов. Проверка зоны: у неё есть ответ «чего она не делает», она владеет своими таблицами, у неё 3–7 публичных операций или событий (ориентир, гипотеза). Артефакт: карта зон (раздел 6).
- Направления зависимостей. Граф ацикличен; ядро ни от кого не зависит; функциональные зоны зависят от ядра и контрактов; обратные потоки идут событиями. Артефакт: конфигурация линтера границ (раздел 6).
- Владение данными. Каждая таблица принадлежит одной зоне; чужие данные читаются через API или через проекцию, построенную по событиям; в многоарендной системе идентификатор арендатора входит в каждый контракт гипотеза.
- Контракты на каждом ребре графа. Шаблон контракта раздела 6: машиночитаемая схема плюс гарантии, запреты, ошибки, версия, тестовые обязательства.
- Инвентаризация горячих файлов. Корневые маршруты, список приложений, DI, таблица маршрутов фронтенда, переводы, миграции, lock-файл; каждый заменяется автообнаружением или файлом на зону (A11).
- Сквозные трассы. 5–10 критических сценариев, проходящих через границы; каждая трасса — тест уровня L1 (если проходит через изменённую границу) или L3.
- Проверка размеров. Код зоны плюс контракты соседей помещаются в небольшую долю окна агента (D3); у одного человека не больше 3–5 одновременно активных зон (ориентир, гипотеза).
- Механизация. Линтер границ в CI, выбор тестов по графу зон, заглушки по контрактам, генератор нового среза, паспорта зон, таблица «что изменилось → что перепроверить».
- Пилот. Две параллельные задачи в двух зонах; замер метрик раздела 8 до и после; коррекция границ, где задачи всё равно пересеклись по файлам.
5.2. Порядок внедрения в существующей системе
- Замерить базу: время CI, долю PR с конфликтами, время до первого ревью, размер PR, долю переделок, расход лимита на слитый PR (раздел 8).
- Построить фактический граф импорта инструментом (tach show, import-linter, граф Nx) и найти кластеры факт [S38, S20, S79].
- Объявить зоны по кластерам и изменчивым решениям; включить линтер в режиме «не хуже»: текущие нарушения заморожены, новые запрещены. Shopify так удержал базовый слой без нарушений и зависимостей вендор [S72].
- Паспорта зон и вложенные AGENTS.md в папках зон факт [S34].
- Эталонные тесты вокруг зон до рефакторинга агентом: approval-тесты предназначены в том числе для унаследованного кода факт [S86].
- Выбор тестов и уровни прогона: pytest-testmon или affected на графе, ночной полный прогон.
- Постепенный вынос горячих файлов и перевод синхронных вызовов на события там, где зоны связаны по времени.
- Параллелить агентов сначала на исследовании и ревью, затем на реализации в разных зонах; так рекомендует документация команд агентов 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) |
Где отстаёт и чего не хватает гипотеза:
- Машиночитаемость. Семь вопросов в прозе не проверяются CI; к каждому контракту нужна схема (OpenAPI, AsyncAPI, JSON Schema) и автоматическое сравнение версий, для которого есть готовые инструменты факт [S40, S41].
- Исполняемость. Нет контрактных тестов и заглушек, которые позволяют начинать ящики одновременно; оба вида инструментов существуют факт [S26, S80].
- Контроль границ в коде. «Чего ящик не делает» записано, но не запрещено линтером импорта, хотя такие линтеры есть факт [S20, S38].
- Правила совместимости. Не определено, что считается несовместимым изменением и как долго живёт старая версия; в практике для этого есть Tolerant Reader и expand → contract факт [S43, S42].
- Ошибки и отказ. Среди семи вопросов нет семантики ошибок, повторов, таймаутов, идемпотентности, порядка, объёмов.
- Арендатор и права. Для многоарендной системы — контекст арендатора и проверка прав на границе.
- Владение данными. Кому принадлежат таблицы и кто пишет миграции.
- Тестовые обязательства. Какие тесты есть у поставщика, у потребителя и какая трасса покрывает контракт.
- Контекст для агента. Паспорт ящика в папке кода (вложенный AGENTS.md) и размер ящика относительно окна.
- Параллельность детализации. «Детализация по одному» последовательна; при контрактах со схемами и заглушками ящики детализируются параллельно разными агентами.
- Гейт. Один гейт стоит заменить уровнями L0–L3 и указанием, кто принимает (тест, агент-ревьюер, человек).
- Таблица перепроверки. Из графа ящиков и контрактов выводится таблица «что изменилось → что перепроверить» (раздел 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. Правила контракта для параллельной разработки агентами
- Контракт сливается в основную ветку до начала реализации обеих сторон; без слитого контракта задачи реализации не выдаются.
- Источник истины — схема; проза не противоречит схеме, генерируемые типы не редактируются руками.
- Агент реализации не меняет контракт в том же PR; нужна правка — агент останавливается и описывает её в отчёте.
- По умолчанию только совместимые изменения; несовместимое — новая версия рядом со старой, запись решения, срок удаления старой факт [S42, S81].
- Потребитель читает терпимо: игнорирует незнакомые поля факт [S43].
- Из контракта генерируется заглушка; потребитель разрабатывается против неё, поставщик проверяется контрактными тестами факт [S80, S26].
- Контракт называет ошибки, повторы, идемпотентность, порядок и арендатора; без этих полей контракт не считается готовым.
- У каждого контракта есть трасса и тестовые обязательства обеих сторон.
- Изменение схемы автоматически запускает перепроверку по таблице 6.8.
- Общих изменяемых структур вне контрактов нет: ни общих таблиц, ни глобальных объектов состояния.
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 | Публикация | Доступ (дата) | Вид доступа | Что подтверждает |
|---|---|---|---|---|---|---|---|
| S1 | The AI Productivity Paradox Research Report | Faros AI | faros.ai/blog/ai-software-engineering | 2025-07-23 | 2026-09-27 | полный текст | разделы 0, 1, 2, 8: +21 % задач, +98 % PR, +91 % время ревью, +154 % размер PR, +9 % багов; корреляционный анализ 10 тыс.+ разработчиков |
| S2 | The AI Engineering Report 2026: The AI Acceleration Whiplash — Ten Takeaways | Faros AI | faros.ai/blog/ai-acceleration-whiplash-takeaways | 2026-04-12 | 2026-09-27 | полный текст | разделы 0, 1, 2, 4, 5, 7, 8, 10, 12: 22 тыс. разработчиков; +66 % эпиков, +54 % багов, медианное время ревью +441,5 %, +31,3 % PR без ревью, инциденты на PR +242,7 % |
| S3 | DORA Report 2024 – A Look at Throughput and Stability | Rachel Stephens, RedMonk | redmonk.com/rstephens/2024/11/26/dora2024/ | 2024-11-26 | 2026-09-27 | полный текст | разделы 0, 2: +25 % внедрения ИИ связано с −1,5 % пропускной способности и −7,2 % стабильности |
| S4 | AI Agent Pull Requests on GitHub: Frequency, Structure, and Merge Conflict Rates | Xu, Subramanian, Karthik | arxiv.org/html/2607.04697v2 | 2026-07 | 2026-09-27 | полный текст | разделы 0, 1, 2, 3, 4, 8, 12: конфликты 19,8 % у однотипных агентов и 41,7 % у разных, ~42 % структурные, lock-файлы 3,9 % конфликтных файлов |
| S5 | Best practices for Claude Code | Anthropic | code.claude.com/docs/en/best-practices | без даты | 2026-09-27 | полный текст | разделы 0, 1, 3–11: контекст как главный ресурс, проверка и доказательства, план, CLAUDE.md, субагенты, writer/reviewer, fan-out, хук Stop |
| S6 | Measuring the Self-Reported Impact of Early-2026 AI on Technical Worker Productivity | METR | metr.org/blog/2026-05-11-ai-usage-survey/ | 2026-05-11 | 2026-09-27 | полный текст | разделы 0, 1, 2: опрос 349 человек, самооценка 1,4–2x, переоценка влияния ИИ на 40 п. п. |
| S7 | Measuring the Impact of Early-2025 AI on Experienced Open-Source Developer Productivity | METR | metr.org/blog/2025-07-10-early-2025-ai-experienced-os-dev… | 2025-07-10 | 2026-09-27 | полный текст | разделы 1, 2, 11, 12: РКИ, 16 разработчиков, 246 задач, замедление 19 %, ожидания +24 % |
| S8 | On the criteria to be used in decomposing systems into modules (разбор The Morning Paper) | Adrian Colyer | blog.acolyer.org/2016/09/05/on-the-criteria-to-be-used-in… | 2016-09-05 | 2026-09-27 | полный текст | разделы 1, 2, 4, 5, 11, 12: цитаты Парнаса о выгоде модульности и критерии декомпозиции |
| S9 | Modules Should Be Deep! | Marco Tulio Valente, Software Engineering: A Modern Approach | softengbook.org/articles/deep-modules | без даты | 2026-09-27 | полный текст | разделы 1, 11, 12: глубокие модули Остерхаута, пример файлового ввода-вывода Unix |
| S10 | Orchestrate teams of Claude Code sessions | Anthropic | code.claude.com/docs/en/agent-teams | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 5, 7, 9, 10, 12: 3–5 участников, 5–6 задач на участника, владение разными файлами, нет изоляции worktree |
| S11 | Run only tasks affected by a PR (Nx affected) | Nx | nx.dev/docs/features/ci-features/affected | без даты | 2026-09-27 | полный текст | разделы 1, 3, 4, 6, 7, 8, 9: граф проектов, affected, удалённый кеш, lock-файл делает затронутым всё |
| S12 | Hermeticity | Bazel | bazel.build/basics/hermeticity | без даты | 2026-09-27 | полный текст | разделы 1, 3, 4, 7, 9: герметичность, кеш действий и тестов, источники негерметичности |
| S13 | Context Rot: How Increasing Input Tokens Impacts LLM Performance | Hong, Troynikov, Huber (Chroma) | trychroma.com/research/context-rot | 2025-07-14 | 2026-09-27 | полный текст | разделы 1, 2, 4: 18 моделей, деградация с ростом длины входа, отвлекающие фрагменты |
| S14 | How Do Committees Invent? | Melvin E. Conway | melconway.com/Home/Committees_Paper.html | 1968-04 | 2026-09-27 | полный текст | разделы 1, 11: формулировка закона Конвея |
| S15 | Conway's Law Comes for Your Agent Fleet | Tian Pan | tianpan.co/blog/2026/06/30/conways-law-comes-for-your-age… | 2026-06-30 | 2026-09-27 | полный текст | разделы 1, 4, 10: закон Конвея для агентов, оркестратор с изолированными исполнителями (мнение) |
| S16 | Team Topologies | Martin Fowler | martinfowler.com/bliki/TeamTopologies.html | 2023-07-25 | 2026-09-27 | полный текст | разделы 1, 7, 11, 12: когнитивная нагрузка, платформенные команды, связь с законом Конвея |
| S17 | BoundedContext | Martin Fowler | martinfowler.com/bliki/BoundedContext.html | 2014-01-15 | 2026-09-27 | полный текст | разделы 1, 3, 4, 5, 11, 12: ограниченный контекст, карта контекстов |
| S18 | Deconstructing the Monolith: Designing Software that Maximizes Developer Productivity | Shopify Engineering | shopify.engineering/shopify-monolith | 2020-09-16 | 2026-09-27 | полный текст | разделы 1–4, 7, 9, 11: 2,8 млн строк, 37 компонентов, Packwerk, выделение сервисов только по особым причинам |
| S19 | Spring Modulith: Fundamentals | Spring (VMware/Broadcom) | docs.spring.io/spring-modulith/reference/fundamentals.html | без даты | 2026-09-27 | полный текст | разделы 1, 4, 9: модули-пакеты, API и internal, verify, allowedDependencies |
| S20 | Import Linter: Contract types | Import 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 |
| S21 | Hexagonal Architecture | Alistair Cockburn | alistair.cockburn.us/hexagonal-architecture/ | 2005-09-04 | 2026-09-27 | полный текст | разделы 1, 3, 4, 11: порты и адаптеры, запуск без UI и БД для тестов |
| S22 | Vertical Slice Architecture | Jimmy Bogard | jimmybogard.com/vertical-slice-architecture/ | 2018-04-19 | 2026-09-27 | полный текст | разделы 1, 4, 11: минимум связности между срезами, максимум внутри |
| S23 | The Practical Test Pyramid | Ham Vocke, martinfowler.com | martinfowler.com/articles/practical-test-pyramid.html | 2018-02-26 | 2026-09-27 | полный текст | разделы 1, 4, 5, 11: пирамида, CDC-тесты, минимум сквозных тестов |
| S24 | Testing of Microservices (Testing Honeycomb) | Spotify Engineering | engineering.atspotify.com/2018/01/testing-of-microservices | 2018-01-11 | 2026-09-27 | полный текст | разделы 1, 4, 11: интеграционные тесты сервиса в изоляции, отказ от integrated-тестов |
| S25 | The Testing Trophy and Testing Classifications | Kent C. Dodds | kentcdodds.com/blog/the-testing-trophy-and-testing-classi… | 2021-06-03 | 2026-09-27 | полный текст | разделы 1, 4: статика, unit, integration, e2e; «mostly integration» |
| S26 | Pact Docs: Introduction | Pact Foundation | docs.pact.io/ | без даты | 2026-09-27 | полный текст | разделы 1, 4, 5, 6, 7, 9: контракты, задаваемые потребителем, проверка поставщика, ограниченность проверки по схеме |
| S27 | Predictive Test Selection | Meta Engineering | engineering.fb.com/2018/11/21/developer-tools/predictive-… | 2018-11-21 | 2026-09-27 | полный текст | разделы 1, 2, 4, 8, 9, 11: >99,9 % регрессий при ~⅓ тестов, избыточность выбора по зависимостям |
| S28 | pytest-testmon | testmon.org | testmon.org/ | без даты | 2026-09-27 | полный текст | разделы 1, 3, 4, 7, 9: выбор тестов по покрытию, что не отслеживается |
| S29 | Run parallel sessions with worktrees | Anthropic | code.claude.com/docs/en/worktrees | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 7, 9, 10: --worktree, .worktreeinclude, что общее с основной копией, версии поведения |
| S30 | Codex cloud | OpenAI | learn.chatgpt.com/docs/cloud | без даты | 2026-09-27 | фрагмент | разделы 1, 2, 4, 9, 10, 11: изолированные облачные окружения, параллельные задачи, PR, интеграции |
| S31 | Trunk-based development (DORA capability) | DORA | dora.dev/capabilities/trunk-based-development/ | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 7, 8, 11: ≤3 активных ветки, слияние минимум раз в день, тяжёлое ревью как ловушка |
| S32 | Working in small batches (DORA capability) | DORA | dora.dev/capabilities/working-in-small-batches/ | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 8, 11: малые партии как противовес нестабильности от ИИ, задачи на часы–пару дней |
| S33 | Feature Toggles (aka Feature Flags) | Pete Hodgson, martinfowler.com | martinfowler.com/articles/feature-toggles.html | 2017-10-09 | 2026-09-27 | полный текст | разделы 1, 4, 6, 7: виды флагов, стоимость владения, тестирование комбинаций |
| S34 | AGENTS.md | Agentic AI Foundation (Linux Foundation) | agents.md/ | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 5, 6, 9, 10, 11: формат, вложенные файлы, 60 тыс.+ проектов |
| S35 | Repository map | Aider | aider.chat/docs/repomap.html | без даты | 2026-09-27 | полный текст | разделы 1, 4, 9, 10: карта репозитория, ранжирование по графу ссылок, бюджет 1000 токенов |
| S36 | Subagents (Claude Code docs) | Anthropic | code.claude.com/docs/en/sub-agents | без даты | 2026-09-27 | полный текст | разделы 1, 4, 9, 10: собственное окно контекста, модель на субагента, isolation: worktree, общие лимиты, форки |
| S37 | Manage costs effectively (Claude Code) | Anthropic | code.claude.com/docs/en/costs | без даты | 2026-09-27 | полный текст | разделы 1–5, 8–10: $13 в активный день, команды агентов ~7x токенов, хуки-фильтры, CLAUDE.md до ~200 строк, кеш 1 ч на подписке, механика расхода |
| S38 | tach: enforce dependencies using modular architecture | tach-org (GitHub) | github.com/tach-org/tach | без даты | 2026-09-27 | полный текст | разделы 1, 4, 5, 9, 10: зависимости модулей, публичные интерфейсы, tach check |
| S39 | Spring Modulith: Integration Testing Application Modules | Spring (VMware/Broadcom) | docs.spring.io/spring-modulith/reference/testing.html | без даты | 2026-09-27 | полный текст | разделы 1, 3, 4, 5, 9: @ApplicationModuleTest, Scenario API, запуск тестов только изменённых модулей |
| S40 | Breaking change detection (buf breaking) | Buf | buf.build/docs/breaking/ | без даты | 2026-09-27 | полный текст | разделы 1, 4, 5, 9: категории FILE, PACKAGE, WIRE_JSON, WIRE; проверка в CI |
| S41 | oasdiff | oasdiff (GitHub) | github.com/oasdiff/oasdiff | без даты | 2026-09-27 | полный текст | разделы 1, 4, 5, 7, 9, 10: поиск несовместимых изменений OpenAPI, GitHub Action |
| S42 | ParallelChange | Danilo Sato, martinfowler.com | martinfowler.com/bliki/ParallelChange.html | 2014-05-13 | 2026-09-27 | полный текст | разделы 1, 3, 4, 5, 6: expand → migrate → contract для несовместимых изменений |
| S43 | Consumer-Driven Contracts: A Service Evolution Pattern | Ian Robinson, martinfowler.com | martinfowler.com/articles/consumerDrivenContracts.html | 2006-06-12 | 2026-09-27 | полный текст | разделы 1, 4, 5, 6, 11: контракты поставщика, потребителя и задаваемые потребителем, Tolerant Reader |
| S44 | Harness engineering: leveraging Codex in an agent-first world (конспект) | AI Wiki, businessdatasolutions | businessdatasolutions.github.io/ai-wiki/sources/2026-02-1… | 2026-02-11 | 2026-09-27 | полный текст | разделы 1, 2, 4–6, 8, 10, 12: 7 инженеров, ~1 млн строк, ~1500 PR, 3,5 PR в день на инженера, слои, линтеры, AGENTS.md ~100 строк, уборка энтропии |
| S45 | OpenAI Harness Engineering (заметки) | xiaow.dev | xiaow.dev/claude_notes/2026-03-25---Article---OpenAI-Harn… | 2026-03-25 | 2026-09-27 | полный текст | разделы 1, 2, 12: «corrections are cheap, and waiting is expensive», узкое место сместилось в QA людей, ревью агент-агент |
| S46 | Systemic Flakiness: An Empirical Analysis of Co-Occurring Flaky Test Failures | Parry, Kapfhammer, Hilton, McMinn | arxiv.org/html/2504.16777 | 2025-04 | 2026-09-27 | полный текст | разделы 1, 2, 4, 8, 12: 75 % нестабильных тестов в кластерах, 1,28 % времени разработчиков на починку |
| S47 | Embracing the parallel coding agent lifestyle | Simon Willison | simonwillison.net/2025/Oct/5/parallel-coding-agents/ | 2025-10-05 | 2026-09-27 | полный текст | разделы 1, 2, 4, 8: типы задач для параллельных агентов, ревью как узкое место, отдельные клоны |
| S48 | Don't Build Multi-Agents | Walden Yan, Cognition | cognition.com/blog/dont-build-multi-agents | 2025-06-12 | 2026-09-27 | полный текст | разделы 1, 2, 4, 10, 11, 12: действия несут неявные решения, конфликт параллельных субагентов |
| S49 | AgenticFlict: A Large-Scale Dataset of Merge Conflicts in AI Coding Agent Pull Requests on GitHub | Ogenrwot, Businge | arxiv.org/abs/2604.03551 | 2026-04-04 | 2026-09-27 | аннотация | разделы 1, 2, 4, 8, 12: 142 тыс.+ PR агентов, 27,67 % с конфликтами слияния |
| S50 | Why Do Multi-Agent LLM Systems Fail? | Cemri, Pan, Yang и др. (UC Berkeley) | arxiv.org/abs/2503.13657 | 2025-03-17 | 2026-09-27 | аннотация | разделы 1, 2, 4, 10, 12: 1600+ трасс, 7 фреймворков, 14 видов отказов в 3 категориях |
| S51 | Where Do AI Coding Agents Fail? An Empirical Study of Failed Agentic Pull Requests in GitHub | Ehsani и др. | arxiv.org/html/2601.15195 | 2026-01-21 | 2026-09-27 | полный текст | разделы 1–5, 8, 11, 12: 33 596 PR, 71,48 % слиты, неслитые крупнее, 38 % отклонённых брошены, 23 % дубликаты |
| S52 | On the Use of Agentic Coding: An Empirical Study of Pull Requests on GitHub | Watanabe и др. | arxiv.org/abs/2509.14745 | 2025-09-18 | 2026-09-27 | аннотация | разделы 1, 2, 8, 12: 567 PR Claude Code, 83,8 % слиты, 54,9 % без правок |
| S53 | How we built our multi-agent research system | Anthropic Engineering | anthropic.com/engineering/multi-agent-research-system | 2025-06-13 | 2026-09-27 | полный текст | разделы 1, 2, 4, 10, 11, 12: агенты ~4x, мультиагентные ~15x токенов чата; кодинг хуже параллелится; требования к делегированию |
| S54 | AI Copilot Code Quality: 2025 Data Suggests 4x Growth in Code Clones | GitClear | gitclear.com/ai_assistant_code_quality_2025_research | 2026-01 | 2026-09-27 | полный текст | разделы 1–5, 8: 211 млн строк 2020–2024, доля перемещённого кода 25 % → <10 %, копипаста 8,3 % → 12,3 %, корреляция |
| S55 | Test-Driven Development for Code Generation | Mathews, Nagappan | arxiv.org/abs/2402.13521 | 2024-02-21 | 2026-09-27 | аннотация | разделы 1, 2: тесты в промпте повышают долю решённых задач (MBPP, HumanEval) |
| S56 | Announcing the 2025 DORA Report | Google Cloud | cloud.google.com/blog/products/ai-machine-learning/announ… | 2025-09-24 | 2026-09-27 | полный текст | разделы 2, 11, 12: ~5000 респондентов, 90 % используют ИИ, 30 % не доверяют, связь со стабильностью |
| S57 | We are Changing our Developer Productivity Experiment Design | METR | metr.org/blog/2026-02-24-uplift-update/ | 2026-02-24 | 2026-09-27 | полный текст | разделы 2, 11, 12: 57 разработчиков, 800+ задач, эффекты отбора, оценки −18 % и −4 % |
| S58 | Run agents in parallel | Anthropic | code.claude.com/docs/en/agents | без даты | 2026-09-27 | полный текст | разделы 2, 3, 4, 9, 10, 11: субагенты, agent view, agent teams, workflows, /batch на 5–30 субагентов, умножение расхода |
| S59 | Cloud agents (Cursor docs) | Cursor (Anysphere) | cursor.com/docs/cloud-agent | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9, 10: изолированные ВМ, environment.json, оплата по тарифам API |
| S60 | About GitHub Copilot coding agent | GitHub Docs | docs.github.com/en/copilot/concepts/agents/coding-agent/a… | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9, 10: среда GitHub Actions, один репозиторий, один PR на задачу, лимит 59 минут |
| S61 | Jules docs | jules.google/docs | без даты | 2026-09-27 | фрагмент | разделы 2, 9: асинхронный агент в облачной ВМ, утверждение плана | |
| S62 | When to use Devin | Cognition | docs.devin.ai/essential-guidelines/when-to-use-devin | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9: задачи до ~3 часов, явные критерии успеха, параллельные сессии |
| S63 | Specs (Kiro docs) | Kiro (AWS) | kiro.dev/docs/specs/ | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9: requirements/design/tasks, параллельные волны независимых задач |
| S64 | How much does AI impact development speed? An enterprise-based randomized controlled trial | Paradis и др. (Google) | arxiv.org/abs/2410.12944 | 2024-10-16 | 2026-09-27 | аннотация | разделы 2, 12: РКИ, 96 инженеров, ~21 % быстрее, широкий доверительный интервал |
| S65 | The Effects of Generative AI on High-Skilled Work: Evidence from Three Field Experiments with Software Developers | Cui, Demirer, Jaffe, Musolff, Peng, Salz (Microsoft Research) | microsoft.com/en-us/research/publication/the-effects-of-g… | 2025-06 | 2026-09-27 | аннотация | разделы 2, 12: 4867 разработчиков, +26,08 % задач (SE 10,3 %), больший эффект у младших |
| S66 | Stanford University Study Reveals Real Impact of AI on Developer Productivity (пересказ доклада Y. Denisov-Blanch) | Marvin Zhang | marvinzhang.dev/blog/ai-productivity | 2025-08-05 | 2026-09-27 | полный текст | разделы 2, 3, 12: ~100 тыс. разработчиков, выигрыш 30–40 % в простых новых задачах и 0–10 % в сложных в существующем коде; падение с ростом кодовой базы |
| S67 | Harness engineering: leveraging Codex in an agent-first world (оригинал) | Ryan Lopopolo, OpenAI | openai.com/index/harness-engineering/ | 2026-02-11 | 2026-09-27 | недоступен | разделы 2, 12: оригинал вернул 403; содержание взято из конспектов S44, S45 |
| S68 | CloudBees Smart Tests | CloudBees | cloudbees.com/capabilities/cloudbees-smart-tests | без даты | 2026-09-27 | полный текст | разделы 2, 4, 12: «до 80 %» сокращения времени тестов (вендор), бывший Launchable |
| S69 | Task-Completion Time Horizons of Frontier AI Models | METR | metr.org/time-horizons/ | 2026-05-08 | 2026-09-27 | полный текст | разделы 2, 11: определение 50 %-горизонта, оговорки о чётко заданных задачах |
| S70 | What is the Max plan? | Anthropic Help Center | support.claude.com/en/articles/11049741-what-is-the-max-plan | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9, 10, 11: окно 5 часов, недельный лимит на все модели, 5x и 20x |
| S71 | Codex Pricing (plans and limits) | OpenAI | learn.chatgpt.com/docs/pricing | без даты | 2026-09-27 | полный текст | разделы 2, 4, 5, 9, 10: сообщения за 5 часов по моделям, общий лимит локально и в облаке, Plus $20, Pro от $100, Business $20–25, советы по экономии |
| S72 | A Packwerk Retrospective | Shopify Engineering | shopify.engineering/a-packwerk-retrospective | 2024-02-07 | 2026-09-27 | полный текст | разделы 2–5, 7, 8, 11: отказ от проверок приватности, семантическая группировка против фактического исполнения, удержание базового слоя |
| S73 | MonolithFirst | Martin Fowler | martinfowler.com/bliki/MonolithFirst.html | 2015-06-03 | 2026-09-27 | полный текст | разделы 2, 3, 4, 11: успешные микросервисы начинались с монолита, риск неверных границ |
| S74 | MicroservicePremium | Martin Fowler | martinfowler.com/bliki/MicroservicePremium.html | 2015-05-13 | 2026-09-27 | полный текст | разделы 2, 4, 7, 11: цена распределённости, большинству систем — модульный монолит |
| S75 | Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl | Birgitta Böckeler, martinfowler.com | martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html | 2025-10-15 | 2026-09-27 | полный текст | разделы 2, 4, 7, 8, 11, 12: уровни SDD, избыточность для мелких задач, агенты не всегда следуют спецификации |
| S76 | Spec Kit | GitHub | github.com/github/spec-kit | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9, 10, 11: команды constitution/specify/plan/tasks/implement, маркер [P] |
| S77 | AsyncAPI Concepts | AsyncAPI Initiative | asyncapi.com/docs/concepts | без даты | 2026-09-27 | фрагмент | разделы 3, 4, 5, 9: каналы, сообщения, производители и потребители событий |
| S78 | Effective context engineering for AI agents | Anthropic Engineering | anthropic.com/engineering/effective-context-engineering-f… | 2025-09-29 | 2026-09-27 | полный текст | разделы 3, 4, 10, 11: context rot, контекст «точно в срок», компактизация, заметки, сводки субагентов 1–2 тыс. токенов |
| S79 | Enforce Module Boundaries | Nx | nx.dev/docs/features/enforce-module-boundaries | без даты | 2026-09-27 | полный текст | разделы 3, 4, 5, 6, 9: теги scope/type, depConstraints, правило линтера |
| S80 | Prism Overview | Stoplight | docs.stoplight.io/docs/prism/674b27b261c3c-prism-overview | без даты | 2026-09-27 | фрагмент | разделы 3, 4, 5, 6, 9: мок-сервер из OpenAPI, прокси-валидация |
| S81 | Documenting Architecture Decisions | Michael Nygard, Cognitect | cognitect.com/blog/2011/11/15/documenting-architecture-de… | 2011-11-15 | 2026-09-27 | полный текст | разделы 4, 5, 6, 7, 11: ADR, статусы, superseded |
| S82 | Microservices | James Lewis, Martin Fowler | martinfowler.com/articles/microservices.html | 2014-03-25 | 2026-09-27 | полный текст | разделы 4, 11: девять характеристик микросервисов, связь с законом Конвея |
| S83 | Micro Frontends | Cam Jackson, martinfowler.com | martinfowler.com/articles/micro-frontends.html | 2019-06-19 | 2026-09-27 | полный текст | раздел 4: выгоды и цена микрофронтендов |
| S84 | Testcontainers: Getting Started | Testcontainers (Docker) | testcontainers.com/getting-started/ | без даты | 2026-09-27 | полный текст | разделы 4, 7, 9: одноразовые контейнеры, случайные порты, параллельные прогоны |
| S85 | Predictive Test Selection (CloudBees Smart Tests docs) | CloudBees | docs.cloudbees.com/docs/cloudbees-smart-tests/latest/feat… | без даты | 2026-09-27 | полный текст | разделы 4, 9: выбор тестов по связи изменённых файлов и тестов, нужна история прогонов |
| S86 | ApprovalTests | ApprovalTests | approvaltests.com/ | без даты | 2026-09-27 | полный текст | разделы 4, 5, 9: эталонные тесты received/approved, применимость к унаследованному коду |
| S87 | Flaky Tests at Google and How We Mitigate Them | Google Testing Blog | testing.googleblog.com/2016/05/flaky-tests-at-google-and-… | 2016-05-27 | 2026-09-27 | фрагмент | разделы 4, 12: карантин и повторные запуски нестабильных тестов (тело поста не загрузилось) |
| S88 | Stacked diffs | Graphite | graphite.com/guides/stacked-diffs | без даты | 2026-09-27 | полный текст | разделы 4, 9: стекированные изменения, работа без ожидания ревью |
| S89 | Prompt caching | Anthropic (Claude Platform docs) | platform.claude.com/docs/en/build-with-claude/prompt-caching | без даты | 2026-09-27 | полный текст | разделы 4, 7: множители записи и чтения кеша, порядок tools → system → messages, что инвалидирует кеш |
| S90 | Design by contract | Wikipedia | en.wikipedia.org/wiki/Design_by_contract | без даты | 2026-09-27 | полный текст | разделы 5, 11: предусловия, постусловия, инварианты (Meyer, 1986) |
| S91 | Plans & Pricing | Anthropic | claude.com/pricing | без даты | 2026-09-27 | полный текст | разделы 5, 9: Pro $20, Max 5x $100, Team $25/$125 за место, Claude Code во всех платных планах |
| S92 | Team Topologies: Key Concepts | Team Topologies | teamtopologies.com/key-concepts | без даты | 2026-09-27 | полный текст | разделы 7, 11, 12: типы команд, режимы взаимодействия, когнитивная нагрузка |
| S93 | DORA AI Capabilities Model (обзор в поиске и страница отчёта) | DORA, Google Cloud | dora.dev/ai/capabilities-model/report/ | 2025-09 | 2026-09-27 | фрагмент | разделы 7, 12: семь способностей, включая работу малыми партиями и контроль версий |
| S94 | Jules, Google's asynchronous AI coding agent, is out of public beta | blog.google/technology/google-labs/jules-now-available/ | 2025-08-06 | 2026-09-27 | полный текст | разделы 9, 12: тарифы с лимитами 5x и 20x | |
| S95 | Usage limit best practices | Anthropic Help Center | support.claude.com/en/articles/9797557-usage-limit-best-p… | без даты | 2026-09-27 | полный текст | разделы 10, 12: факторы расхода лимита |
| S96 | Information hiding | Wikipedia | en.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, командами проверки и ловушками.
- Сквозная трасса термин подхода пользователя
- критический сценарий, проходящий через несколько зон и закреплённый тестом.