docs: simplify system documentation
This commit is contained in:
+4
-3
@@ -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 не входит; используй доступный локальный рендерер без отправки материалов
|
||||
наружу, установки стека или добавления новых валидаторов. Публикационного
|
||||
|
||||
Reference in New Issue
Block a user