# Приложение A. Мосты к первому тому

Прикладной том опирается на материал первого тома. Это приложение собирает в одном месте все мосты: какие части первого тома считаются предпосылкой, как наш диалект SDD соотносится со Spec Kit и Kiro, и как production-сценарии второго тома вырастают из учебного проекта AgentClinic.

Если что-то из перечисленного незнакомо — сначала пройдите соответствующую часть первого тома, иначе многие главы второго тома будут казаться нагромождением терминов.

Перед главой 1 прочитайте [часть 0](part-00-production-lab.md). Она переводит базовый AgentClinic в учебную production-модель и фиксирует минимальный маршрут: какие артефакты заполняются руками, какие примеры запускаются локально, а какие блоки относятся только к полному треку внедрения.

## Минимум, без которого второй том не читается

| Что нужно понимать | Где это введено в первом томе |
|---|---|
| Структура `mission.md`, `tech-stack.md`, `roadmap.md` | [Часть 6. Создание конституции](../book/part-06-constitution.md) |
| Формат `requirements.md`, `plan.md`, `validation.md` | [Часть 7. Спецификация фичи](../book/part-07-feature-specification.md) |
| Факты допуска к слиянию, EARS, Given/When/Then | [Часть 9. Проверка фичи: от спецификаций к фактам](../book/part-09-feature-validation.md) |
| Перепланирование и обновление дорожной карты | [Часть 10. Перепланирование проекта](../book/part-10-project-replanning.md) |
| Поддержка унаследованной кодовой базы и spec-археология | [Часть 13. Поддержка существующего проекта](../book/part-13-legacy-support.md) |
| Заменяемость агента, ссылки на ACP/AGENTS.md | [Часть 15. Заменяемость агента](../book/part-15-agent-replaceability.md) |
| Командное ревью и пакет доказательств | [Часть 16. Командная работа и ревью кода](../book/part-16-team-code-review.md) |
| Хуки Qwen Code, `PreToolUse` и `PostToolUse` | [Часть 17. Хуки Qwen Code](../book/part-17-qwen-code-hooks.md) |
| Антипаттерны SDD | [Часть 20. Антипаттерны SDD](../book/part-20-sdd-antipatterns.md) |
| Практический зачёт как проверка всего процесса | [Часть 22. Практический зачёт](../book/part-22-quiz-and-capstone.md) |

## Диалекты SDD: Spec Kit, Kiro, авторский диалект учебника

Прикладной том использует тот же авторский диалект, что и первый том. Подробное сравнение с GitHub Spec Kit и AWS Kiro дано в [Приложении A первого тома](../book/appendix-a-sdd-dialects.md): таблица соответствия артефактов, рекомендации по переносу процесса, ограничения каждого формата.

Если команда уже работает в Spec Kit или Kiro, читайте главы второго тома, мысленно переименовывая `requirements.md → /speckit.specify`, `plan.md → /speckit.plan + /speckit.tasks`, `validation.md → /speckit.analyze + проверочные списки`. Главы не привязаны к формату жёстко: их идеи переносятся между диалектами без потери смысла.

## Доменная карта AgentClinic

Production-сценарии второго тома мысленно разворачиваются на учебном проекте AgentClinic из первого тома. Полное описание сущностей домена — агенты-пациенты, недуги, терапии, записи на приём, отзывы, обратная связь — собрано в [Приложении B первого тома](../book/appendix-b-agentclinic-domain.md).

Второй том не требует, чтобы результат первого тома уже работал в настоящей production-инфраструктуре. Все внешние системы в главах — учебные источники событий и ограничений. Они нужны, чтобы показать, как тот же SDD-цикл ведёт себя при риске отката, эскалации, метрик и бюджета моделей.

Когда во втором томе встречаются production-сущности (`appointments-api`, `node_not_ready`, `appointment_latency`, `appointment_latency_spike`, `high_memory_usage`, `autoscale_200pct`, `cdn_error_budget_burn`, `rate_limit_breach`), они привязаны к AgentClinic так. Для зачётного маршрута используйте `high_memory_usage` как основной кейс; остальные строки помогают понять локальные runnable-примеры и не требуют отдельного пакета доказательств.

| Учебный код первого тома | Производный production-сценарий второго тома |
|---|---|
| Маршрут `GET /` (Hello Hono, часть 7) | `node_not_ready`: реплики не отвечают на проверку готовности (health-check) |
| Страница агентов на Hono JSX (часть 11) | `appointment_latency` / `appointment_latency_spike`: задержка маршрута `/agents` |
| SQLite + миграции отзывов (часть 12) | `high_memory_usage`: пик чтений после деплоя |
| Форма обратной связи (часть 12) | `rate_limit_breach`: поток одинаковых POST-запросов |
| MVP-фаза (часть 12) | `autoscale_200pct`: резкий рост нагрузки |
| Журнал агентов (часть 11) | `cdn_error_budget_burn`: расхождение метрик дашборда |
| Тон оператора клиники (часть 6) | теневые спецификации из неформальных сигналов |

В [README прикладного тома](README.md) дана короткая карта чтения и ссылка на это приложение. Полная доменная таблица живёт здесь, чтобы при чтении любой главы второго тома можно было быстро вспомнить, какому учебному коду соответствует production-симптом.

## Что добавил второй том сверху

| Слой | Где обсуждается во втором томе |
|---|---|
| Лабораторная рамка AgentClinic-production и минимальный маршрут | [Часть 0. Лаборатория AgentClinic-production](part-00-production-lab.md) |
| Восстановление спецификации из следов унаследованной системы | [Часть 1. Восстановление спецификаций из legacy](part-01-spec-archaeology.md) |
| Контролируемые дефекты в спецификации | [Часть 2. Диагностика дефектов спецификации](part-02-poisoned-specs.md) |
| Production-конституция с неизменяемым и изменяемым слоями | [Часть 3. Конституция проекта](part-03-project-constitution.md) |
| Состязательная валидация между ролями | [Часть 4. LLM-дуэль](part-04-llm-duel.md) |
| Мутационное тестирование спецификаций | [Часть 5. Мутационное тестирование спецификаций](part-05-stress-specs.md) |
| Формализация неявных эвристик | [Часть 6. Отбор теневых спецификаций](part-06-shadow-specs.md) |
| Шлюз спецификации как обязательный gate | [Часть 7. Specification CI](part-07-specification-ci.md) |
| Файловый арбитраж спорного изменения | [Часть 8. Файловый арбитраж спорного изменения](part-08-multiagent-tribunal.md) |
| Маршрутизация моделей и ярусные бюджеты | [Часть 9. Ярусные бюджеты](part-09-tier-budgeting.md) |
| Парные сторожевые метрики anti-Goodhart | [Часть 10. Защита метрик от Гудхарта](part-10-goodhart-metrics.md) |
| Интеграция с production API и авто-ремедиация | [Часть 11. Production API](part-11-real-api-deployment.md) |
| Диагностическая карта антипаттернов прикладного цикла | [Часть 12. Антипаттерны production SDD](part-12-production-antipatterns.md) |
| Итоговый production-зачёт и пакет доказательств | [Часть 13. Практический зачёт](part-13-capstone.md) |

Таблица выше и есть тот мост, который превращает абстрактный production-сценарий в продолжение учебного проекта. В отдельных главах второго тома (например, в части 12 — антипаттерны production SDD) ссылки на первый том также вынесены в подвал отдельным блоком; в остальных главах они вплетены в текст по месту обсуждения.