|
|
6d798c01ef
|
docs(overview): витрина системы docs/overview/ — бизнес+тех, 3 аудитории, презентация (ORCH-011)
Единая точка входа в документацию платформы (ADR-001 D1–D9):
- docs/overview/ — 10 файлов: индекс (маршруты «Я заказчик / Я менеджер /
Я разработчик» + норматив «изменил функциональность → обнови витрину в том же
PR»), business.md (без жаргона, 6 сценариев), 7 тех-блоков (link-first),
presentation.md (16 слайдов + процедура сборки «команда + Проверка:»).
- scripts/build_presentation.py — генератор .pptx в тёмном дизайне (python-pptx;
чистый stdlib-парсер parse_slides + ленивый import pptx; бинарь не коммитится,
build/ в .gitignore; зависимость НЕ в прод-образе — машинный гард TC-09).
- tests/test_system_docs.py — структурный анти-дрейф: derive-сверки стадий/
гейтов/агентов импортом STAGE_TRANSITIONS/QG_CHECKS/glob промптов/config,
валидность ссылок, FORBIDDEN-скан + секрет-эвристика, слайды каноническим
парсером, NFR-2, указатели.
- reviewer.md — ось обзорных доков ORCH-079 расширена на витрину (D7; канон 52d
байт-в-байт, только текст внутри секций) + анти-регресс ассерт в
test_agent_prompts_canon.py.
- Указатели: README.md, CLAUDE.md (правила №2/№6, «Структура»),
PRODUCT_VISION.md (врезка-ссылка), CHANGELOG.md.
Рантайм байт-в-байт: src/**, docker-compose.yml, Dockerfile, requirements* —
ноль изменений (docs+tests+dev-скрипт, паттерн ORCH-102/103). pytest: 1873 passed.
Refs: ORCH-011
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
2026-06-11 09:36:40 +03:00 |
|
