Приложение A. Мосты к первому тому
Прикладной том опирается на материал первого тома. Это приложение собирает в одном месте все мосты: какие части первого тома считаются предпосылкой, как наш диалект SDD соотносится со Spec Kit и Kiro, и как production-сценарии второго тома вырастают из учебного проекта AgentClinic.
Если что-то из перечисленного незнакомо — сначала пройдите соответствующую часть первого тома, иначе многие главы второго тома будут казаться нагромождением терминов.
Перед главой 1 прочитайте часть 0. Она переводит базовый AgentClinic в учебную production-модель и фиксирует минимальный маршрут: какие артефакты заполняются руками, какие примеры запускаются локально, а какие блоки относятся только к полному треку внедрения.
Минимум, без которого второй том не читается
| Что нужно понимать | Где это введено в первом томе |
|---|---|
Структура mission.md, tech-stack.md, roadmap.md | Часть 6. Создание конституции |
Формат requirements.md, plan.md, validation.md | Часть 7. Спецификация фичи |
| Факты допуска к слиянию, EARS, Given/When/Then | Часть 9. Проверка фичи: от спецификаций к фактам | | Перепланирование и обновление дорожной карты | Часть 10. Перепланирование проекта | | Поддержка унаследованной кодовой базы и spec-археология | Часть 13. Поддержка существующего проекта | | Заменяемость агента, ссылки на ACP/AGENTS.md | Часть 15. Заменяемость агента | | Командное ревью и пакет доказательств | Часть 16. Командная работа и ревью кода | | Хуки Qwen Code, PreToolUse и PostToolUse | Часть 17. Хуки Qwen Code | | Антипаттерны SDD | Часть 20. Антипаттерны SDD | | Практический зачёт как проверка всего процесса | Часть 22. Практический зачёт |
Диалекты SDD: Spec Kit, Kiro, авторский диалект учебника
Прикладной том использует тот же авторский диалект, что и первый том. Подробное сравнение с GitHub Spec Kit и AWS Kiro дано в Приложении A первого тома: таблица соответствия артефактов, рекомендации по переносу процесса, ограничения каждого формата.
Если команда уже работает в Spec Kit или Kiro, читайте главы второго тома, мысленно переименовывая requirements.md → /speckit.specify, plan.md → /speckit.plan + /speckit.tasks, validation.md → /speckit.analyze + проверочные списки. Главы не привязаны к формату жёстко: их идеи переносятся между диалектами без потери смысла.
Доменная карта AgentClinic
Production-сценарии второго тома мысленно разворачиваются на учебном проекте AgentClinic из первого тома. Полное описание сущностей домена — агенты-пациенты, недуги, терапии, записи на приём, отзывы, обратная связь — собрано в Приложении B первого тома.
Второй том не требует, чтобы результат первого тома уже работал в настоящей 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 прикладного тома дана короткая карта чтения и ссылка на это приложение. Полная доменная таблица живёт здесь, чтобы при чтении любой главы второго тома можно было быстро вспомнить, какому учебному коду соответствует production-симптом.
Что добавил второй том сверху
| Слой | Где обсуждается во втором томе |
|---|---|
| Лабораторная рамка AgentClinic-production и минимальный маршрут | Часть 0. Лаборатория AgentClinic-production |
| Восстановление спецификации из следов унаследованной системы | Часть 1. Восстановление спецификаций из legacy |
| Контролируемые дефекты в спецификации | Часть 2. Диагностика дефектов спецификации |
| Production-конституция с неизменяемым и изменяемым слоями | Часть 3. Конституция проекта | | Состязательная валидация между ролями | Часть 4. LLM-дуэль | | Мутационное тестирование спецификаций | Часть 5. Мутационное тестирование спецификаций | | Формализация неявных эвристик | Часть 6. Отбор теневых спецификаций | | Шлюз спецификации как обязательный gate | Часть 7. Specification CI | | Файловый арбитраж спорного изменения | Часть 8. Файловый арбитраж спорного изменения | | Маршрутизация моделей и ярусные бюджеты | Часть 9. Ярусные бюджеты | | Парные сторожевые метрики anti-Goodhart | Часть 10. Защита метрик от Гудхарта | | Интеграция с production API и авто-ремедиация | Часть 11. Production API | | Диагностическая карта антипаттернов прикладного цикла | Часть 12. Антипаттерны production SDD |
| Итоговый production-зачёт и пакет доказательств | Часть 13. Практический зачёт |
Таблица выше и есть тот мост, который превращает абстрактный production-сценарий в продолжение учебного проекта. В отдельных главах второго тома (например, в части 12 — антипаттерны production SDD) ссылки на первый том также вынесены в подвал отдельным блоком; в остальных главах они вплетены в текст по месту обсуждения.