docs: make project documentation self-contained

development/README.md

@@ -1,13 +1,22 @@
-# Разработка
+# Сопровождение системы
 
-Работа начинается с задачи пользователя; обязательного OpenSpec/SDD lifecycle нет.
-Проектные факты выбирайте через [AI_INDEX](../AI_INDEX.md).
+Здесь описаны локальное окружение, согласованность компонентов, проверка
+качества и поддержание проектных знаний. Материалы самостоятельны и не
+требуют открытия внутренних файлов приложений.
 
-- [Engineering governance](engineering-governance.md) — выбор решения/dependency, risk-based tests, local gates, UI и опасные изменения.
-- [Context discipline](agent-token-efficiency.md) — semantic/path routing, sources, recovery и проверка эффективности.
-- [Routing eval cases](agent-context-evals.md) — реальные decision cases и counterexamples для conventions.
-- [Frontend workflow](frontend-workflow.md) / [backend workflow](backend-workflow.md) — запуск и существующие checks.
-- [HTTP contract workflow](runtime-openapi-verification.md) — Nest OpenAPI → snapshot → generated types и контрактная проверка.
-- [Дизайн-система](design-system.md) / [UI-каталог](ui-catalog.md) — theme/tokens, реальные components/stories и ограничения.
-- [Remediation registry](audit-remediation.md) — найденная запись Audit ID и historical evidence.
-- [OpenSpec](openspec-authority-and-lifecycle.md) — optional legacy workflow, только по явному запросу.
+- [Локальное окружение](local-workspace.md) — предпосылки работы, первый пользовательский сценарий и диагностика.
+- [Frontend](frontend-workflow.md) / [backend](backend-workflow.md) — ответственность приложений и границы проверки.
+- [HTTP contract](runtime-openapi-verification.md) — направление генерации OpenAPI и проверка совместимости.
+- [Дизайн-система](design-system.md) / [UI-каталог](ui-catalog.md) — визуальные роли, реальные состояния и ограничения примеров.
+- [Принципы изменений](engineering-governance.md) — связность системы, риск и доказательства результата.
+- [Ведение документации](documentation.md) — самостоятельные объяснения и их обновление вместе с системой.
+- [Контекст знаний](agent-token-efficiency.md) / [проверочные вопросы](agent-context-evals.md) — поиск ответа и обнаружение пробелов документации.
+- [OpenSpec](openspec-authority-and-lifecycle.md) — роль сохранённых требований и статус прежнего процесса.
+
+## Исторические свидетельства
+
+[Remediation registry](audit-remediation.md) и [Completion Evidence](completion-evidence.md)
+сохраняют статусы, исходные адреса и результаты прежних проверок.
+[Аудиты](../audits/README.md) — неизменяемые снимки своего времени. Эти материалы
+не входят в самостоятельное описание текущей системы; их внутренние ссылки
+могут требовать архивного окружения и не являются условием чтения документации.