docs: simplify system documentation
Docs security / security (push) Successful in 7s
Docs verify / verify (push) Successful in 9s

This commit is contained in:
2026-09-14 05:51:29 +03:00
parent 67f152d365
commit 9b19a5cf4d
30 changed files with 104 additions and 2445 deletions
+4 -3
View File
@@ -16,10 +16,13 @@ Docs даёт самостоятельное понимание продукта
| Размещение кода, conventions, команды разработки и проверки | Локальные инструкции frontend/backend |
| Выбор репозитория и типа знания | Корневой [AGENTS](../AGENTS.md) |
История поставок, аудитов и проверок остаётся в Git, Issues и PR.
Процесс разработки и инструкции агентов принадлежат локальным инструкциям
репозиториев. ADR фиксируют решения самой системы, а не организацию работы.
Основные спецификации описывают и согласованное текущее поведение.
Различие specs и docs не является разделением на будущее и настоящее.
Docs объясняет смысл контракта, не вводя независимо редактируемые требования.
OpenSpec применяется по явному запросу согласно [принятому процессу](development/openspec-authority-and-lifecycle.md).
## Потребность читателя и структура
@@ -152,8 +155,6 @@ npm run verify
При изменениях соседних репозиториев выполни там `git diff --check` и проверь
затронутые ссылки. Markdown-only правки не требуют тестов всего приложения.
Точный scope исключений задан существующими `package.json` и конфигурацией lint:
исторические свидетельства не обязаны разрешать прежние адреса.
Правило relative-links не проверяет внешние URL и HTML-ссылки. Mermaid-рендер
в gate не входит; используй доступный локальный рендерер без отправки материалов
наружу, установки стека или добавления новых валидаторов. Публикационного