# Индекс документации (10.11.2026) ## Проблема **630 markdown-файлов в `ops/` и 946 по репозиторию.** Индекс `docs/README.md` описывал 6 документов. Найти нужное можно было только `grep`'ом. Документация — сильная сторона проекта (фиксирует ловушки), но без навигации она превращается в архив. ## Что сделано ### `ops/scripts/build_docs_index.py` Собирает все `.md` из `ops/`, берёт заголовок, размер и дату изменения, группирует по каталогам. Пишет `ops/INDEX.md`. ``` файлов: 630 каталогов: 95 размер индекса: 76 КБ ``` Свежие файлы — сверху, у каждого каталога счётчик «за неделю»: ``` ## ops — 45 файлов (29 за неделю) | Документ | О чём | Изменён | |---|---|---| | AUDIT-LOCAL-RENDER-2026-11-09.md | Локальные рендеры комнат | 09.11 | | SERVICE-STANDARD.md | Единый стандарт сервиса | 07.11 | | NOTIFICATIONS.md | Политика уведомлений (анти-спам) | 06.11 | ``` ### Автообновление Задание Hermes **`docs-index`** ежедневно в 06:50. Индекс не устареет. ### Индекс попадает в RAG `ops/INDEX.md` лежит в индексируемом каталоге — значит секретарь сможет найти документ по описанию, а не только по содержимому. ## Итог | Было | Стало | |---|---| | 630 файлов без навигации | индекс по каталогам с описаниями | | ручной `grep` | таблица «документ — о чём — когда» | | `docs/README.md` (6 ссылок) | `ops/INDEX.md` (630 файлов) | ## Осталось 1. `docs/README.md` — обновить, чтобы вело на `ops/INDEX.md`. 2. Часть документов старше месяца — кандидаты на архивацию (44 файла). 3. Разделить «живые» документы и «историю спринтов» по папкам.