Files
orchestrator/docs/work-items/ORCH-105/10-tech-risks.md
claude-bot 87e75ab2c3
All checks were successful
CI / test (push) Successful in 59s
architect(ET): auto-commit from architect run_id=646
2026-06-12 07:55:33 +03:00

5.7 KiB
Raw Blame History

work_item, stage, author_agent, status, created_at, model_used
work_item stage author_agent status created_at model_used
ORCH-105 architecture architect proposed 2026-06-12 claude-opus-4-8

10 — Технические риски: ORCH-105 — Подготовка презентации по орку

Work Item: ORCH-105 · Repo: orchestrator · Стадия: architecture

Информационный (гейтом не парсится). Перечисляет риски реализации и их митигейшн. Решения — 06-adr/ADR-001-presentation-lite-and-plane-usage-slides.md.

Реестр рисков

ID Риск Вер. Влия. Митигейшн
TR-1 Ошибка перенумерации при вставке слайдов в середину (пропуск/дубль номера) → падение сквозной нумерации. Сред. Низ. Тест test_presentation_source_parses_with_canonical_parser требует [1..N] строго подряд → ловит мгновенно в CI; инвариант FR-3 явно выписан; ADR D2 даёт точную раскладку 19 слайдов. Откат — тривиальный revert.
TR-2 Фактдрейф: тезис расходится с реальной возможностью / именем статуса / лейбла / скрипта (напр. «Approved выкатывает прод», «autoApprove пропускает проверки», «Lite — монолитный инсталлятор»). Сред. Сред. ADR D3 — построчная привязка к golden sources (LITE_SETUP.md/tech-pipeline.md/tech-integrations.md/CLAUDE.md) с дословными именами; новый бит-тест D4 фиксирует присутствие; reviewer сверяет факты (правило агентов №6 → finding ≥ P1).
TR-3 Случайный запрещённый хост-литерал / секретоподобное значение в тексте слайда → красный анти-дрейф. Низ. Низ. Существующие test_showcase_carries_no_forbidden_host_literals (FORBIDDEN-импорт) и test_showcase_carries_no_secret_like_values (hex≥32/alnum≥40) ловят в CI; ADR D4 предписывает использовать только семантические корни/имена статусов; 8500/8501 явно безопасны (самочек эвристики).
TR-4 Хрупкий или послабляющий анти-дрейф-тест: переобучение на целую фразу (рвётся при переформулировке) ИЛИ ослабление существующих проверок. Сред. Низ. ADR D4 — ровно одна новая функция по образцу ..._mandatory_narrative_bits, матч по семантическим корням, существующие функции байт-в-байт; пол ≥ 12 и нумерация не трогаются.
TR-5 Раздувание деки сверх читаемого объёма (соблазн добавить >3 слайда). Низ. Низ. ADR D2 ограничивает рост +3 (deck = 19; 3-й Plane-слайд — только при переполнении лимита 6 тезисов); BRD §6 допускает ~1920; жёсткий пол ≥ 12 не нарушается.
TR-6 Случайная правка рантайма / попадание python-pptx в прод-образ / коммит .pptx-бинаря → нарушение self-hosting-инварианта. Низ. Выс. Docs-only по ТЗ; git diff не должен затрагивать src/**/STAGE_TRANSITIONS/QG_CHECKS/схему БД (AC-7); test_no_pptx_dependency_in_prod_image + build_script_toplevel_imports_are_stdlib_only зелёные; build/ в .gitignore. Скрипт сборки не правится (ADR D1).
TR-7 Ложное ощущение покрытия рендера: рендер .pptx в CI не выполняется (нет python-pptx), визуальный дефект (битая кириллица/тема/отсутствие слайда) проходит мимо автогейта. Сред. Низ. ADR D5 — честная граница: рендер проверяется вручную в dev-venv (FR-4/AC-5/TC-07), исход фиксирует tester; печать Собрано слайдов: N → … сверяется с числом слайдов источника.

Сводный вывод

Доминирующий класс — риски точности контента (TR-1, TR-2): чисто документарные, ловятся существующим + одним новым структурным тестом и сверкой reviewer с golden sources; остаточный риск низкий. Рантайм-класс (TR-6) теоретически высоковлияющий, но вероятность минимальна — изменение docs-only по конструкции, накрыто машинными гардами витрины (AC-7) и инвариантами adr-0039. Эскалация arch:major-change не требуется; возврат в анализ не требуется. Для прод-конвейера (self-hosting) и для enduro-trails изменение инертно: src/**, стадии, гейты, схема БД — байт-в-байт; python-pptx вне прод-образа; собранный бинарь не коммитится.