5.1 KiB
work_item, stage, author_agent, status, created_at, model_used
| work_item | stage | author_agent | status | created_at | model_used |
|---|---|---|---|---|---|
| ORCH-108 | architecture | architect | proposed | 2026-06-17 | claude-opus-4-8 |
10 — Технические риски: ORCH-108 — FAQ по статусу STOP
Work Item: ORCH-108 · Repo: orchestrator (self-hosting) · Стадия: architecture
Информационный документ (гейтом не парсится). Перечисляет риски реализации docs-only задачи и их митигейшн. Класс рисков — минимальный: рантайм/конвейер не затрагиваются.
Реестр рисков
| ID | Риск | Вер. | Влия. | Митигейшн |
|---|---|---|---|---|
| TR-1 | Дрейф «доки ↔ код». Будущая правка поведения STOP (src/cancel.py/cancel_task/маршрут stop) сделает FAQ неверным. |
Сред. | Сред. | Структурный анти-дрейф тест tests/test_faq_stop_doc.py (ADR D3) + норматив сопровождения «правишь STOP → обнови FAQ в том же PR» (ADR D5) + reviewer-ось «документация». |
| TR-2 | FAQ-«сирота» / дубль источника истины. FAQ не связан с витриной или дословно копирует ADR/обзор вместо ссылки. | Низ. | Низ. | Link-first (ADR D4): двусторонние ссылки (AC-8), машинные детали — только ссылками; тест проверяет наличие кросс-ссылок. |
| TR-3 | Ложно-строгий негативный скан. Тест ищет запрещённые слова (main, «откатыва…», force-push) как голые подстроки → краснеет на корректно отрицающих предложениях FAQ (которые AC-9 предписывает иметь). |
Сред. | Сред. | Негативный скан — на уровне утверждений, а не подстрок (ADR D3); инвариант «тест не фолзит на верном FAQ, но краснеет на реально ложном». Зеркало эталона tests/test_lite_setup_doc.py. |
| TR-4 | Битый якорь кросс-ссылки. Ссылка tech-pipeline.md#отмена-stop--cancelled не совпадёт с фактически генерируемым slug заголовка «Отмена: STOP → cancelled». |
Низ. | Низ. | Разработчик сверяет slug при переносе (ADR D4); цели секций подтверждены существующими (business.md §«Сценарий 6», tech-pipeline.md §«Отмена», ADR ORCH-090). |
| TR-5 | Фактическая неточность FAQ. Утверждение расходится с кодом (напр. «STOP откатит прод», «убивает деплой мгновенно»). | Низ. | Выс. | NFR-2/FR-5/AC-9: каждое утверждение verifiable против read-only модулей (ADR §Ссылки); reviewer сверяет с кодом; негативный скан (TR-3) ловит запрещённый класс. Содержание выверено аналитиком (TRZ Приложение A). |
| TR-6 | Ошибочное размещение раздела. Аудитория FAQ — «пользователь доски», секция — operations/ («наш прод»). |
Низ. | Низ. | Осознанный компромисс (ADR D1): альтернативы (overview/ под тестом витрины, новый docs/faq/) хуже; вводный абзац «для кого»; будущее пере-размещение дёшево (1 файл + 2 ссылки + 1 тест). |
Сводный вывод
Доминирующий класс — дрейф документации (TR-1) и хрупкость анти-дрейф теста (TR-3); оба
структурно снижены решением D3 (claim-level негативный скан + детерминированный offline-тест) и
нормативом сопровождения D5. Рантайм-рисков нет: задача docs-only, не трогает src/**/
STAGE_TRANSITIONS/QG_CHECKS/схему БД, не деплоит/не рестартит прод/не трогает main →
self-hosting-безопасна, прод-деплой безвреден.
Эскалация не требуется. Не arch:major-change (нет новой стадии/компонента/смены БД), возврат
в анализ не нужен (BRD/TRZ/AC полны и согласованы с кодом; блокирующих неоднозначностей нет —
01-questions.md аналитиком осознанно не создан). Остаточный риск для прод-конвейера —
пренебрежимо мал.