@@ -98,3 +98,18 @@
   Результаты / ограничения записывайте в docs/validation.md, историю — в CHANGELOG.
 - Перед разрешённым commit: все клиентские тесты, проверка VERSION и неизменности
   key / ID, git diff --check и staged diff. Push без force в запрошенную ветку.
+
+## Согласованность документации
+
+- Карта актуальных инструкций — [docs/README.md](docs/README.md). README описывает
+  текущий запуск, профильные инструкции — детали, CHANGELOG — изменения, validation —
+  датированные результаты. Исторический результат не подтверждает текущий прогон.
+- Сверяйте команды с Dockerfile, Compose, package scripts / pytest и CI. Основной
+  путь тестирования — контейнер; команды на хосте допустимы как отдельная разработка.
+- При изменении контракта обновляйте его описание и mock в соответствующем проекте.
+  Межрепозиторные ссылки ведут на GitHub; расположение checkout не является контрактом.
+- Wiki, playground, старые релизы и датированные отчёты не заменяют действующие
+  инструкции. Не переносите оттуда старую авторизацию, версии или deployment-команды.
+- При потере файлов сначала проверьте историю, reflog и недостижимые объекты Git.
+  Не выполняйте reset, clean или gc; восстановление файла не означает восстановление
+  всех незакоммиченных изменений. Секреты и рабочие данные не выводите.
@@ -6,6 +6,9 @@
 
 ## [Unreleased]
 
+- Согласованы инструкции запуска, тестирования и версий; добавлена карта документации,
+  исторические отчёты отделены от актуальных команд.
+
 ### Работа расширения
 
 - При открытии popup показывается результат проверки обновлений и HTTPS-ссылка
 
@@ -4,6 +4,8 @@
 с отправкой в основной прокторинг или ручной выгрузкой.
 Текущая версия — в [VERSION](VERSION). Подготовка ведётся в `pre-release`.
 
+Карта инструкций и границы проверок: [docs/README.md](docs/README.md).
+
 ## Связанные проекты и область поддержки
 
 - [proctoring](https://github.com/OSLL/proctoring) — пользовательский вход, приём видео,
 
@@ -0,0 +1,20 @@
+# Документация расширения
+
+- [README](../README.md) — настройка сервера, обновление и запуск тестов.
+- [Инструкция пользователю](../client/README.md) — установка, запись и восстановление.
+- [API](../client/API-COMPATIBILITY.md) — контракт веб-прокторинга.
+- [AGENTS](../AGENTS.md) — правила разработки и сохранности записей.
+- [Тесты](../tests/README.md), [mock API](../tests/mocks/README.md),
+  [матрица сценариев](test-coverage.md), [результаты проверок](validation.md).
+- [Версии](versioning.md), [изменения](../CHANGELOG.md),
+  [план обновления](production-upgrade.md).
+
+Рабочий продукт — `client`; отдельного сервера в репозитории нет. Node, Chrome,
+Xvfb и ffprobe для тестов устанавливаются в Docker, локально и в CI используется
+один Compose-сервис. Внешний backend заменён mock; его contract-тесты проверяют
+заглушку, а не развёрнутые web/ML. Настоящий сквозной runner находится в
+[web-репозитории](https://github.com/OSLL/proctoring/blob/pre-release/tests/extension/README.md).
+
+Playground содержит исторические эксперименты. Датированные validation-отчёты
+сохраняют результаты и ограничения своего прогона. Проверка callback четырёхчасового
+лимита не подтверждает многочасовую запись. Версии проектов независимы.
@@ -1,5 +1,12 @@
 # Проверки клиента
 
+## Согласование документации — 28.10.2026
+
+- Инструкции сверены с текущими Docker/Compose, тестовыми entrypoints и CI.
+  Добавлена [карта документов](README.md); исторические отчёты отделены от текущего запуска.
+- Проверены локальные Markdown-ссылки и whitespace diff. Код приложения, env,
+  рабочие сервисы и данные не менялись; тесты приложений повторно не запускались.
+
 ## Финализация перед коммитом — 28.10.2026
 
 - Ссылки на основной прокторинг и ML заменены GitHub-ссылками. В рабочем коде,
@@ -38,7 +45,6 @@ Playwright 1.64.1; ESLint 9.39.1 и Prettier 3.6.2 закреплены lock-ф
 architecture-repeat.log и architecture-selected.log в том же игнорируемом каталоге.
 Инструкция с разбором существующего сценария: [tests/README.md](../tests/README.md).
 
-
 ## Docker / Compose — 26.10.2026
 
 - Docker 29.9.2, Compose 5.6.1: `docker compose build tests` и запуск
@@ -57,7 +63,6 @@ architecture-repeat.log и architecture-selected.log в том же игнори
 Отчёты: tests/reports/{results.json,junit.xml,html/}; логи контейнерных прогонов:
 `tests/reports/docker-run.log`, `tests/reports/docker-ci-run.log`.
 
-
 ## Реорганизация тестов и mock API — 26.10.2026
 
 - Чистая установка `npm --prefix tests ci --ignore-scripts` и `format:check` проходят.
@@ -91,7 +96,6 @@ Windows и многочасовая запись остаются отдельн
 
 Инструкция для новых участников: [tests/README.md](../tests/README.md).
 
-
 ## До реорганизации: unit, UI и CI — 26.10.2026
 
 - `npm --prefix tests run test:unit`: 61/61 client и 5/5 version, без skips.
@@ -125,7 +129,6 @@ Unit / coverage: `/tmp/plugin-node24-unit.log`; Chrome stdout: `/tmp/plugin-node
 устойчивость. Callback четырёхчасового предела проверен без ожидания четырёх часов.
 Матрица проверок и оставшиеся границы: [test-coverage.md](test-coverage.md).
 
-
 ## Упаковка GitHub Release — 26.10.2026
 
 - Проверены реальные шаги последнего завершённого job: из 53 секунд 44 занимали
@@ -141,7 +144,6 @@ Unit / coverage: `/tmp/plugin-node24-unit.log`; Chrome stdout: `/tmp/plugin-node
 - Новая GitHub job / публикация не запускалась. Текущий удалённый job не отменялся;
   локальная правка не меняет уже запущенный workflow. Коммит / push не выполнялись.
 
-
 ## Открытие popup — 25.10.2026
 
 - Клиентские Node-тесты: 20/20; VERSION / manifest / ID: проверка пройдена.
 
@@ -7,9 +7,8 @@
 этого номера: их файлы не читаются, не копируются и не перезаписываются.
 Репозиторий можно использовать отдельно, без соседних checkout.
 
-Сейчас всем трём связанным проектам назначен одинаковый начальный номер, но далее
-версии могут повышаться независимо. Совместимость определяется API-контрактом и
-проверками, а не равенством версий. GitHub-теги не заменяют локальный VERSION.
+Версия каждого связанного проекта повышается независимо. Совместимость определяется
+API-контрактом и проверками, а не равенством версий. GitHub-теги не заменяют локальный VERSION.
 
 ## Изменение и проверка