---
title: "Проектирование систем для параллельной разработки ИИ-агентами: границы, контракты, тестирование и экономия токенов"
slug: "parallel-ai-development-architecture"
participant: opus
model: "claude-opus-5-5"
effort: "xhigh"
date: 2026-09-27
cutoff: 2026-09-27
language: ru
sources_read: 96
status: complete
summary: "Каталог из 38 стратегий, методика нарезки на зоны, правила контрактов и таблица перепроверки для параллельной разработки ИИ-агентами. Главный вывод: скорость дают модульный монолит с машиночитаемыми контрактами, линтером границ, выбором тестов по графу зон и одним агентом на зону, но только вместе с ускорением приёмки, малыми партиями и экономией контекста. Ограничение: прямых исследований эффекта архитектуры на продуктивность агентов нет, вывод опирается на косвенную эмпирику и документацию."
---

# Проектирование систем для параллельной разработки ИИ-агентами: границы, контракты, тестирование и экономия токенов

## 0. Вердикт {#verdict}

**Параллельная разработка ИИ-агентами ускоряет работу, только если вместе с генерацией кода масштабируются проверка, интеграция и приёмка: при росте потока PR время ревью растёт кратно, а рост внедрения ИИ связан со снижением стабильности поставки** {эмпирика} [S1, S2, S3].

- **Для кого и что выбрать.** Одному человеку или команде до 10 человек с несколькими агентами лучше всего подходит модульный монолит, нарезанный на зоны по изменчивым решениям и предметным подобластям, с машиночитаемыми контрактами, линтером границ в CI, выбором тестов по графу зон и одним агентом на зону в изолированной копии {гипотеза}.
- **Механизм выигрыша.** Непересекающиеся множества файлов убирают конфликты, которые без координации возникают в 19,8–41,7 % одновременных PR агентов {эмпирика} [S4], проверка затронутого заменяет полный прогон, а маленькая зона с паспортом экономит контекст — главный ресурс агента {вендор} [S5].
- **Подход пользователя** «ящики → контракты по семи вопросам → трассы → детализация» совпадает с классикой по смыслу границ, но остаётся документным: ему не хватает схем, контрактных тестов, заглушек, линтера границ, правил совместимости и полей для ошибок, арендатора и тестовых обязательств, а детализацию после фиксации контрактов можно вести параллельно (раздел 5.4).
- **Векторы, которых нет в постановке** (раздел 1.8):
  - приёмка как главное узкое место: доказательства, хук-гейт, ревью по риску;
  - малые партии;
  - лимиты уходят на контекст, а не на код: свежие сессии, субагенты, хуки-фильтры, кеш;
  - детерминированные скрипты и генераторы вместо рассуждений модели;
  - единая очередь задач с WIP-лимитом против дублей и брошенных PR.
- **Ключевое ограничение.** Контролируемых исследований о влиянии архитектуры на продуктивность агентов не найдено, и вывод собран из косвенной эмпирики, документации производителей и классических аргументов модульности.
- **Сильнейшая альтернатива.** Для прототипов и маленьких систем выигрывает однопоточная работа с одним агентом без зон, а частям, которым нужна независимая эксплуатация, подходит выделение двух-трёх сервисов при модульном монолите для остального.
- **Уверенность средняя.** Механизмы (конфликты, деградация контекста, узкое место ревью) подтверждены данными и документацией, но размер ускорения для конкретной команды нужно измерять метриками раздела 8, а не ощущением, которое в среднем ошибается на 40 п. п. {эмпирика} [S6].

## 1. Что это и как работает {#basics}

### 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):

