7.2 KiB
7.2 KiB
work_item, stage, author_agent, status, created_at, model_used
| work_item | stage | author_agent | status | created_at | model_used |
|---|---|---|---|---|---|
| ORCH-011 | architecture | architect | proposed | 2026-06-11 | claude-opus-4-8 |
10 — Технические риски: ORCH-011 — Полная документация системы мультиагентов (витрина + PPTX)
Work Item: ORCH-011 · Repo: orchestrator · Стадия: architecture
Информационный (гейтом не парсится). Перечисляет риски реализации и их митигейшн. Базовые бизнес-риски R-1…R-5 — BRD §8; здесь — их техническая детализация + новые.
Реестр рисков
| ID | Риск | Вер. | Влия. | Митигейшн |
|---|---|---|---|---|
| TR-1 | Гниение витрины (R-1): self-hosting темп быстро устаревает снапшот; живой пример уже в репо — схема конвейера в PRODUCT_VISION.md §2 потеряла deploy-staging/cancelled |
Выс. | Сред. | Машинно-проверяемые факты держат derive-тесты (ADR-001 D6 TC-03…TC-05: стадии/гейты/агенты импортом из кода); проза — норматив сопровождения в индексе + расширенная reviewer-ось (D7); link-first сводит правку к одной строке-резюме |
| TR-2 | Второй источник истины (R-2): дубль деталей architecture/README в витрине → противоречия | Сред. | Сред. | Норматив D3: запрещён дубль живых таблиц golden sources; разрешённый дубль — только машинно-сверяемый тестом факт (прецедент key-sync ORCH-102 TC-02b); контроль — AC-6 + reviewer |
| TR-3 | Объём одного прогона (R-3): 10 файлов + скрипт + тесты + правка промпта могут не поместиться в разумный PR | Сред. | Сред. | Модульность D1 (правки независимы); нормативный приоритет блоков при дефиците (D9); молчаливое сокращение запрещено — эскалация разбиением по штатному маршруту |
| TR-4 | Утечка зависимости генерации в прод-образ (R-4): python-pptx случайно попадает в requirements*/Dockerfile |
Низ. | Выс. | Архитектура скрипта D4 (lazy import, запуск только вне рантайма); машинный гард TC-09 (скан requirements*/Dockerfile на pptx) — попадание рвёт CI |
| TR-5 | Ложная жёсткость анти-дрейф тестов: слишком буквальные ассерты (точные фразы прозы) делают каждую будущую docs-правку красной → тесты начнут ослаблять | Сред. | Сред. | D6: ассерты только на стабильное (заголовки, имена из кода через импорт, относительные ссылки, биты-подстроки); снапшот-контента отвергнут явно (ADR-001 «Альтернативы») |
| TR-6 | Регресс канона 52d при правке промпта reviewer (D7): нарушение порядка секций / verdict-ключа | Низ. | Выс. | Правка — только добавление текста внутрь существующих секций (паттерн ORCH-079); анти-регресс tests/test_agent_prompts_canon.py (существующие ассерты + новый на упоминание витрины) |
| TR-7 | Кириллица/тема в PPTX: артефакт собирается, но рендеринг не «точный» (D-1): шрифт без кириллицы, контраст темы | Низ. | Сред. | python-pptx пишет редактируемый текст (не растр); шрифты — системные с полной кириллицей (Calibri/Arial); процедура в presentation.md несёт явную «Проверка:» (открыть файл, тема тёмная, кириллица читается); приёмка — AC-7 |
| TR-8 | Парсер слайдо-источника расходится с тестом: свой regex в тесте ≠ парсер скрипта → источник валиден для теста, но не собирается | Низ. | Сред. | Один парсер: тест импортирует parse_slides из scripts/build_presentation.py (D4/D6 TC-08; прецедент импорта из scripts — test_bootstrap_script.py) |
| TR-9 | Цифры в бизнес-части не подтверждаются репо (метрики скорости/стоимости из vision) → витрина теряет доверие / выдаёт желаемое за действительное | Сред. | Низ. | Норматив D2: числа только с внутрирепозиторным подтверждением или явной атрибуцией «оценка из PRODUCT_VISION»; новые цифры не изобретать (AC-12; reviewer проверяет) |
| TR-10 | Путаница канона бинарей: в репо остаётся docs/PRODUCT_VISION.pptx (старый паттерн), новый канон — «бинарь не коммитим» (D5) → будущий агент скопирует старый паттерн |
Низ. | Низ. | Канон зафиксирован сквозным adr-0039 + нормативом в presentation.md; PRODUCT_VISION.pptx не трогается (чужой артефакт), но прецедентом не является — явная оговорка в ADR-001 D5 |
Сводный вывод
Доминирующий класс — риски сопровождения документации (TR-1/TR-2/TR-5): изменение не несёт
рантайм-риска вовсе (docs+tests+dev-скрипт, src/** байт-в-байт, машинный гард TC-09), но
создаёт новый golden source, который без машинной сверки и явной reviewer-оси начал бы гнить с
первой же задачи. Митигация встроена в само решение (derive-тесты + link-first + норматив +
ось D7). Эскалация arch:major-change не требуется (нет новой стадии/компонента/смены БД);
возврат в анализ не нужен. Остаточный риск для прод-конвейера (self-hosting): низкий —
прод-контейнер не затрагивается, деплой штатным маршрутом, для enduro-trails изменение инертно.