```text
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].

**Правило влияния.** Множество перепроверки после изменения:

```text
Перепроверить(Δ) = тесты(зоны, где Δ)
                 ∪ тесты(зон, зависящих от изменённого публичного 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. Актуальность и доказательная база на дату среза {#evidence}

### 2.1. Распространённость и тренд

Тренд растущий по всем сегментам. **ИИ в разработке стал нормой, а параллельный запуск агентов — штатной функцией всех ведущих инструментов**:

- DORA 2025: почти 5000 респондентов, 90 % используют ИИ в работе, более 80 % считают, что он повысил их продуктивность, 30 % мало или совсем не доверяют сгенерированному коду {эмпирика} [S56];
- Faros 2026: 80 % команд превышают порог 50 % еженедельно активных пользователей ИИ, доля принятых предложений выросла с 20 % до 60 % {эмпирика} [S2];
- METR в 2026 году столкнулся с тем, что разработчики отказываются работать без ИИ, а 30–50 % участников не отправляли задачи, которые не хотели делать без ИИ {эмпирика} [S57]; в опросе 349 технических специалистов половина регулярно использует Claude Code {эмпирика} [S6];
- формат AGENTS.md используют более 60 тыс. открытых проектов, его поддерживают Codex, Jules, Devin, агент Copilot, Cursor, Aider и другие инструменты {вендор} [S34];
- наборы данных PR, созданных агентами: 33 596 PR пяти агентов за декабрь 2024 — июль 2025 [S51, S4] и более 142 тыс. PR [S49] {факт};
- параллельные режимы есть у Claude Code (worktree, субагенты, команды агентов, фоновые сессии) [S58], Codex cloud [S30], Cursor cloud agents [S59], агента GitHub Copilot [S60], Jules [S61], Devin [S62], Kiro с параллельными волнами задач [S63] {факт}.

Сегменты: у одиночных разработчиков и малых команд параллельные сессии в worktree стали массовой практикой по описаниям практиков {мнение} [S47]; у крупных организаций данные телеметрии показывают рост объёма работы при ухудшении стабильности {эмпирика} [S2]. Доли по сегментам в процентах источники не дают.

### 2.2. Эффект ИИ на скорость: исследования

| Исследование | Дизайн и выборка | Результат | Ограничения |
|---|---|---|---|
| METR, 2025 [S7] | РКИ, 16 опытных разработчиков открытых проектов, 246 задач в своих репозиториях, Cursor с Claude 3.5/3.7 | Замедление на 19 %; ожидали +24 %, после работы считали +20 % {эмпирика} [S7] | Малая выборка, знакомые большие кодовые базы, инструменты начала 2025 года |
| METR, обновление 2026 [S57] | 57 разработчиков, 143 репозитория, 800+ задач | Вернувшиеся участники: −18 % (ДИ от −38 % до +9 %), новые: −4 % (ДИ от −15 % до +9 %) {эмпирика} [S57] | Сильный эффект отбора; сам METR считает, что результат недооценивает ускорение, и меняет дизайн |
| Google, 2024 [S64] | РКИ, 96 инженеров, одна сложная корпоративная задача | ~21 % быстрее, широкий доверительный интервал {эмпирика} [S64] | Одна задача, внутренние инструменты лета 2024 года |
| Microsoft, Accenture, Fortune 100 [S65] | Три полевых РКИ, 4867 разработчиков | +26,08 % завершённых задач (SE 10,3 %), больше у менее опытных {эмпирика} [S65] | Автодополнение, а не агенты |
| Стэнфорд, доклад Y. Denisov-Blanch (пересказ) [S66] | ~100 тыс. разработчиков, 600+ компаний, оценка коммитов алгоритмом | Чистый выигрыш ~15–20 %; 30–40 % на простых новых задачах, 0–10 % на сложных в существующем коде; выигрыш резко падает с ростом кодовой базы {эмпирика} [S66] | Доклад, а не рецензируемая статья; прочитан пересказ |
| METR, опрос 2026 [S6] | 349 специалистов, удобная выборка | Самооценка ценности 1,4–2x, скорости 3x {эмпирика} [S6] | Самооценки систематически завышены |

Выводы из таблицы {гипотеза}: эффект положителен на изолированных, чётко заданных задачах и падает на сложных задачах в больших знакомых кодовых базах. Это прямо поддерживает тезис об изоляции: чем меньше и понятнее зона, в которой работает агент, тем ближе задача к «новой и простой».

### 2.3. Эффект на стабильность, качество и переделки

- DORA 2024: рост внедрения ИИ на 25 % связан со снижением пропускной способности поставки на 1,5 % и стабильности на 7,2 % {эмпирика} [S3]; DORA 2025: внедрение ИИ положительно связано с пропускной способностью и отрицательно — со стабильностью {эмпирика} [S56].
- Faros 2025 (10 тыс.+ разработчиков, 1255 команд, корреляционный анализ): +21 % задач, +98 % PR, +91 % время ревью, +154 % размер PR, +9 % багов на разработчика {эмпирика} [S1].
- Faros 2026 (22 тыс. разработчиков, 4000+ команд, сравнение периодов низкого и высокого внедрения внутри организаций): +66 % эпиков, +33,7 % задач, +54 % багов на разработчика, отношение инцидентов к PR +242,7 %, отток кода +861 %, PR без ревью +31,3 %, ежедневные контексты PR на разработчика +67,4 % {эмпирика} [S2].
- GitClear (211 млн изменённых строк, 2020–2024, корреляция): доля рефакторинга и перемещённого кода упала с 25 % до менее 10 %, копипаста выросла с 8,3 % до 12,3 % {эмпирика} [S54].
- PR агентов: из 33 596 PR слито 71,48 %; неслитые крупнее, затрагивают больше файлов и чаще падают в CI; среди 600 вручную разобранных отклонённых PR 38 % брошены без участия ревьюера, 23 % — дубликаты, 17 % — падения CI/тестов {эмпирика} [S51]. В выборке 567 PR Claude Code слито 83,8 %, из них 54,9 % без правок {эмпирика} [S52].
- Конфликты: 27,67 % PR агентов с конфликтами слияния {эмпирика} [S49]; 19,8 % текстовых конфликтов у одновременных PR однотипных агентов и 41,7 % у разных, ~42 % конфликтов структурные {эмпирика} [S4].

### 2.4. Параллельность и мультиагентность

- Anthropic: агенты расходуют ~4x токенов чата, мультиагентные системы ~15x; в оценке исследовательского агента объём токенов объяснял 80 % дисперсии качества; мультиагентность плохо подходит задачам с общим контекстом и многими зависимостями, и кодинг приведён как пример {вендор} [S53].
- Cognition (Devin): параллельные субагенты без общего контекста принимают конфликтующие неявные решения; рекомендован однопоточный агент со сжатием контекста {мнение} [S48].
- MAST: 1600+ трасс семи мультиагентных фреймворков, 14 видов отказов в трёх категориях — проектирование системы, рассогласование агентов, проверка задачи {эмпирика} [S50].
- Claude Code: команды агентов расходуют примерно в 7 раз больше токенов, чем обычная сессия, когда участники работают в режиме плана; рекомендовано 3–5 участников и 5–6 задач на участника {вендор} [S37, S10].
- Кейс OpenAI (harness engineering): команда из 3, затем 7 инженеров за 5 месяцев выпустила ~1 млн строк и ~1500 PR, 3,5 PR в день на инженера, без ручного кода; архитектура закреплена слоями и линтерами {вендор} [S44, S45]. Оригинал недоступен (403), данные из двух независимых конспектов {факт} [S67].

**Контролируемых исследований, которые сравнивали бы архитектуры (модульная против немодульной) по продуктивности агентов, не найдено.** Связь «изоляция → скорость агентов» опирается на косвенные данные {гипотеза}: падение выигрыша с ростом кодовой базы [S66], деградацию качества с ростом контекста [S13], данные о конфликтах [S4, S49] и классические аргументы модульности [S8].

### 2.5. Тестирование без полного прогона

- Meta: предиктивный выбор тестов ловит более 99,9 % регрессий, запуская около трети тестов, транзитивно зависящих от изменения, и вдвое повышает эффективность тестовой инфраструктуры {эмпирика} [S27]. Это внутренняя система вендора с огромной историей прогонов; переносимость на малые проекты не показана.
- CloudBees Smart Tests (бывший Launchable) заявляет сокращение времени выполнения тестов «до 80 %» {вендор} [S68].
- Нестабильность: 75 % нестабильных тестов падают кластерами, в промышленном кейсе разработчики тратили 1,28 % времени на их починку {эмпирика} [S46].
- Тесты как постановка: добавление тестов к условию задачи повышает долю решённых задач у GPT-4 и Llama 3 на MBPP и HumanEval {эмпирика} [S55].
- Горизонт задач: METR измеряет длительность задач, которые агент решает с вероятностью 50 %, на чётко заданных задачах и предупреждает, что на реальных работах с неясными критериями успех ниже {факт} [S69].

### 2.6. Практическая база и вендорские данные

- Стоимость: средний расход Claude Code в корпоративных развёртываниях около $13 на разработчика в активный день и $150–250 в месяц, у 90 % пользователей ниже $30 в день {вендор} [S37].
- Лимиты подписок: окно 5 часов плюс недельный лимит у Claude Max [S70]; у Codex локальные сообщения и облачные задачи делят один лимит, число сообщений за 5 часов зависит от модели на порядок {вендор} [S71].
- Shopify: монолит 2,8 млн строк Ruby, 37 компонентов, Packwerk проверяет зависимости за минуты {вендор} [S18]; ретроспектива 2024 года: проверки приватности удалены, разработчики группируют код по смысловым признакам, мало связанным с фактическим исполнением {вендор} [S72].
- Devin: задачи до ~3 часов человеческой работы с явными критериями успеха {вендор} [S62].

### 2.7. Мнения отрасли

| Позиция | Кто | Аргумент |
|---|---|---|
| Модульный монолит вместо микросервисов | Fowler, Shopify | Неверные границы между сервисами дорого исправлять; распределённость — наценка {мнение} [S73, S74, S18] |
| Малые партии и магистральная разработка обязательны при ИИ | DORA | ИИ провоцирует крупные изменения, которые трудно ревьюить и интегрировать {мнение} [S31, S32] |
| ИИ — усилитель существующих практик | DORA 2025 | Сильные платформы и практики дают больший выигрыш {эмпирика} [S56] |
| Сильные основы не защищают | Faros 2026 | Деградация ниже по потоку наблюдается и у зрелых организаций {эмпирика} [S2] |
| Против мультиагентности в кодинге | Cognition, Anthropic для задач с общим контекстом | Неявные решения и общий контекст {мнение} [S48, S53] |
| Скепсис к тяжёлым SDD-процессам | Böckeler | Избыточны для мелких задач, markdown тяжело ревьюить, агенты не всегда следуют спецификации {мнение} [S75] |
| Модули по фактическому исполнению, а не по смыслу | Shopify | Семантические пакеты не дают реальной изоляции {вендор} [S72] |

### 2.8. Главные споры

1. **Ускоряет ли ИИ опытных разработчиков в знакомом большом коде.** РКИ METR показало замедление {эмпирика} [S7], РКИ Google и Microsoft — ускорение {эмпирика} [S64, S65]; различаются задачи (своя сложная кодовая база против изолированной задачи) и инструменты.
2. **Один агент с хорошим контекстом или много агентов.** Anthropic использует мультиагентность для исследований и оговаривает её слабость в кодинге {вендор} [S53], Cognition против {мнение} [S48], документация Claude Code советует команды агентов для исследования, ревью и независимых модулей {вендор} [S10].
3. **Ревью человеком или агентом.** В кейсе OpenAI ревью сдвинуто к агент-агент {вендор} [S45]; Faros фиксирует рост PR без ревью вместе с ростом инцидентов {эмпирика} [S2].
4. **Спецификация как источник истины или код.** Böckeler сравнивает spec-as-source с неудачами модельно-ориентированной разработки {мнение} [S75].

### 2.9. Что изменилось за 2023–2026 годы

- Генерация кода подешевела до почти нулевой предельной стоимости, а проверка, ревью и интеграция стали доминирующими статьями времени {эмпирика} [S1, S2].
- Появились фоновые и облачные агенты, работающие параллельно в изолированных средах, и встроенная изоляция worktree в Claude Code {факт} [S30, S60, S59, S29].
- Подписки получили окна лимитов (5 часов и неделя), поэтому экономия контекста стала вопросом доступности работы, а не только денег {факт} [S70, S71].
- Сложился стандарт файлов правил AGENTS.md и инструменты spec-driven development {факт} [S34, S76, S63].

Следствие для выводов: архитектура, оптимизированная под параллельную агентную работу, оптимизирует прежде всего **стоимость проверки и интеграции**, а не стоимость написания кода {гипотеза}.

## 3. Где применимо и где нет, плюсы и минусы {#fit}

Ниже «предмет» — зонная архитектура для агентов: модульный монолит (или монорепозиторий) с контрактами между зонами, автоматическим контролем зависимостей, выбором тестов по графу зон и параллельными агентами в изолированных копиях.

### Подходит, когда

- **В системе есть устойчивые подобласти с разным языком и темпом изменений** (арендаторы и доступ, биллинг, уведомления, отчёты, интеграции). Границы ограниченных контекстов проходят там, где меняются язык и модель {факт} [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. Альтернативы и дерево решений {#alternatives}

Раздел состоит из пяти частей: сравнение предмета с альтернативами (4.1), каталог стратегий (4.2), сводная матрица стратегий (4.3), разбор альтернатив (4.4) и дерево решений.

### 4.1. Предмет и альтернативы: сравнительная таблица

Предмет сравнения — зонная архитектура для агентов (раздел 3). Альтернативы того же класса — другие способы получить скорость разработки с агентами.

| Вариант | Потенциал параллельности | Стоимость проверки итерации | Расход лимитов | Цена входа | Эксплуатационная цена | Риск ошибок границ | Соло | Команда до 10 |
|---|---|---|---|---|---|---|---|---|
| **Зонная архитектура: модульный монолит + контракты + выбор тестов + изолированные агенты** | высокий | низкая (зона + контракты) | низкий–средний | средняя | низкая | средний, дёшево исправлять | да | да |
| Однопоточная итеративная работа с одним агентом и полным прогоном | низкий | высокая, растёт с системой | средний | нулевая | низкая | нет | да, до роста системы | нет |
| Микросервисы с контрактными тестами | высокий | низкая на сервис, высокая на интеграцию | средний | высокая | высокая | высокий, дорого исправлять | нет | редко |
| Микрофронтенды + BFF | средний (фронтенд) | средняя | средний | высокая | высокая | средний | нет | при нескольких фронтенд-командах |
| SDD-конвейер (Spec Kit, Kiro) с параллельными волнами задач без контроля границ | средний | средняя | средний–высокий (много markdown) | низкая | низкая | высокий (границы не проверяются) | для крупных фич | для крупных фич |
| Оркестрация многих агентов (команды агентов) поверх неразрезанного кода | средний, падает от конфликтов | высокая | высокий (~7–15x) | низкая | средняя | высокий | нет | для исследования и ревью |
| Предиктивный выбор тестов и распределённый CI без архитектурной изоляции | низкий–средний | средняя | низкий | средняя–высокая | средняя | не решает | нет | при большом наборе тестов |
| Облачные фоновые агенты «по тикету» как основной режим | средний–высокий | средняя | средний | низкая | низкая | высокий без границ | да, для рутинных задач | да, для рутинных задач |

Оценки в таблице — авторский синтез по источникам раздела 2 и каталогу 4.2 {гипотеза}; числа расхода токенов — по данным Anthropic {вендор} [S37, S53].

### 4.2. Каталог стратегий

Шкала влияния: «сильное», «среднее», «слабое». Поле «Доказанность» отделяет эмпирику от практики вендоров, мнений и гипотез. Коды A — архитектура, B — тесты, C — процесс, D — контекст агентов и лимиты.

**Блок A. Архитектура.**

#### A1. Зоны по сокрытию решений и паспорт зоны

- **Проблема.** Неясно, где кончается ответственность куска кода; изменения расползаются по системе, агенту приходится читать всё.
- **Как работает.** Систему режут по решениям, которые вероятно изменятся (платёжный провайдер, тарифная модель, канал уведомлений), а не по шагам обработки. У каждой зоны есть паспорт: назначение, «чего зона не делает», публичный API, разрешённые зависимости, команды тестов, владелец (шаблон в разделе 6).
- **Уровень.** Архитектура.
- **Параллельность.** Сильное влияние: задача попадает в одну зону.
- **Время тестов.** Среднее: задаёт единицу выбора тестов.
- **Лимиты и лишняя работа.** Сильное: паспорт заменяет разведку репозитория.
- **Цена внедрения.** Часы на зону в новой системе; дни или недели на существующую.
- **Риски.** Нарезка «по смыслу» может не совпасть с фактическими вызовами {вендор} [S72].
- **Когда не применять.** Прототип с неясным доменом.
- **Инструменты.** Markdown-паспорта, вложенные AGENTS.md в папках зон {факт} [S34].
- **Доказанность.** Классический аргумент Парнаса о сокращении сроков за счёт независимых групп {факт} [S8]; прямых измерений для агентов нет {гипотеза}.

#### A2. Ограниченные контексты и карта контекстов

- **Проблема.** Одна общая модель данных порождает противоречивые смыслы одних и тех же слов («клиент», «заказ») {факт} [S17].
- **Как работает.** Границы проводят там, где меняется язык предметной области; карта контекстов фиксирует отношения между контекстами и способы трансляции понятий {факт} [S17].
- **Уровень.** Архитектура и организация.
- **Параллельность.** Сильное влияние на верхнем уровне нарезки.
- **Время тестов.** Среднее.
- **Лимиты и лишняя работа.** Среднее: словарь зоны снижает недопонимание в промптах {гипотеза}.
- **Цена внедрения.** Дни на разбор домена.
- **Риски.** Неверные контексты в новом домене {мнение} [S73].
- **Когда не применять.** Небольшое CRUD-приложение с одним языком.
- **Инструменты.** Карта контекстов в markdown или диаграмме.
- **Доказанность.** Мнение практиков {мнение} [S17, S73].

#### A3. Модульный монолит с автоматическим контролем зависимостей

- **Проблема.** Границы стираются: агент импортирует внутренности соседа, потому что так короче.
- **Как работает.** Модули живут в одном развёртывании; линтер в CI запрещает импорт внутренностей, циклы и незаявленные зависимости; существующие нарушения фиксируются списком и не растут {факт} [S18, S20, S38].
- **Уровень.** Архитектура и CI.
- **Параллельность.** Сильное.
- **Время тестов.** Среднее: даёт граф для выбора тестов; Spring Modulith запускает тесты только изменённых модулей и их зависимых {факт} [S39].
- **Лимиты и лишняя работа.** Сильное: сообщение линтера учит агента без участия человека; в проекте OpenAI линтеры писались так, чтобы текст ошибки был инструкцией по исправлению {вендор} [S44].
- **Цена внедрения.** Часы на настройку; недели на разбор старых нарушений.
- **Риски.** Смысловые пакеты не гарантируют изоляцию исполнения; динамические импорты не отслеживаются {вендор} [S72].
- **Когда не применять.** Нужны независимые развёртывание и масштабирование частей — тогда A10.
- **Инструменты.** import-linter и tach для Python и Django, Packwerk для Ruby, Spring Modulith для Java, правило границ Nx для TypeScript {факт} [S20, S38, S18, S19, S79].
- **Доказанность.** Кейсы Shopify и OpenAI {вендор} [S18, S72, S44]; контролируемых исследований нет.

#### A4. Порты и адаптеры

- **Проблема.** Бизнес-логика смешана с БД, HTTP и брокером, поэтому тесты медленные и требуют окружения.
- **Как работает.** Ядро зоны общается с миром через порты; к порту подключаются адаптеры — БД, HTTP, очередь, тестовая обвязка, хранилище в памяти; приложение можно запускать без UI и БД для регрессионных тестов {факт} [S21].
- **Уровень.** Архитектура и тесты.
- **Параллельность.** Среднее: адаптер соседа заменяется фейком.
- **Время тестов.** Сильное: ядро тестируется за секунды.
- **Лимиты и лишняя работа.** Среднее: короткие выводы тестов.
- **Цена внедрения.** Среднее: дополнительные интерфейсы.
- **Риски.** Мелкие абстракции-прокладки без смысла; Bogard критикует избыточные слои {мнение} [S22].
- **Когда не применять.** Тонкие CRUD-зоны без логики.
- **Инструменты.** Средства языка; фейки в памяти.
- **Доказанность.** Паттерн и мнение практиков {мнение} [S21].

#### A5. Вертикальные срезы внутри зоны

- **Проблема.** Горизонтальные слои (контроллеры, сервисы, репозитории) заставляют каждую фичу править общие файлы слоёв.
- **Как работает.** Фича — папка со своим обработчиком, схемой и тестами; минимум связности между срезами, максимум внутри среза {мнение} [S22].
- **Уровень.** Архитектура внутри зоны.
- **Параллельность.** Сильное: два агента на двух фичах одной зоны не трогают одних файлов.
- **Время тестов.** Среднее: тесты среза.
- **Лимиты и лишняя работа.** Сильное: агент читает одну папку.
- **Цена внедрения.** Низкая для нового кода.
- **Риски.** Дублирование между срезами; требует навыка рефакторинга {мнение} [S22].
- **Когда не применять.** Много общей доменной логики, которую срезы начнут копировать.
- **Инструменты.** Структура папок, генератор среза (D5).
- **Доказанность.** Мнение практиков {мнение} [S22].

#### A6. События и фоновые задачи как граница

- **Проблема.** Синхронные вызовы связывают зоны по времени ответа, отказам и тестам.
- **Как работает.** Зона публикует доменное событие со схемой; воркеры и задачи по расписанию подписываются; контракт — схема сообщения плюс гарантии (доставка не менее одного раза, идемпотентность обработчика, порядок) {гипотеза}. AsyncAPI описывает каналы, сообщения, производителей и потребителей {факт} [S77].
- **Уровень.** Архитектура.
- **Параллельность.** Сильное: производитель и потребитель разрабатываются по схеме независимо.
- **Время тестов.** Сильное: сценарий «опубликовать событие → дождаться результата» проверяет зону без остальной системы, как в Scenario API Spring Modulith {факт} [S39].
- **Лимиты и лишняя работа.** Среднее.
- **Цена внедрения.** Средняя: брокер, повторы, идемпотентность.
- **Риски.** Итоговая согласованность, более трудная отладка, скрытая связность через состав события.
- **Когда не применять.** Нужен немедленный согласованный ответ пользователю.
- **Инструменты.** AsyncAPI, события Spring Modulith {факт} [S77, S39].
- **Доказанность.** Инструменты описаны в документации {факт} [S77, S39]; эффект на скорость агентов — {гипотеза}.

#### A7. Контракт-первым: машиночитаемая схема и проверка совместимости

- **Проблема.** Агенты фронтенда, сервера и воркера по-разному понимают интерфейс.
- **Как работает.** Сначала пишется схема (OpenAPI, JSON Schema, AsyncAPI, protobuf) в пакете контрактов; из неё генерируются типы и клиенты; CI сравнивает схему с предыдущей версией и блокирует несовместимые изменения {факт} [S40, S41].
- **Уровень.** Архитектура и CI.
- **Параллельность.** Сильное.
- **Время тестов.** Среднее: проверка схемы идёт секунды.
- **Лимиты и лишняя работа.** Сильное: схема — компактный контекст вместо кода соседа {гипотеза}.
- **Цена внедрения.** Низкая–средняя.
- **Риски.** Проверка по схеме не доказывает, что потребитель вызывает поставщика правильно {факт} [S26].
- **Когда не применять.** Вызовы внутри одной зоны.
- **Инструменты.** buf breaking, oasdiff, генераторы клиентов {факт} [S40, S41].
- **Доказанность.** Инструменты описаны в документации {факт} [S40, S41]; эффект — {гипотеза}.

#### A8. Заглушки и фейки по контракту

- **Проблема.** Зона-потребитель ждёт готовности зоны-поставщика.
- **Как работает.** Мок-сервер из OpenAPI, фейк-адаптер порта в памяти, фикстуры событий; потребитель разрабатывается против заглушки, затем подключается реальный поставщик {факт} [S80, S21].
- **Уровень.** Тесты и процесс.
- **Параллельность.** Сильное.
- **Время тестов.** Сильное для тестов потребителя.
- **Лимиты и лишняя работа.** Среднее.
- **Цена внедрения.** Низкая.
- **Риски.** Заглушка расходится с поставщиком; закрывается контрактными тестами B2.
- **Когда не применять.** Поставщик уже готов и стабилен.
- **Инструменты.** Prism (мок и прокси-валидация) {факт} [S80].
- **Доказанность.** Инструменты описаны в документации {факт} [S80]; эффект — {гипотеза}.

#### A9. Версии контрактов и expand → contract

- **Проблема.** Несовместимое изменение ломает параллельную работу всех потребителей.
- **Как работает.** По умолчанию только совместимые (добавляющие) изменения; несовместимое — новая версия рядом со старой, миграция потребителей, удаление старой {факт} [S42]; потребители читают терпимо {факт} [S43]; изменение оформляется записью решения со статусом {факт} [S81].
- **Уровень.** Архитектура и процесс.
- **Параллельность.** Сильное: потребители мигрируют независимо.
- **Время тестов.** Среднее.
- **Лимиты и лишняя работа.** Слабое.
- **Цена внедрения.** Низкая–средняя, временное дублирование.
- **Риски.** Забытые старые версии.
- **Когда не применять.** Потребитель один и меняется в том же PR.
- **Инструменты.** buf, oasdiff, ADR {факт} [S40, S41, S81].
- **Доказанность.** Устоявшаяся практика {мнение} [S42].

#### A10. Микросервисы и микрофронтенды

- **Проблема.** Нужны независимые развёртывание, масштабирование или технологический стек частей.
- **Как работает.** Компоненты вне процесса со своей БД и конвейером {факт} [S82]; микрофронтенды собираются в целое во время выполнения {факт} [S83].
- **Уровень.** Архитектура и эксплуатация.
- **Параллельность.** Сильное для команд; для агентов не больше, чем у модульного монолита с контролем границ {гипотеза}.
- **Время тестов.** CI сервиса короткий, но интеграция требует контрактных тестов и сред.
- **Лимиты и лишняя работа.** Смешанное: контекст сервиса мал, но сквозное изменение требует нескольких репозиториев и сессий.
- **Цена внедрения.** Высокая: развёртывание, мониторинг, отказы, итоговая согласованность {мнение} [S74]; у микрофронтендов — дублирование зависимостей и операционная сложность {мнение} [S83].
- **Риски.** Ошибки границ дороже, чем в монолите {мнение} [S73].
- **Когда не применять.** Один человек или команда до 10 человек без требований независимого масштабирования.
- **Инструменты.** Контрактные тесты (B2), мок-серверы (A8).
- **Доказанность.** Мнение практиков {мнение} [S73, S74].

#### A11. Устранение горячих общих файлов

- **Проблема.** Даже при разных зонах агенты правят общие реестры: корневой маршрутизатор, список приложений в настройках, DI-контейнер, таблицу маршрутов фронтенда, файлы переводов, журнал изменений.
- **Как работает.** Автообнаружение (зона регистрирует себя сама), файл маршрутов на зону, миграции в папке зоны, генерируемые индексы, фрагменты журнала изменений; lock-файл меняет только выделенная задача {гипотеза}.
- **Уровень.** Архитектура и процесс.
- **Параллельность.** Сильное.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Среднее: меньше циклов разрешения конфликтов.
- **Цена внедрения.** Низкая.
- **Риски.** Неявная регистрация хуже читается.
- **Когда не применять.** Один агент за раз.
- **Инструменты.** Средства фреймворка (автообнаружение), генераторы.
- **Доказанность.** Около 42 % конфликтов агентов структурные, 84,4 % конфликтных файлов — исходный код, lock-файлы — лишь 3,9 % {эмпирика} [S4]; сам приём — {гипотеза}.

**Блок B. Тесты.**

#### B1. Форма набора тестов на зону

- **Проблема.** Полный сквозной набор медленный и нестабильный, а мелкие тесты на детали реализации ломаются при каждом рефакторинге агентом.
- **Как работает.** В зоне — быстрые тесты ядра (A4) и интеграционные тесты зоны через её публичный API с настоящей БД в контейнере; между зонами — контрактные тесты; сквозные тесты — только для критических трасс. Это соответствует «сотам» Spotify (упор на интеграционные тесты сервиса в изоляции, отказ от integrated-тестов, зависящих от чужих систем) и «трофею» (статические проверки, немного unit, в основном интеграционные) {мнение} [S24, S25]; пирамида рекомендует опускать тест как можно ниже и держать сквозных тестов минимум {мнение} [S23].
- **Уровень.** Тесты.
- **Параллельность.** Сильное: каждый агент владеет тестами своей зоны.
- **Время тестов.** Сильное.
- **Лимиты и лишняя работа.** Среднее: короткие и адресные выводы.
- **Цена внедрения.** Средняя.
- **Риски.** Пробелы на стыках, если нет контрактных тестов.
- **Когда не применять.** Никогда полностью; меняется только пропорция.
- **Инструменты.** pytest, Jest или Vitest, Testcontainers {факт} [S84].
- **Доказанность.** Мнение практиков {мнение} [S23, S24, S25].

#### B2. Контракты, задаваемые потребителем

- **Проблема.** Изменение поставщика ломает потребителя только после интеграции.
- **Как работает.** Тесты потребителя порождают контракт (pact); поставщик проверяет его в своём CI; проверяются только реально используемые части взаимодействия {факт} [S26]. Идея восходит к консолидированному контракту из ожиданий всех потребителей {факт} [S43].
- **Уровень.** Тесты.
- **Параллельность.** Сильное.
- **Время тестов.** Сильное: заменяет интеграционную среду «поднять весь мир» {вендор} [S26].
- **Лимиты и лишняя работа.** Среднее.
- **Цена внедрения.** Средняя: брокер контрактов, дисциплина версий.
- **Риски.** Избыточны внутри одного процесса с типизированными интерфейсами, где компилятор и тесты модуля уже проверяют вызовы {гипотеза}.
- **Когда не применять.** Вызовы внутри модульного монолита на типизированном языке; применять на HTTP-границе с фронтендом, между процессами и на событиях.
- **Инструменты.** Pact {факт} [S26].
- **Доказанность.** Практика и мнение {мнение} [S26, S23].

#### B3. Выбор тестов по изменениям

- **Проблема.** Полный прогон на каждой итерации.
- **Как работает.** Три семейства: по графу проектов (Nx affected, Bazel, Spring Modulith) {факт} [S11, S12, S39]; по покрытию — pytest-testmon хранит связи тестов и исполненного кода и повторяет упавшие тесты {факт} [S28]; предиктивный выбор машинным обучением (Meta, CloudBees Smart Tests) {факт} [S27, S85].
- **Уровень.** Тесты и CI.
- **Параллельность.** Среднее: короче очередь CI.
- **Время тестов.** Сильное.
- **Лимиты и лишняя работа.** Сильное: агент запускает меньше тестов и читает короче вывод.
- **Цена внедрения.** Низкая (testmon) — высокая (Bazel).
- **Риски.** Пропуски: testmon не отслеживает статические файлы и внешние сервисы [S28], lock-файл делает затронутым всё [S11] {факт}; нужен регулярный полный прогон.
- **Когда не применять.** Полный прогон короче минуты.
- **Инструменты.** Nx, Bazel, Spring Modulith, pytest-testmon, CloudBees Smart Tests.
- **Доказанность.** Meta: более 99,9 % регрессий при трети тестов {эмпирика} [S27]; CloudBees: «до 80 %» {вендор} [S68].

#### B4. Кеширование сборки и результатов тестов

- **Проблема.** Одинаковые тесты повторно запускаются в каждом worktree, в каждом агенте и в CI.
- **Как работает.** Герметичное действие с теми же входами даёт тот же результат, поэтому его результат берётся из кеша, в том числе удалённого {факт} [S12, S11].
- **Уровень.** Тесты и CI.
- **Параллельность.** Среднее: параллельные копии делят удалённый кеш.
- **Время тестов.** Сильное при герметичности.
- **Лимиты и лишняя работа.** Слабое напрямую.
- **Цена внедрения.** Средняя–высокая.
- **Риски.** Негерметичность (время, системные бинарники, правка исходников при сборке) ломает кеш {факт} [S12].
- **Когда не применять.** Небольшой проект на интерпретируемом языке с быстрыми тестами.
- **Инструменты.** Bazel, Nx с удалённым кешем.
- **Доказанность.** Документация инструментов {факт} [S12, S11].

#### B5. Изолированные воспроизводимые окружения

- **Проблема.** Параллельные агенты сталкиваются портами, общей БД и состоянием; появляются нестабильные тесты.
- **Как работает.** Одноразовые контейнеры зависимостей со случайными портами для каждого прогона {факт} [S84]; копирование `.env` в новые worktree через `.worktreeinclude` {факт} [S29]; облачные окружения со скриптами установки {факт} [S30, S59].
- **Уровень.** Тесты и инфраструктура разработки.
- **Параллельность.** Сильное.
- **Время тестов.** Среднее; снижает нестабильность.
- **Лимиты и лишняя работа.** Среднее: агент не тратит сессию на починку окружения.
- **Цена внедрения.** Средняя.
- **Риски.** Медленный старт контейнеров; различия локальной и облачной среды.
- **Когда не применять.** Нет внешних зависимостей.
- **Инструменты.** Testcontainers, devcontainer, облачные среды агентов.
- **Доказанность.** Cursor называет настройку окружения самым важным шагом для эффективности облачных агентов {вендор} [S59].

#### B6. Эталонные тесты и снимки

- **Проблема.** Сложные выходы (отчёты, письма, страницы, ответы API) проверяются глазами человека.
- **Как работает.** Тест сравнивает полученный результат с одобренным файлом; при расхождении человек один раз одобряет новый эталон или признаёт ошибку {факт} [S86]; для UI — сравнение скриншотов.
- **Уровень.** Тесты.
- **Параллельность.** Среднее.
- **Время тестов.** Среднее.
- **Лимиты и лишняя работа.** Сильное: снимает повторную ручную проверку.
- **Цена внедрения.** Низкая.
- **Риски.** Одобрение снимков не глядя; хрупкость к несущественным изменениям.
- **Когда не применять.** Выход недетерминирован (время, случайность) без нормализации.
- **Инструменты.** ApprovalTests, снимки Jest, визуальное сравнение.
- **Доказанность.** Практика {мнение} [S86].

#### B7. Управление нестабильными тестами

- **Проблема.** Ложные падения запускают повторные прогоны и лишние сессии агента.
- **Как работает.** Обнаружение, карантин вне критического пути, повтор только для помеченных тестов {факт} [S87]; починка по кластерам с общей причиной (сеть, внешние зависимости, файловая система, время) {эмпирика} [S46].
- **Уровень.** Тесты.
- **Параллельность.** Слабое.
- **Время тестов.** Среднее.
- **Лимиты и лишняя работа.** Среднее.
- **Цена внедрения.** Низкая–средняя.
- **Риски.** Карантин как кладбище тестов.
- **Когда не применять.** Не бывает.
- **Инструменты.** Отчёты CI, B5.
- **Доказанность.** 75 % нестабильных тестов в кластерах {эмпирика} [S46].

#### B8. Статические проверки как первый уровень

- **Проблема.** Ошибки типов и границ находятся только в долгом прогоне.
- **Как работает.** Типы, линтеры, проверка границ и сравнение схем идут за секунды после каждой правки; плагины кодового анализа в Claude Code сообщают об ошибках типов сразу после правки {вендор} [S37].
- **Уровень.** Тесты.
- **Параллельность.** Слабое.
- **Время тестов.** Сильное.
- **Лимиты и лишняя работа.** Среднее: переход к определению заменяет поиск и чтение нескольких файлов {вендор} [S37].
- **Цена внедрения.** Низкая.
- **Риски.** Ложное чувство безопасности.
- **Когда не применять.** Не бывает.
- **Инструменты.** mypy или pyright, tsc, ESLint, import-linter.
- **Доказанность.** Практика {мнение} [S25].

#### B9. Уровни прогона

- **Проблема.** Один уровень прогона либо слишком медленный для итерации, либо слишком слабый для релиза.
- **Как работает.** L0 — секунды, внутри сессии агента: статические проверки и тесты зоны, закреплённые хуком остановки, который не даёт завершить ход до прохождения проверки {вендор} [S5]. L1 — PR: затронутые зоны, контракты, трассы через изменённые границы. L2 — после слияния в основную ветку: расширенный набор. L3 — ночной и перед релизом: полный прогон и сквозные тесты {гипотеза}.
- **Уровень.** Тесты и процесс.
- **Параллельность.** Среднее.
- **Время тестов.** Сильное.
- **Лимиты и лишняя работа.** Среднее.
- **Цена внедрения.** Низкая.
- **Риски.** Регрессии, найденные только на L3, приходят поздно; нужен владелец ночного прогона.
- **Когда не применять.** Полный прогон короче минуты.
- **Инструменты.** Хуки Claude Code, CI.
- **Доказанность.** {гипотеза} на основе практик [S5, S11].

**Блок C. Процесс.**

#### C1. Карточка задачи для агента

- **Проблема.** Размытая задача порождает переделки, дубли и расползание изменений.
- **Как работает.** Одна задача — одна зона или один контракт; в карточке цель, зона, разрешённые файлы, «чего не делать», команды и тесты приёмки, ссылки на контракты, размер. Документация Claude Code советует самодостаточные спецификации: назвать файлы и интерфейсы, указать, что вне рамок, закончить сквозной проверкой {вендор} [S5]. Anthropic требует от поручения субагенту цели, формата результата, указаний по инструментам и чётких границ задачи, иначе агенты дублируют работу {вендор} [S53]. Devin рекомендует задачи до ~3 часов человеческой работы с явными критериями успеха {вендор} [S62].
- **Уровень.** Процесс.
- **Параллельность.** Сильное.
- **Время тестов.** Среднее: критерии приёмки становятся тестами.
- **Лимиты и лишняя работа.** Сильное: меньше разведки и переделок.
- **Цена внедрения.** Минуты на карточку.
- **Риски.** Карточка-формуляр без смысла; избыточная детализация мелких правок.
- **Когда не применять.** Правка, описываемая одной фразой: документация Claude Code советует пропускать план, если дифф описывается одним предложением {вендор} [S5].
- **Инструменты.** Шаблон в разделе 6, трекер задач.
- **Доказанность.** Рекомендации вендоров {вендор} [S5, S53, S62].

#### C2. Изоляция агентов: worktree, клоны, контейнеры, облако

- **Проблема.** Агенты в одной рабочей копии перезаписывают друг друга.
- **Как работает.** Каждая сессия получает свою рабочую копию: `claude --worktree` создаёт копию и ветку, субагент с `isolation: worktree` работает в собственной копии {факт} [S29, S36]; практик использует отдельные свежие клоны вместо worktree {мнение} [S47]; облачные агенты работают в отдельных контейнерах или ВМ {факт} [S30, S60, S59].
- **Уровень.** Процесс и инструменты.
- **Параллельность.** Сильное.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Нейтрально; параллельные сессии умножают расход токенов {вендор} [S58].
- **Цена внедрения.** Низкая: диск и настройка окружения.
- **Риски.** Worktree делит `.git` и не содержит неотслеживаемых файлов вроде `.env` {факт} [S29]; столкновения портов и БД закрываются B5.
- **Когда не применять.** Задачи в одних и тех же файлах — изоляция лишь откладывает конфликт до слияния.
- **Инструменты.** git worktree, Claude Code, Codex cloud, Cursor cloud agents, агент Copilot.
- **Доказанность.** Документация {факт} [S29, S58].

#### C3. Магистральная разработка и малые партии

- **Проблема.** Долгоживущие ветки агентов расходятся с основной и дают «большой взрыв» интеграции.
- **Как работает.** Не больше трёх активных веток, слияние в основную ветку не реже раза в день, без заморозок и фаз интеграции {факт} [S31]; работа нарезается на задачи от часов до пары дней {факт} [S32].
- **Уровень.** Процесс.
- **Параллельность.** Сильное: конфликты мелкие и частые вместо крупных и редких.
- **Время тестов.** Среднее.
- **Лимиты и лишняя работа.** Среднее.
- **Цена внедрения.** Низкая технически, высокая по дисциплине.
- **Риски.** Требует быстрых проверок и флагов для незавершённого.
- **Когда не применять.** Не бывает для кода, идущего в прод.
- **Инструменты.** CI, флаги (C4).
- **Доказанность.** DORA связывает эти практики с более высокой эффективностью поставки по исследованиям 2016–2017 годов {эмпирика} [S31]; для ИИ — рекомендация как противовес нестабильности {мнение} [S32].

#### C4. Флаги функций

- **Проблема.** Незавершённую фичу нельзя слить, и ветка живёт неделями.
- **Как работает.** Флаги выпуска позволяют сливать скрытый код; у флагов есть стоимость владения, их удаляют после выпуска, а тестируют как ожидаемую прод-конфигурацию, так и выключенное состояние {факт} [S33].
- **Уровень.** Процесс и архитектура.
- **Параллельность.** Сильное.
- **Время тестов.** Слабое отрицательное: больше комбинаций.
- **Лимиты и лишняя работа.** Слабое.
- **Цена внедрения.** Низкая.
- **Риски.** Накопление мёртвых флагов.
- **Когда не применять.** Фича целиком помещается в одну малую задачу.
- **Инструменты.** Любая система флагов; таймер удаления.
- **Доказанность.** Мнение практиков {мнение} [S33].

#### C5. Стекированные изменения

- **Проблема.** Зависимые изменения ждут ревью предыдущих.
- **Как работает.** Цепочка малых зависимых PR, каждый ревьюится и сливается отдельно; разработка продолжается поверх ещё не принятых изменений {мнение} [S88].
- **Уровень.** Процесс.
- **Параллельность.** Среднее.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Слабое.
- **Цена внедрения.** Низкая с инструментом.
- **Риски.** Перебазирование цепочки при правке нижнего PR.
- **Когда не применять.** Независимые задачи в разных зонах — их лучше вести параллельно, а не стеком.
- **Инструменты.** Graphite и аналоги.
- **Доказанность.** Вендор и практики {вендор} [S88].

#### C6. Приёмка по доказательствам

- **Проблема.** Ревью человеком — последовательная часть цикла и главное узкое место (раздел 1.2).
- **Как работает.** Четыре ступени: агент показывает доказательства (вывод тестов, команду и результат, скриншот), потому что проверить доказательство быстрее, чем повторить проверку; хук остановки запрещает завершить работу до прохождения проверки; независимый субагент-ревьюер со свежим контекстом видит только дифф и критерии; ревьюеру велено сообщать лишь пробелы корректности, иначе погоня за замечаниями ведёт к переусложнению {вендор} [S5]. Человек смотрит по риску: контракты, миграции данных, безопасность, деньги и права доступа — всегда; внутренности зоны с зелёными тестами — выборочно {гипотеза}.
- **Уровень.** Процесс.
- **Параллельность.** Сильное: снимает последовательную часть.
- **Время тестов.** Нейтрально.
- **Лимиты и лишняя работа.** Среднее: ревьюер-субагент расходует лимит, но экономит часы человека.
- **Цена внедрения.** Низкая.
- **Риски.** Полный отказ от ревью: в 2026 году рост PR без ревью на 31,3 % сопровождался ростом отношения инцидентов к PR на 242,7 % {эмпирика} [S2].
- **Когда не применять.** Сквозные изменения прав доступа и данных — только с человеком.
- **Инструменты.** `/code-review`, субагенты, хуки Stop, `/goal` в Claude Code {факт} [S5].
- **Доказанность.** Рекомендации вендора {вендор} [S5]; корреляционные данные о рисках отказа от ревью {эмпирика} [S2].

#### C7. Одна точка интеграции

- **Проблема.** Несколько агентов одновременно сливают изменения и по-разному разрешают одни и те же конфликты.
- **Как работает.** Слияние выполняет один интегратор (человек или выделенный агент) по очереди; каждая ветка перед слиянием перебазируется на свежую основную ветку и проходит L1; конфликт возвращается агенту-владельцу зоны {гипотеза}.
- **Уровень.** Процесс.
- **Параллельность.** Среднее: сериализует только короткий шаг.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Среднее: нет двойного разрешения конфликтов.
- **Цена внедрения.** Низкая.
- **Риски.** Интегратор становится узким местом при десятках PR в день.
- **Когда не применять.** Один агент.
- **Инструменты.** Очередь слияния в хостинге репозитория.
- **Доказанность.** Частота конфликтов у PR агентов 27,67 % {эмпирика} [S49]; приём — {гипотеза}.

#### C8. Владение зонами, очередь задач и закон Конвея для агентов

- **Проблема.** Агенты делают одно и то же, бросают работу, лезут в чужие зоны.
- **Как работает.** У зоны один владелец-человек и не больше одной активной задачи агента; все задачи идут из одной очереди с WIP-лимитом, равным ёмкости приёмки; топология «оркестратор плюс изолированные исполнители», где один агент владеет планом и итогом, а исполнители работают изолированно {мнение} [S15]; в командах агентов каждый участник владеет своим набором файлов {вендор} [S10].
- **Уровень.** Организация и процесс.
- **Параллельность.** Сильное.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Сильное: меньше дублей и брошенных PR.
- **Цена внедрения.** Низкая.
- **Риски.** Владелец-человек в отпуске блокирует зону.
- **Когда не применять.** Не бывает при двух и более агентах.
- **Инструменты.** CODEOWNERS, трекер, общий список задач команд агентов.
- **Доказанность.** 23 % отклонённых PR агентов — дубликаты, 38 % брошены {эмпирика} [S51]; приём — {мнение}.

#### C9. Спецификация до кода в меру

- **Проблема.** Агент начинает писать до понимания задачи.
- **Как работает.** Для крупных фич агент интервьюирует человека и пишет SPEC.md, затем реализация идёт в новой сессии с чистым контекстом {вендор} [S5]; для мелких задач план пропускается {вендор} [S5]; полные SDD-конвейеры тяжелы для мелких задач {мнение} [S75].
- **Уровень.** Процесс.
- **Параллельность.** Среднее: спецификация задаёт контракты заранее.
- **Время тестов.** Среднее.
- **Лимиты и лишняя работа.** Сильное для крупных фич, отрицательное для мелких.
- **Цена внедрения.** Низкая.
- **Риски.** «Спецификационный театр»: много markdown, который никто не читает {мнение} [S75].
- **Когда не применять.** Задача описывается одним предложением.
- **Инструменты.** Режим плана Claude Code, Spec Kit, Kiro {факт} [S5, S76, S63].
- **Доказанность.** Рекомендации вендоров и мнение {вендор} [S5]; {мнение} [S75].

#### C10. Уборка энтропии

- **Проблема.** Код агентов дрейфует от принятых образцов, растёт дублирование.
- **Как работает.** Регулярные фоновые задачи сверяют код с «золотыми принципами» и открывают небольшие PR рефакторинга {вендор} [S44].
- **Уровень.** Процесс.
- **Параллельность.** Слабое.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Среднее в долгую: меньше путаницы для следующих сессий.
- **Цена внедрения.** Низкая.
- **Риски.** Шум мелких PR в очереди ревью.
- **Когда не применять.** Первые недели проекта.
- **Инструменты.** Задачи по расписанию агентов, линтеры.
- **Доказанность.** Рост дублирования кода {эмпирика} [S54]; приём — {вендор} [S44].

**Блок D. Контекст агентов и лимиты.**

#### D1. Короткие иерархические файлы правил

- **Проблема.** Длинный файл правил загружается в каждую сессию, тратит контекст, и правила в нём теряются.
- **Как работает.** Корневой CLAUDE.md или AGENTS.md короткий и служит оглавлением; в папках зон лежат свои файлы, и ближайший к редактируемому файлу побеждает {факт} [S34]; редко нужное выносится в skills, которые загружаются по требованию; Anthropic советует держать CLAUDE.md до ~200 строк {вендор} [S37] и для каждой строки спрашивать, приведёт ли её удаление к ошибкам {вендор} [S5]. В проекте OpenAI AGENTS.md — оглавление на ~100 строк со ссылками на структурированную папку docs {вендор} [S44].
- **Уровень.** Контекст агентов.
- **Параллельность.** Среднее: у каждой зоны свои правила.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Сильное.
- **Цена внедрения.** Низкая.
- **Риски.** Устаревшие правила; противоречия между уровнями.
- **Когда не применять.** Не бывает.
- **Инструменты.** CLAUDE.md, AGENTS.md, skills, `/context` для проверки загрузки {факт} [S5].
- **Доказанность.** Рекомендации вендоров {вендор} [S5, S37].

#### D2. Карта зон и паспорта зон как контекст

- **Проблема.** Агент тратит токены на поиск структуры, которую знает человек.
- **Как работает.** Короткая карта зон (список зон, назначение, зависимости, контракты) и паспорта зон подгружаются по мере надобности; Aider строит карту репозитория из ключевых символов, ранжированных по графу ссылок, в бюджете около 1000 токенов {факт} [S35]; Anthropic предлагает skill с обзором архитектуры вместо чтения многих файлов {вендор} [S37] и загрузку контекста «точно в срок» по лёгким идентификаторам {вендор} [S78].
- **Уровень.** Контекст агентов.
- **Параллельность.** Среднее.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Сильное.
- **Цена внедрения.** Низкая; карту можно генерировать скриптом из конфигурации контроля зависимостей {гипотеза}.
- **Риски.** Устаревание ручной карты.
- **Когда не применять.** Репозиторий из десятка файлов.
- **Инструменты.** Карта репозитория Aider, skills, генерация из import-linter или Nx.
- **Доказанность.** Практика инструментов {факт} [S35]; эффект — {гипотеза}.

#### D3. Размер зоны под окно контекста

- **Проблема.** Зона, которую нельзя прочитать целиком, заставляет агента работать по фрагментам и ошибаться на стыках внутри неё.
- **Как работает.** Зона дробится, пока её код и контракты соседей не помещаются в небольшую долю окна (ориентир: до ~20–30 % окна, {гипотеза}); качество моделей падает с ростом длины входа {эмпирика} [S13], поэтому запас важнее формального предела окна.
- **Уровень.** Архитектура и контекст.
- **Параллельность.** Среднее.
- **Время тестов.** Среднее: меньше тестов на зону.
- **Лимиты и лишняя работа.** Сильное.
- **Цена внедрения.** Средняя для существующих систем.
- **Риски.** Слишком мелкие зоны увеличивают число контрактов и стыков.
- **Когда не применять.** Когда дробление режет цельное решение, которое меняется вместе.
- **Инструменты.** Подсчёт токенов зоны скриптом.
- **Доказанность.** {гипотеза} на основе [S13, S5].

#### D4. Субагенты для шумной работы

- **Проблема.** Поиск по коду, прогоны тестов и чтение логов забивают основной контекст.
- **Как работает.** Субагент работает в своём окне и возвращает только сводку {факт} [S36]; сводки субагентов обычно 1000–2000 токенов {вендор} [S78]; для простых субагентов выбирают меньшую модель {вендор} [S37]. Субагенты расходуют те же лимиты, что и основная сессия {факт} [S36].
- **Уровень.** Контекст агентов.
- **Параллельность.** Среднее.
- **Время тестов.** Слабое.
- **Лимиты и лишняя работа.** Сильное для основного контекста; общий расход может вырасти.
- **Цена внедрения.** Низкая.
- **Риски.** Потеря деталей в сводке; параллельные субагенты с неявными решениями {мнение} [S48].
- **Когда не применять.** Исследование на пару файлов.
- **Инструменты.** Субагенты Explore и Plan, свои субагенты в `.claude/agents/` {факт} [S36].
- **Доказанность.** Документация {вендор} [S36, S37].

#### D5. Хуки, скрипты и генераторы вместо рассуждений

- **Проблема.** Модель тратит токены на механическую работу: чтение логов, шаблонный код, повторяющиеся проверки.
- **Как работает.** Хук фильтрует вывод тестов до строк с ошибками и сокращает контекст с десятков тысяч токенов до сотен {вендор} [S37]; генератор создаёт каркас нового среза или эндпоинта из контракта {гипотеза}; линтер сообщает агенту, как исправить нарушение {вендор} [S44]; CLI-инструменты экономнее по контексту, чем MCP-серверы {вендор} [S37]. Хуки детерминированы, а инструкции в CLAUDE.md лишь рекомендательны {вендор} [S5].
- **Уровень.** Контекст и инструменты.
- **Параллельность.** Слабое.
- **Время тестов.** Среднее.
- **Лимиты и лишняя работа.** Сильное.
- **Цена внедрения.** Низкая: скрипт может написать сам агент.
- **Риски.** Фильтр скрывает важный контекст ошибки.
- **Когда не применять.** Разовые задачи.
- **Инструменты.** Хуки Claude Code, скрипты, генераторы кода.
- **Доказанность.** Документация {вендор} [S37, S5].

#### D6. Выбор модели и уровня рассуждения

- **Проблема.** Флагманская модель с максимальным рассуждением тратит лимит на простые правки.
- **Как работает.** Средняя модель для большинства задач, флагман — для архитектурных решений и многошагового рассуждения, маленькая — для простых субагентов; уровень рассуждения снижается для простых задач {вендор} [S37]. У Codex число локальных сообщений за 5 часов различается по моделям на порядок (например, 5–45 против 350–3000 на плане Plus) {вендор} [S71].
- **Уровень.** Контекст и лимиты.
- **Параллельность.** Среднее: больше агентов в том же лимите.
- **Время тестов.** Нейтрально.
- **Лимиты и лишняя работа.** Сильное.
- **Цена внедрения.** Низкая.
- **Риски.** Слабая модель на сложной задаче порождает переделки дороже экономии.
- **Когда не применять.** Задачи на стыках и контракты — только сильная модель {гипотеза}.
- **Инструменты.** `/model`, `/effort`, поле `model` субагента {факт} [S37, S36].
- **Доказанность.** Рекомендации вендоров {вендор} [S37, S71].

#### D7. Гигиена сессий и кеш промптов

- **Проблема.** Длинные сессии пересылают всю историю с каждым запросом; после паузы кеш остывает.
- **Как работает.** `/clear` между несвязанными задачами; после двух неудачных исправлений — новая сессия с лучшей постановкой {вендор} [S5]; кеш живёт час на подписке и пять минут при оплате кредитами или по API {вендор} [S37]; чтение из кеша стоит 0,1 базовой цены входа у большинства моделей {факт} [S89]; смена определений инструментов инвалидирует весь кеш {факт} [S89]; компактизация сама является большим запросом, а `/clear` бесплатен {вендор} [S37].
- **Уровень.** Контекст и лимиты.
- **Параллельность.** Слабое.
- **Время тестов.** Нейтрально.
- **Лимиты и лишняя работа.** Сильное.
- **Цена внедрения.** Нулевая.
- **Риски.** Потеря полезного контекста при частой очистке; записывать выводы в файлы заметок {вендор} [S78].
- **Когда не применять.** Глубокая отладка одной сложной проблемы, где история ценна {вендор} [S5].
- **Инструменты.** `/clear`, `/compact`, `/rewind`, статистика кеша в `/usage` {факт} [S37].
- **Доказанность.** Документация {вендор} [S5, S37, S89].

#### D8. Бюджет параллелизма под лимиты подписок

- **Проблема.** Параллельные агенты быстро выбирают пятичасовое окно и недельный лимит.
- **Как работает.** Число одновременных агентов ограничивается меньшим из двух: ёмкостью приёмки и бюджетом лимита, делённым на средний расход задачи {гипотеза}. Параллельные сессии умножают расход токенов {вендор} [S58]; команды агентов расходуют примерно в 7 раз больше токенов в режиме плана {вендор} [S37]; у Max окно 5 часов плюс недельный лимит {факт} [S70]; у Codex локальные и облачные задачи делят один лимит {вендор} [S71].
- **Уровень.** Процесс и лимиты.
- **Параллельность.** Ограничивающее.
- **Время тестов.** Нейтрально.
- **Лимиты и лишняя работа.** Сильное.
- **Цена внедрения.** Нулевая.
- **Риски.** Упор в недельный лимит в середине недели.
- **Когда не применять.** Оплата по API без жёстких лимитов — тогда ограничение денежное.
- **Инструменты.** `/usage` с разбивкой по субагентам, skills и MCP {факт} [S37].
- **Доказанность.** Документация {вендор} [S37, S58, S70, S71].

### 4.3. Сводная матрица стратегий

| Код | Стратегия | Уровень | Параллельность | Время тестов | Лимиты и потери | Цена | Доказанность |
|---|---|---|---|---|---|---|---|
| A1 | Зоны по сокрытию решений, паспорт | архитектура | сильное | среднее | сильное | низкая | классика, гипотеза для агентов |
| A2 | Ограниченные контексты | архитектура | сильное | среднее | среднее | средняя | мнение |
| A3 | Модульный монолит + контроль зависимостей | архитектура, CI | сильное | среднее | сильное | низкая–средняя | вендорские кейсы |
| A4 | Порты и адаптеры | архитектура | среднее | сильное | среднее | средняя | мнение |
| A5 | Вертикальные срезы | архитектура | сильное | среднее | сильное | низкая | мнение |
| A6 | События как граница | архитектура | сильное | сильное | среднее | средняя | гипотеза |
| A7 | Контракт-первым + проверка совместимости | архитектура, CI | сильное | среднее | сильное | низкая | инструменты, гипотеза |
| A8 | Заглушки по контракту | тесты | сильное | сильное | среднее | низкая | инструменты |
| A9 | Expand → contract | процесс | сильное | среднее | слабое | низкая | мнение |
| A10 | Микросервисы, микрофронтенды | архитектура | сильное для команд | смешанное | смешанное | высокая | мнение |
| A11 | Без горячих общих файлов | архитектура | сильное | слабое | среднее | низкая | эмпирика о конфликтах |
| B1 | Набор тестов на зону | тесты | сильное | сильное | среднее | средняя | мнение |
| B2 | Контракты потребителя | тесты | сильное | сильное | среднее | средняя | мнение |
| B3 | Выбор тестов по изменениям | тесты | среднее | сильное | сильное | низкая–высокая | эмпирика (Meta) |
| B4 | Кеш сборки и тестов | тесты | среднее | сильное | слабое | средняя–высокая | документация |
| B5 | Изолированные окружения | тесты | сильное | среднее | среднее | средняя | вендор |
| B6 | Эталонные тесты | тесты | среднее | среднее | сильное | низкая | мнение |
| B7 | Нестабильные тесты | тесты | слабое | среднее | среднее | низкая | эмпирика |
| B8 | Статические проверки | тесты | слабое | сильное | среднее | низкая | мнение |
| B9 | Уровни прогона | тесты, процесс | среднее | сильное | среднее | низкая | гипотеза |
| C1 | Карточка задачи | процесс | сильное | среднее | сильное | низкая | вендор |
| C2 | Изоляция агентов | процесс | сильное | слабое | нейтрально | низкая | документация |
| C3 | Магистраль и малые партии | процесс | сильное | среднее | среднее | низкая | эмпирика DORA |
| C4 | Флаги функций | процесс | сильное | слабое | слабое | низкая | мнение |
| C5 | Стекированные изменения | процесс | среднее | слабое | слабое | низкая | вендор |
| C6 | Приёмка по доказательствам | процесс | сильное | нейтрально | среднее | низкая | вендор, эмпирика о рисках |
| C7 | Одна точка интеграции | процесс | среднее | слабое | среднее | низкая | гипотеза |
| C8 | Владение зонами, очередь, WIP | организация | сильное | слабое | сильное | низкая | эмпирика о дублях, мнение |
| C9 | Спецификация в меру | процесс | среднее | среднее | сильное для крупных | низкая | вендор, мнение |
| C10 | Уборка энтропии | процесс | слабое | слабое | среднее | низкая | вендор |
| D1 | Короткие файлы правил | контекст | среднее | слабое | сильное | низкая | вендор |
| D2 | Карта и паспорта зон | контекст | среднее | слабое | сильное | низкая | инструменты |
| D3 | Зона под окно | контекст | среднее | среднее | сильное | средняя | гипотеза |
| D4 | Субагенты для шума | контекст | среднее | слабое | сильное | низкая | вендор |
| D5 | Хуки и генераторы | контекст | слабое | среднее | сильное | низкая | вендор |
| D6 | Модель и рассуждение по задаче | лимиты | среднее | нейтрально | сильное | низкая | вендор |
| D7 | Гигиена сессий, кеш | лимиты | слабое | нейтрально | сильное | нулевая | вендор |
| D8 | Бюджет параллелизма | лимиты | ограничивающее | нейтрально | сильное | нулевая | вендор |

### 4.4. Разбор альтернатив

Для каждой альтернативы из таблицы 4.1 — когда она целесообразнее предмета, её плюсы и минусы относительно него.

**Однопоточная итеративная работа.** Целесообразнее для прототипов, небольших систем и глубокой отладки одной проблемы, где история контекста ценна {вендор} [S5]. Плюсы относительно предмета: нулевая цена входа, нет стыков и неявных решений между агентами {мнение} [S48]. Минусы: время проверки растёт с системой, параллельности нет, человек — единственный цикл проверки.

**Микросервисы.** Целесообразнее при требованиях независимого масштабирования, развёртывания или изоляции данных (как вынос хранилища данных платёжных карт и рендеринга витрин в Shopify) {вендор} [S18]. Плюсы: жёсткая изоляция процессов и данных, независимые конвейеры. Минусы: наценка распределённости {мнение} [S74], дорогие ошибки границ {мнение} [S73], сквозные изменения требуют нескольких репозиториев и сессий агента.

**Микрофронтенды.** Целесообразнее при нескольких фронтенд-командах с независимыми релизами {мнение} [S83]. Плюсы: независимое развёртывание частей интерфейса. Минусы: дублирование зависимостей, различие сред разработки и прода, операционная сложность {мнение} [S83]; для одного человека с агентами те же выгоды дают папки-срезы фронтенда с правилом границ {гипотеза}.

**SDD-конвейер как основной процесс.** Целесообразнее для крупных фич с неясными требованиями. Плюсы: формализация требований, Kiro сам выделяет независимые задачи и выполняет их волнами {факт} [S63]. Минусы: избыточен для мелких задач, markdown тяжело ревьюить, агенты не всегда следуют спецификации {мнение} [S75]; без контроля границ параллельные задачи по-прежнему правят общие файлы {гипотеза}.

**Оркестрация многих агентов поверх неразрезанного кода.** Целесообразнее для исследования, ревью и отладки с конкурирующими гипотезами {вендор} [S10]. Плюсы: быстрый старт, встроенный общий список задач. Минусы: команды агентов не изолируют участников по копиям и требуют ручного раздела файлов {вендор} [S10]; расход токенов кратно выше {вендор} [S37, S53]; отдельная категория отказов — рассогласование агентов {эмпирика} [S50].

**Предиктивный выбор тестов без изоляции.** Целесообразнее в большом существующем монорепозитории с огромной историей прогонов, где перестройка архитектуры невозможна {эмпирика} [S27]. Плюсы: не требует менять код. Минусы: не уменьшает конфликты, контекст агента и ревью; вендорские числа не проверены независимо {вендор} [S68].

**Облачные фоновые агенты по тикету.** Целесообразнее для потока рутинных изолированных задач: документация, тесты, мелкие баги {эмпирика} [S51]. Плюсы: не занимают машину, работают параллельно в своих контейнерах {факт} [S30, S59]. Минусы: без границ дают конфликты и дубли {эмпирика} [S4, S51]; у агента Copilot ограничение одним репозиторием, одним PR на задачу и 59 минутами {факт} [S60].

### Дерево решений

- Если домен ещё не понятен (прототип, поиск продукта) → однопоточная работа с одним агентом, без зон и контрактов; нарезку проводить после стабилизации 2–3 устойчивых подобластей
- Если задача по природе сквозная и однотипная (обновление библиотеки, переименование, миграция стиля) → веерная раздача правки по файлам (`/batch` или цикл `claude -p`), без зон
- Если нужна независимая эксплуатация частей (отдельное масштабирование, изоляция чувствительных данных, разные языки) → сервисы только для этих частей, остальное — модульный монолит
  - Если частей не больше двух-трёх и есть ресурсы на эксплуатацию → выделить только эти части в сервисы с контрактными тестами (B2), остальное — модульный монолит
  - Иначе → модульный монолит с событиями на месте будущих границ сервисов
- Если над кодом одновременно работают два и более агента или человека → зонная архитектура: зоны, контроль зависимостей (A3), изоляция агентов (C2)
  - Если полный прогон тестов короче ~5 минут → зоны, контроль зависимостей (A3), изоляция агентов (C2), полный прогон на каждой итерации
  - Если полный прогон дольше ~5 минут → зоны плюс выбор тестов по графу зон (B3) и уровни прогона (B9)
    - Если стек TypeScript-монорепозиторий → зоны + правило границ Nx + `nx affected` + удалённый кеш
    - Если стек Python или Django → зоны + import-linter или tach + pytest-testmon для локального цикла и выбор по графу зон в CI
    - Если стек Java или Spring → Spring Modulith (verify, тесты модулей, запуск только изменённых модулей)
    - Если система очень большая и многоязычная → Bazel с удалённым кешем
  - Если зоны общаются по HTTP или событиям → контракт-первым (A7) + заглушки (A8); контракты потребителя (B2) — только на межпроцессных границах
- Если узкое место — ревью человеком → приёмка по доказательствам (C6) + малые партии (C3) + WIP-лимит по ёмкости приёмки (C8)
- Если упор в лимиты подписки → блок D каталога, начиная с диагностики по `/usage`
  - Если сессии длинные и в `/usage` отмечены длинный контекст или промахи кеша → гигиена сессий (D7) и свежая сессия на задачу
  - Если много чтения кода до первой правки → паспорта и карта зон (D2), короткие файлы правил (D1)
  - Если много шумного вывода (тесты, логи) → хуки-фильтры и субагенты (D5, D4)
  - Иначе → выбор модели и уровня рассуждения по задаче (D6) и бюджет параллелизма (D8)
- Если частые поломки на стыках после слияния → контракт-первым (A7), контракты потребителя на межпроцессных границах (B2), устранение горячих общих файлов (A11), одна точка интеграции (C7)
- Иначе → зонная архитектура в минимальной форме: паспорта зон, правило границ в CI, тесты зоны, worktree на агента


## 5. Практическое применение {#practice}

### 5.1. Пошаговая методика нарезки новой системы на зоны

Методика авторская, собрана из классических критериев модульности и практик раздела 4 {гипотеза}. Каждый шаг заканчивается проверяемым артефактом.

1. **Выписать изменчивые решения и подобласти.** Список решений, которые вероятно изменятся (платёжный провайдер, тарифная модель, каналы уведомлений, правила доступа, формат отчётов), и подобластей со своим языком. Критерий Парнаса — начинать с трудных и вероятно меняющихся решений, а не с блок-схемы обработки {факт} [S8]. Артефакт: список на одну страницу.
2. **Черновые зоны.** Одна зона — одна подобласть или одно изменчивое решение; плюс ядро платформы (арендатор, пользователь, права, конфигурация, outbox событий) и пакет контрактов. Проверка зоны: у неё есть ответ «чего она не делает», она владеет своими таблицами, у неё 3–7 публичных операций или событий (ориентир, {гипотеза}). Артефакт: карта зон (раздел 6).
3. **Направления зависимостей.** Граф ацикличен; ядро ни от кого не зависит; функциональные зоны зависят от ядра и контрактов; обратные потоки идут событиями. Артефакт: конфигурация линтера границ (раздел 6).
4. **Владение данными.** Каждая таблица принадлежит одной зоне; чужие данные читаются через API или через проекцию, построенную по событиям; в многоарендной системе идентификатор арендатора входит в каждый контракт {гипотеза}.
5. **Контракты на каждом ребре графа.** Шаблон контракта раздела 6: машиночитаемая схема плюс гарантии, запреты, ошибки, версия, тестовые обязательства.
6. **Инвентаризация горячих файлов.** Корневые маршруты, список приложений, DI, таблица маршрутов фронтенда, переводы, миграции, lock-файл; каждый заменяется автообнаружением или файлом на зону (A11).
7. **Сквозные трассы.** 5–10 критических сценариев, проходящих через границы; каждая трасса — тест уровня L1 (если проходит через изменённую границу) или L3.
8. **Проверка размеров.** Код зоны плюс контракты соседей помещаются в небольшую долю окна агента (D3); у одного человека не больше 3–5 одновременно активных зон (ориентир, {гипотеза}).
9. **Механизация.** Линтер границ в CI, выбор тестов по графу зон, заглушки по контрактам, генератор нового среза, паспорта зон, таблица «что изменилось → что перепроверить».
10. **Пилот.** Две параллельные задачи в двух зонах; замер метрик раздела 8 до и после; коррекция границ, где задачи всё равно пересеклись по файлам.

### 5.2. Порядок внедрения в существующей системе

1. **Замерить базу**: время CI, долю PR с конфликтами, время до первого ревью, размер PR, долю переделок, расход лимита на слитый PR (раздел 8).
2. **Построить фактический граф импорта** инструментом (tach show, import-linter, граф Nx) и найти кластеры {факт} [S38, S20, S79].
3. **Объявить зоны** по кластерам и изменчивым решениям; включить линтер в режиме «не хуже»: текущие нарушения заморожены, новые запрещены. Shopify так удержал базовый слой без нарушений и зависимостей {вендор} [S72].
4. **Паспорта зон и вложенные AGENTS.md** в папках зон {факт} [S34].
5. **Эталонные тесты вокруг зон** до рефакторинга агентом: approval-тесты предназначены в том числе для унаследованного кода {факт} [S86].
6. **Выбор тестов и уровни прогона**: pytest-testmon или affected на графе, ночной полный прогон.
7. **Постепенный вынос горячих файлов** и перевод синхронных вызовов на события там, где зоны связаны по времени.
8. **Параллелить агентов сначала на исследовании и ревью**, затем на реализации в разных зонах; так рекомендует документация команд агентов Claude Code {вендор} [S10].

### 5.3. Сквозной пример: многоарендное веб-приложение

Все числа в этом подразделе — иллюстрация, а не измерения.

**Система (пример).** B2B-сервис заявок и счетов для малых компаний: арендаторы, пользователи и роли, каталог услуг, заявки, тарифы и счета с внешним платёжным провайдером, уведомления (почта, SMS, push) через воркер, ночные отчёты, вебхуки и импорт CSV, клиентский и административный интерфейсы. Стек примера: Django, Celery, Redis, PostgreSQL, React с TypeScript. Размер для иллюстрации — около 60 тыс. строк.

**Карта зон (пример).**

| Зона | Отвечает за | Чего не делает | Публичный API и события | Размер, иллюстрация |
|---|---|---|---|---|
| platform | арендатор, аутентификация, права, настройки, outbox, флаги | бизнес-логики | `current_tenant()`, `check_permission()`, публикация событий | 6 тыс. строк |
| identity | пользователи, роли, приглашения | биллинга и уведомлений | `/users`, событие `UserInvited.v1` | 4 тыс. |
| catalog | услуги и цены | заявок и счетов | `/catalog`, `PriceChanged.v1` | 4 тыс. |
| orders | жизненный цикл заявки | расчёта денег и отправки писем | `/orders`, `OrderPlaced.v1`, порт `BillingLimits` | 9 тыс. |
| billing | тарифы, счета, адаптер провайдера | решений о том, кого уведомлять | `/billing`, `InvoiceIssued.v1`, `PaymentFailed.v1` | 8 тыс. |
| notifications | шаблоны, каналы, доставка в воркере | решений, когда уведомлять | потребитель событий, `/notifications/preferences` | 6 тыс. |
| reporting | проекции и ночные агрегаты | записи в чужие таблицы | `/reports`, задачи по расписанию | 5 тыс. |
| integrations | вебхуки наружу, импорт CSV | бизнес-правил | `/integrations`, потребитель событий | 5 тыс. |
| web-shell | маршрутизация, вход, дизайн-система | логики функций | компоненты, хук сессии | 5 тыс. |
| web-features | папки функций UI по зонам | обращения к API в обход клиента | страницы, сгенерированный клиент API | 8 тыс. |
| contracts | OpenAPI, схемы событий, сгенерированные типы | кода логики | схемы и типы | 1 тыс. |

**Правила зависимостей (пример).** Серверные зоны независимы друг от друга и импортируют только `platform.api` и `contracts`; `reporting` получает данные только из событий; фронтенд-функции импортируют только `web-shell` и сгенерированный клиент. Проверяются import-linter или tach на сервере и правилом границ Nx или ESLint на фронтенде (конфигурации в разделе 6).

**Фича (пример).** «Тарифы с лимитом заявок, автоматическим счётом и письмом об оплате». Затрагивает billing, orders, notifications и страницу биллинга во фронтенде.

| Шаг | Кто | Длительность, иллюстрация | Артефакт |
|---|---|---|---|
| 1. Контракты | человек + один агент | 1,5 ч | `billing.openapi.yaml` v1.3 (`/billing/plans`, `/billing/usage`), `InvoiceIssued.v1`, `OrderLimitExceeded.v1`, запись решения |
| 2. Заглушки | агент | 15 мин | мок-сервер по OpenAPI, фейк-адаптер `BillingLimits`, фикстуры событий |
| 3. Четыре задачи параллельно | 4 агента в своих worktree | 2–3 ч каждая | PR billing, PR orders (против фейка), PR notifications (по фикстурам), PR фронтенда (против мок-сервера) |
| 4. Приёмка каждого PR | субагент-ревьюер + человек | ~15 мин человека на PR | доказательства: вывод L0 и L1, скриншот страницы, дифф контракта пуст |
| 5. Интеграция | интегратор | 30 мин | слияние по очереди, L1 после каждого слияния, трассы T3 и T5 |
| 6. Ночной прогон | CI | 22 мин | полный набор и сквозные тесты |

**Сравнение циклов (иллюстрация).**

| Показатель | Однопоточно, полный прогон | Зонно, параллельно |
|---|---|---|
| Прогон на итерацию | 22 мин полного набора | L0 20–90 с в сессии, L1 5–7 мин на PR |
| Число полных прогонов за фичу | 6–8 | 1 ночной |
| Ревью | один PR ~1600 строк, 90+ мин | четыре PR по 300–450 строк, ~15 мин каждый |
| Календарное время фичи | 2–3 дня | 1 день |
| Параллельных сессий | 1 | 4 (окно подписки выбирается быстрее, см. D8) |

Выигрыш в примере создаёт не число агентов, а три вещи: контракты и заглушки до начала работы, короткий цикл L0 внутри зоны и малые PR с доказательствами {гипотеза}.

**Вариант для команды из 10 человек (пример).** Три продуктовых разработчика владеют по 2–3 зоны, у каждого 2–3 агента; один инженер платформы владеет `platform`, `contracts`, CI и линтерами; изменения контрактов проходят еженедельное короткое согласование и записываются решениями; очередь слияния одна; WIP — не больше одной активной задачи агента на зону.

### 5.4. Сопоставление с подходом пользователя

Подход пользователя: ящики с границами «чего блок не делает» → контракты между ящиками «как чёрными ящиками» по семи вопросам (кто отправляет, кто принимает, событие, что передаётся, гарантии, запреты, гейт) → сквозные трассы → детализация ящик за ящиком; изменение контракта оформляется решением с версией.

**Где совпадает с практикой.**

| Элемент подхода | Соответствие в практике |
|---|---|
| Ящики с «чего не делает» | Сокрытие решений Парнаса [S8], ограниченные контексты [S17], указание того, что вне рамок, в спецификации для агента [S5] {факт} |
| Контракт «как чёрный ящик» | Контракты поставщика и потребителя [S43], предусловия, постусловия и инварианты Design by Contract [S90], производители и потребители AsyncAPI [S77] {факт} |
| Гарантии и запреты | Постусловия и предусловия [S90]; гарантии доставки и идемпотентности для событий {факт} |
| Сквозные трассы | Малое число сквозных тестов на критические сценарии [S23], сценарные тесты модулей [S39] {мнение} |
| Решение с версией | ADR со статусами и заменой [S81], expand → contract [S42] {факт} |
| Детализация по одному ящику | Одна задача — одна зона (C1) |

**Где отстаёт и чего не хватает** {гипотеза}:

1. **Машиночитаемость.** Семь вопросов в прозе не проверяются CI; к каждому контракту нужна схема (OpenAPI, AsyncAPI, JSON Schema) и автоматическое сравнение версий, для которого есть готовые инструменты {факт} [S40, S41].
2. **Исполняемость.** Нет контрактных тестов и заглушек, которые позволяют начинать ящики одновременно; оба вида инструментов существуют {факт} [S26, S80].
3. **Контроль границ в коде.** «Чего ящик не делает» записано, но не запрещено линтером импорта, хотя такие линтеры есть {факт} [S20, S38].
4. **Правила совместимости.** Не определено, что считается несовместимым изменением и как долго живёт старая версия; в практике для этого есть Tolerant Reader и expand → contract {факт} [S43, S42].
5. **Ошибки и отказ.** Среди семи вопросов нет семантики ошибок, повторов, таймаутов, идемпотентности, порядка, объёмов.
6. **Арендатор и права.** Для многоарендной системы — контекст арендатора и проверка прав на границе.
7. **Владение данными.** Кому принадлежат таблицы и кто пишет миграции.
8. **Тестовые обязательства.** Какие тесты есть у поставщика, у потребителя и какая трасса покрывает контракт.
9. **Контекст для агента.** Паспорт ящика в папке кода (вложенный AGENTS.md) и размер ящика относительно окна.
10. **Параллельность детализации.** «Детализация по одному» последовательна; при контрактах со схемами и заглушками ящики детализируются параллельно разными агентами.
11. **Гейт.** Один гейт стоит заменить уровнями L0–L3 и указанием, кто принимает (тест, агент-ревьюер, человек).
12. **Таблица перепроверки.** Из графа ящиков и контрактов выводится таблица «что изменилось → что перепроверить» (раздел 6).

Итог сопоставления: подход пользователя совпадает с классикой по смыслу границ и контрактов, но остаётся документным; главный недостающий слой — механизация (схемы, линтеры, контрактные тесты, заглушки, выбор тестов по графу), которая и превращает границы в скорость {гипотеза}. Расширенный шаблон контракта — в разделе 6.

### 5.5. Типичные ошибки первого применения

- **Зоны по техническим слоям** (backend, frontend, база) вместо предметных: каждая фича трогает все зоны, параллельности нет.
- **Слишком мелкие зоны:** контрактов больше, чем логики; каждая задача меняет контракт.
- **Общая модель данных:** все зоны читают все таблицы, скрытая связность ломает изоляцию тестов.
- **Контракты только в прозе:** расхождения обнаруживаются при интеграции.
- **Пять агентов до готовности приёмки:** очередь ревью растёт, PR бросаются; 38 % отклонённых PR агентов брошены без участия ревьюера {эмпирика} [S51].
- **Параллельные агенты в одном окружении:** общие порты и БД дают нестабильные тесты.
- **Одна длинная сессия на фичу:** контекст деградирует, лимит расходуется на пересылку истории {вендор} [S37].
- **Полный прогон в каждой сессии агента:** лимит и время уходят на вывод тестов.
- **Ставка на команды агентов вместо нарезки:** команды не изолируют участников по копиям {вендор} [S10].
- **Отказ от ревью человеком совсем** {эмпирика} [S2].

### 5.6. Что происходит через месяцы

- **Эрозия границ без механизации.** Shopify за годы убрал проверки приватности как неработающие и сместился к упаковке по фактическому исполнению; удержание базового слоя без нарушений сработало {вендор} [S72].
- **Энтропия кода агентов.** Дрейф от образцов и рост дублирования требуют регулярной уборки {вендор} [S44]; в отрасли доля копипасты росла, а доля рефакторинга падала {эмпирика} [S54].
- **Рост оттока кода и инцидентов** при высоком внедрении ИИ без изменения процесса {эмпирика} [S2].
- **Накопление нестабильных тестов и версий контрактов:** нужен владелец карантина и график удаления старых версий.

### 5.7. Стоимость входа

| Статья | Один человек, новая система | Команда до 10, существующая система |
|---|---|---|
| Время на нарезку и контракты | 1–3 дня (иллюстрация) | 2–6 недель постепенного внедрения (иллюстрация) |
| Настройка CI, линтеров, выбора тестов | 0,5–2 дня (иллюстрация) | 1–2 недели инженера платформы (иллюстрация) |
| Подписки на 2026-09-27 | Claude Pro $20, Max 5x $100 в месяц [S91]; Codex Plus $20, Pro от $100 [S71] {факт} | Claude Team $25 или $125 за место [S91], Codex Business $20–25 за пользователя [S71] {факт} |
| Компетенции | предметное моделирование, дизайн тестов, базовый CI | то же плюс владение платформой и контрактами |

## 6. Артефакты {#artifacts}

Шаблоны ниже авторские, собраны из практик разделов 4 и 5 {гипотеза}; примеры относятся к иллюстративной системе раздела 5.3.

### 6.1. Карта зон

- **Назначение.** Единый список зон, их ответственности, зависимостей и контрактов; первый файл, который читает агент или новый участник.
- **Структура.** Таблица: зона, отвечает за, не делает, владелец, разрешённые зависимости, публикует, потребляет, путь к паспорту.
- **Жизненный цикл.** Создаёт архитектор или владелец платформы на шаге 2 методики; меняется только вместе с конфигурацией линтера границ; устаревает, если карту правят руками без линтера — поэтому раздел зависимостей лучше генерировать из конфигурации {гипотеза}.
- **Пример.**

```markdown
| Зона | Отвечает за | Не делает | Владелец | Зависит от | Публикует | Потребляет |
|---|---|---|---|---|---|---|
| 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; проверка — на ревью по доказательствам.
- **Пример.**

```markdown
Зона: 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].
- **Пример.**

```markdown
Контракт: InvoiceIssued v1
1 Отправитель: billing   2 Получатели: notifications, reporting, integrations
3 Событие: InvoiceIssued (асинхронно, через outbox → Redis/Celery)
4 Данные: contracts/events/billing/invoice_issued.v1.json
  {tenant_id, invoice_id, customer_user_id, amount_minor, currency, due_date, issued_at}
5 Гарантии: доставка ≥1 раза; ключ идемпотентности invoice_id; порядок не гарантирован;
  публикуется после фиксации транзакции
6 Запреты: потребители не читают billing_*; не опираются на порядок событий
7 Гейт: schema-diff без несовместимых изменений; тесты потребителей на фикстурах v1;
  трасса T5 на L1 при изменении схемы; принимает владелец billing
8 Ошибки: при сбое обработчика — повтор с экспоненциальной задержкой, после 5 — dead letter
9 Арендатор: tenant_id обязателен; права потребителя не проверяются (внутреннее событие)
10 Версия: v1; новые поля только необязательные; v1 живёт ≥30 дней после выхода v2
11 Тесты: billing — публикация по сценарию; notifications — обработчик по фикстуре, повтор идемпотентен
12 Владелец: Анна; решения: docs/decisions/0012-invoice-issued.md
```

### 6.4. Правила контракта для параллельной разработки агентами

1. Контракт сливается в основную ветку до начала реализации обеих сторон; без слитого контракта задачи реализации не выдаются.
2. Источник истины — схема; проза не противоречит схеме, генерируемые типы не редактируются руками.
3. Агент реализации не меняет контракт в том же PR; нужна правка — агент останавливается и описывает её в отчёте.
4. По умолчанию только совместимые изменения; несовместимое — новая версия рядом со старой, запись решения, срок удаления старой {факт} [S42, S81].
5. Потребитель читает терпимо: игнорирует незнакомые поля {факт} [S43].
6. Из контракта генерируется заглушка; потребитель разрабатывается против неё, поставщик проверяется контрактными тестами {факт} [S80, S26].
7. Контракт называет ошибки, повторы, идемпотентность, порядок и арендатора; без этих полей контракт не считается готовым.
8. У каждого контракта есть трасса и тестовые обязательства обеих сторон.
9. Изменение схемы автоматически запускает перепроверку по таблице 6.8.
10. Общих изменяемых структур вне контрактов нет: ни общих таблиц, ни глобальных объектов состояния.

### 6.5. Запись решения об изменении контракта

- **Назначение.** Сохранить причину изменения и версию, чтобы следующие сессии агентов не откатывали решение по незнанию.
- **Структура.** По Nygard: заголовок, контекст, решение, статус (предложено, принято, устарело, заменено), последствия {факт} [S81]; плюс версия контракта, затронутые зоны, срок удаления старой версии.
- **Жизненный цикл.** Создаётся в задаче изменения контракта; при замене получает статус «заменено» со ссылкой на новое.
- **Пример.** `0012 — InvoiceIssued v1: сумма в минорных единицах. Контекст: округления в notifications. Решение: amount_minor:int, currency:str. Статус: принято. Последствия: notifications и reporting переходят на v1 до 2026-10-31; v0 удаляется после миграции.`

### 6.6. Конфигурация контроля зависимостей

- **Назначение.** Превратить «чего зона не делает» в правило, которое проверяет CI и объясняет агенту.
- **Жизненный цикл.** Создаётся на шаге 3 методики; новые нарушения блокируют PR; старые заморожены списком и убывают.
- **Пример для Python.** import-linter поддерживает контракты forbidden, protected, layers, independence и acyclic siblings {факт} [S20].

```toml
[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].

```json
"@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].
- **Пример.**

```markdown
Проект: сервис заявок и счетов.
Карта зон: docs/zones.md. Перед работой прочитай паспорт своей зоны: app/<zone>/AGENTS.md.
Границы:
- Работай только в зоне из карточки задачи. Чужие зоны — только через contracts/ и app/platform/api.
- Не меняй contracts/ в задаче реализации. Нужна правка контракта — остановись и опиши её.
- Маршруты, миграции, переводы — только в папке своей зоны.
Проверка:
- L0 до завершения: make check ZONE=<zone>. Полный набор тестов не запускай.
- В отчёте: вывод make check, список изменённых файлов, скриншот для UI.
```

### 6.10. Карточка задачи для агента

- **Назначение.** Самодостаточная постановка, по которой агент работает без уточнений.
- **Поля.** Цель; зона; разрешённые пути; контракты (ссылки и версии); чего не делать; критерии приёмки как команды или тесты; трассы; размер; модель и уровень рассуждения; формат отчёта.
- **Жизненный цикл.** Создаётся из очереди задач владельцем зоны или оркестратором; закрывается вместе с PR; переделка оформляется новой карточкой с уточнённой постановкой.
- **Пример.**

```markdown
Задача 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. С чем используется в связке {#combo}

### 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].

## 8. Метрики здоровья и антипаттерны {#health}

Метрики сгруппированы по трём целям пользователя: скорость, расход лимитов, лишняя работа. Там, где источник не даёт нормы, значение помечено как ориентир.

| Признак | Здоровая норма | Симптом деградации | Источник |
|---|---|---|---|
| Доля задач, затрагивающих одну зону | ориентир: ≥ 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. Инструменты и софт {#tools}

### 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 {гипотеза}.

## 10. Адаптация под LLM и агентов {#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].

**Правило бюджета (авторская модель, {гипотеза}).**

```text
Агентов одновременно ≤ 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. Происхождение, ключевые фигуры, что читать {#origins}

### 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. Открытые вопросы и границы уверенности {#open-questions}

### 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`: все обязательные разделы заполнены, ограничения перечислены выше.

## 13. Реестр источников {#sources}

| ID | Название | Автор или издатель | URL | Дата публикации | Дата доступа | Доступ | Что подтверждает |
|---|---|---|---|---|---|---|---|
| S1 | The AI Productivity Paradox Research Report | Faros AI | https://www.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 | https://www.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 | https://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 | https://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 | https://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 | https://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 | https://metr.org/blog/2025-07-10-early-2025-ai-experienced-os-dev-study/ | 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 | https://blog.acolyer.org/2016/09/05/on-the-criteria-to-be-used-in-decomposing-systems-into-modules/ | 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 | https://softengbook.org/articles/deep-modules | без даты | 2026-09-27 | полный текст | разделы 1, 11, 12: глубокие модули Остерхаута, пример файлового ввода-вывода Unix |
| S10 | Orchestrate teams of Claude Code sessions | Anthropic | https://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 | https://nx.dev/docs/features/ci-features/affected | без даты | 2026-09-27 | полный текст | разделы 1, 3, 4, 6, 7, 8, 9: граф проектов, affected, удалённый кеш, lock-файл делает затронутым всё |
| S12 | Hermeticity | Bazel | https://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) | https://www.trychroma.com/research/context-rot | 2025-07-14 | 2026-09-27 | полный текст | разделы 1, 2, 4: 18 моделей, деградация с ростом длины входа, отвлекающие фрагменты |
| S14 | How Do Committees Invent? | Melvin E. Conway | https://www.melconway.com/Home/Committees_Paper.html | 1968-04 | 2026-09-27 | полный текст | разделы 1, 11: формулировка закона Конвея |
| S15 | Conway's Law Comes for Your Agent Fleet | Tian Pan | https://tianpan.co/blog/2026/06/30/conways-law-comes-for-your-agent-fleet | 2026-06-30 | 2026-09-27 | полный текст | разделы 1, 4, 10: закон Конвея для агентов, оркестратор с изолированными исполнителями (мнение) |
| S16 | Team Topologies | Martin Fowler | https://martinfowler.com/bliki/TeamTopologies.html | 2023-07-25 | 2026-09-27 | полный текст | разделы 1, 7, 11, 12: когнитивная нагрузка, платформенные команды, связь с законом Конвея |
| S17 | BoundedContext | Martin Fowler | https://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 | https://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) | https://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) | https://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 | https://alistair.cockburn.us/hexagonal-architecture/ | 2005-09-04 | 2026-09-27 | полный текст | разделы 1, 3, 4, 11: порты и адаптеры, запуск без UI и БД для тестов |
| S22 | Vertical Slice Architecture | Jimmy Bogard | https://www.jimmybogard.com/vertical-slice-architecture/ | 2018-04-19 | 2026-09-27 | полный текст | разделы 1, 4, 11: минимум связности между срезами, максимум внутри |
| S23 | The Practical Test Pyramid | Ham Vocke, martinfowler.com | https://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 | https://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 | https://kentcdodds.com/blog/the-testing-trophy-and-testing-classifications | 2021-06-03 | 2026-09-27 | полный текст | разделы 1, 4: статика, unit, integration, e2e; «mostly integration» |
| S26 | Pact Docs: Introduction | Pact Foundation | https://docs.pact.io/ | без даты | 2026-09-27 | полный текст | разделы 1, 4, 5, 6, 7, 9: контракты, задаваемые потребителем, проверка поставщика, ограниченность проверки по схеме |
| S27 | Predictive Test Selection | Meta Engineering | https://engineering.fb.com/2018/11/21/developer-tools/predictive-test-selection/ | 2018-11-21 | 2026-09-27 | полный текст | разделы 1, 2, 4, 8, 9, 11: >99,9 % регрессий при ~⅓ тестов, избыточность выбора по зависимостям |
| S28 | pytest-testmon | testmon.org | https://testmon.org/ | без даты | 2026-09-27 | полный текст | разделы 1, 3, 4, 7, 9: выбор тестов по покрытию, что не отслеживается |
| S29 | Run parallel sessions with worktrees | Anthropic | https://code.claude.com/docs/en/worktrees | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 7, 9, 10: --worktree, .worktreeinclude, что общее с основной копией, версии поведения |
| S30 | Codex cloud | OpenAI | https://learn.chatgpt.com/docs/cloud | без даты | 2026-09-27 | фрагмент | разделы 1, 2, 4, 9, 10, 11: изолированные облачные окружения, параллельные задачи, PR, интеграции |
| S31 | Trunk-based development (DORA capability) | DORA | https://dora.dev/capabilities/trunk-based-development/ | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 7, 8, 11: ≤3 активных ветки, слияние минимум раз в день, тяжёлое ревью как ловушка |
| S32 | Working in small batches (DORA capability) | DORA | https://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 | https://martinfowler.com/articles/feature-toggles.html | 2017-10-09 | 2026-09-27 | полный текст | разделы 1, 4, 6, 7: виды флагов, стоимость владения, тестирование комбинаций |
| S34 | AGENTS.md | Agentic AI Foundation (Linux Foundation) | https://agents.md/ | без даты | 2026-09-27 | полный текст | разделы 1, 2, 4, 5, 6, 9, 10, 11: формат, вложенные файлы, 60 тыс.+ проектов |
| S35 | Repository map | Aider | https://aider.chat/docs/repomap.html | без даты | 2026-09-27 | полный текст | разделы 1, 4, 9, 10: карта репозитория, ранжирование по графу ссылок, бюджет 1000 токенов |
| S36 | Subagents (Claude Code docs) | Anthropic | https://code.claude.com/docs/en/sub-agents | без даты | 2026-09-27 | полный текст | разделы 1, 4, 9, 10: собственное окно контекста, модель на субагента, isolation: worktree, общие лимиты, форки |
| S37 | Manage costs effectively (Claude Code) | Anthropic | https://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) | https://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) | https://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 | https://buf.build/docs/breaking/ | без даты | 2026-09-27 | полный текст | разделы 1, 4, 5, 9: категории FILE, PACKAGE, WIRE_JSON, WIRE; проверка в CI |
| S41 | oasdiff | oasdiff (GitHub) | https://github.com/oasdiff/oasdiff | без даты | 2026-09-27 | полный текст | разделы 1, 4, 5, 7, 9, 10: поиск несовместимых изменений OpenAPI, GitHub Action |
| S42 | ParallelChange | Danilo Sato, martinfowler.com | https://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 | https://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 | https://businessdatasolutions.github.io/ai-wiki/sources/2026-02-11-lopopolo-codex-harness-engineering | 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 | https://xiaow.dev/claude_notes/2026-03-25---Article---OpenAI-Harness-Engineering---Leveraging-Codex-in-an-Agent-First-World | 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 | https://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 | https://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 | https://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 | https://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) | https://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 и др. | https://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 и др. | https://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 | https://www.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 | https://www.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 | https://arxiv.org/abs/2402.13521 | 2024-02-21 | 2026-09-27 | аннотация | разделы 1, 2: тесты в промпте повышают долю решённых задач (MBPP, HumanEval) |
| S56 | Announcing the 2025 DORA Report | Google Cloud | https://cloud.google.com/blog/products/ai-machine-learning/announcing-the-2025-dora-report | 2025-09-24 | 2026-09-27 | полный текст | разделы 2, 11, 12: ~5000 респондентов, 90 % используют ИИ, 30 % не доверяют, связь со стабильностью |
| S57 | We are Changing our Developer Productivity Experiment Design | METR | https://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 | https://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) | https://cursor.com/docs/cloud-agent | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9, 10: изолированные ВМ, environment.json, оплата по тарифам API |
| S60 | About GitHub Copilot coding agent | GitHub Docs | https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9, 10: среда GitHub Actions, один репозиторий, один PR на задачу, лимит 59 минут |
| S61 | Jules docs | Google | https://jules.google/docs | без даты | 2026-09-27 | фрагмент | разделы 2, 9: асинхронный агент в облачной ВМ, утверждение плана |
| S62 | When to use Devin | Cognition | https://docs.devin.ai/essential-guidelines/when-to-use-devin | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9: задачи до ~3 часов, явные критерии успеха, параллельные сессии |
| S63 | Specs (Kiro docs) | Kiro (AWS) | https://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) | https://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) | https://www.microsoft.com/en-us/research/publication/the-effects-of-generative-ai-on-high-skilled-work-evidence-from-three-field-experiments-with-software-developers/ | 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 | https://www.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 | https://openai.com/index/harness-engineering/ | 2026-02-11 | 2026-09-27 | недоступен | разделы 2, 12: оригинал вернул 403; содержание взято из конспектов S44, S45 |
| S68 | CloudBees Smart Tests | CloudBees | https://www.cloudbees.com/capabilities/cloudbees-smart-tests | без даты | 2026-09-27 | полный текст | разделы 2, 4, 12: «до 80 %» сокращения времени тестов (вендор), бывший Launchable |
| S69 | Task-Completion Time Horizons of Frontier AI Models | METR | https://metr.org/time-horizons/ | 2026-05-08 | 2026-09-27 | полный текст | разделы 2, 11: определение 50 %-горизонта, оговорки о чётко заданных задачах |
| S70 | What is the Max plan? | Anthropic Help Center | https://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 | https://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 | https://shopify.engineering/a-packwerk-retrospective | 2024-02-07 | 2026-09-27 | полный текст | разделы 2–5, 7, 8, 11: отказ от проверок приватности, семантическая группировка против фактического исполнения, удержание базового слоя |
| S73 | MonolithFirst | Martin Fowler | https://martinfowler.com/bliki/MonolithFirst.html | 2015-06-03 | 2026-09-27 | полный текст | разделы 2, 3, 4, 11: успешные микросервисы начинались с монолита, риск неверных границ |
| S74 | MicroservicePremium | Martin Fowler | https://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 | https://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 | https://github.com/github/spec-kit | без даты | 2026-09-27 | полный текст | разделы 2, 4, 9, 10, 11: команды constitution/specify/plan/tasks/implement, маркер [P] |
| S77 | AsyncAPI Concepts | AsyncAPI Initiative | https://www.asyncapi.com/docs/concepts | без даты | 2026-09-27 | фрагмент | разделы 3, 4, 5, 9: каналы, сообщения, производители и потребители событий |
| S78 | Effective context engineering for AI agents | Anthropic Engineering | https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents | 2025-09-29 | 2026-09-27 | полный текст | разделы 3, 4, 10, 11: context rot, контекст «точно в срок», компактизация, заметки, сводки субагентов 1–2 тыс. токенов |
| S79 | Enforce Module Boundaries | Nx | https://nx.dev/docs/features/enforce-module-boundaries | без даты | 2026-09-27 | полный текст | разделы 3, 4, 5, 6, 9: теги scope/type, depConstraints, правило линтера |
| S80 | Prism Overview | Stoplight | https://docs.stoplight.io/docs/prism/674b27b261c3c-prism-overview | без даты | 2026-09-27 | фрагмент | разделы 3, 4, 5, 6, 9: мок-сервер из OpenAPI, прокси-валидация |
| S81 | Documenting Architecture Decisions | Michael Nygard, Cognitect | https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions | 2011-11-15 | 2026-09-27 | полный текст | разделы 4, 5, 6, 7, 11: ADR, статусы, superseded |
| S82 | Microservices | James Lewis, Martin Fowler | https://martinfowler.com/articles/microservices.html | 2014-03-25 | 2026-09-27 | полный текст | разделы 4, 11: девять характеристик микросервисов, связь с законом Конвея |
| S83 | Micro Frontends | Cam Jackson, martinfowler.com | https://martinfowler.com/articles/micro-frontends.html | 2019-06-19 | 2026-09-27 | полный текст | раздел 4: выгоды и цена микрофронтендов |
| S84 | Testcontainers: Getting Started | Testcontainers (Docker) | https://testcontainers.com/getting-started/ | без даты | 2026-09-27 | полный текст | разделы 4, 7, 9: одноразовые контейнеры, случайные порты, параллельные прогоны |
| S85 | Predictive Test Selection (CloudBees Smart Tests docs) | CloudBees | https://docs.cloudbees.com/docs/cloudbees-smart-tests/latest/features/predictive-test-selection | без даты | 2026-09-27 | полный текст | разделы 4, 9: выбор тестов по связи изменённых файлов и тестов, нужна история прогонов |
| S86 | ApprovalTests | ApprovalTests | https://approvaltests.com/ | без даты | 2026-09-27 | полный текст | разделы 4, 5, 9: эталонные тесты received/approved, применимость к унаследованному коду |
| S87 | Flaky Tests at Google and How We Mitigate Them | Google Testing Blog | https://testing.googleblog.com/2016/05/flaky-tests-at-google-and-how-we.html | 2016-05-27 | 2026-09-27 | фрагмент | разделы 4, 12: карантин и повторные запуски нестабильных тестов (тело поста не загрузилось) |
| S88 | Stacked diffs | Graphite | https://graphite.com/guides/stacked-diffs | без даты | 2026-09-27 | полный текст | разделы 4, 9: стекированные изменения, работа без ожидания ревью |
| S89 | Prompt caching | Anthropic (Claude Platform docs) | https://platform.claude.com/docs/en/build-with-claude/prompt-caching | без даты | 2026-09-27 | полный текст | разделы 4, 7: множители записи и чтения кеша, порядок tools → system → messages, что инвалидирует кеш |
| S90 | Design by contract | Wikipedia | https://en.wikipedia.org/wiki/Design_by_contract | без даты | 2026-09-27 | полный текст | разделы 5, 11: предусловия, постусловия, инварианты (Meyer, 1986) |
| S91 | Plans & Pricing | Anthropic | https://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 | https://teamtopologies.com/key-concepts | без даты | 2026-09-27 | полный текст | разделы 7, 11, 12: типы команд, режимы взаимодействия, когнитивная нагрузка |
| S93 | DORA AI Capabilities Model (обзор в поиске и страница отчёта) | DORA, Google Cloud | https://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 | Google | https://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 | https://support.claude.com/en/articles/9797557-usage-limit-best-practices | без даты | 2026-09-27 | полный текст | разделы 10, 12: факторы расхода лимита |
| S96 | Information hiding | Wikipedia | https://en.wikipedia.org/wiki/Information_hiding | без даты | 2026-09-27 | полный текст | раздел 11: выходные данные статьи Парнаса (CACM 15(12), 1972) |

## 14. Словарь терминов {#glossary}

- **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, командами проверки и ловушками.
- **Сквозная трасса** (термин подхода пользователя): критический сценарий, проходящий через несколько зон и закреплённый тестом.
