docs(specs): archive documentation entrypoints remediation

2026-08-24 10:29:00 +03:00
parent 800450d075
commit 5b7bc0fdaf
15 changed files with 613 additions and 11 deletions
@@ -0,0 +1,47 @@
+## Why
+
+После поставки MVP корневой `MVP.md` и template README-файлы описывают
+устаревшую или неполную картину системы. Новый разработчик или AI-агент
+вынужден восстанавливать delivered capabilities, domain terminology,
+локальный bootstrap и ограничения verification из кода и архивов, хотя эта
+информация должна быть доступна через устойчивую документацию.
+
+## What Changes
+
+- **BREAKING** Удалить корневой `MVP.md` как завершённую карту поставки и
+  удалить ссылки, представляющие его актуальным источником.
+- Перенести канонический domain glossary из корневого `CONTEXT.md` в
+  `docs/architecture/domain-glossary.md`, сохранив утверждённые термины и
+  обновив навигацию.
+- Добавить фактический system overview с delivered capabilities, локальными
+  границами и Mermaid-потоками auth/session и T-Bank → backend → frontend.
+- Заменить template README frontend/backend на компактные onboarding entrypoints
+  с Node 22, безопасным bootstrap, локальными gates и ссылками на
+  authoritative/JIT documentation.
+- Сделать indexes architecture, development и features навигаторами по
+  устойчивой документации; исправить feature-doc summaries, противоречащие
+  delivered accounts, portfolio, ledger и future cash events.
+- Обновить scoped agent instructions только для актуальной маршрутизации,
+  сохранив detail и review trigger deferred Prisma e2e в remediation registry.
+
+## Capabilities
+
+### New Capabilities
+
+_Нет._
+
+### Modified Capabilities
+
+- `project-documentation`: устойчивые documentation entrypoints, glossary и
+  фактическая архитектурная карта должны позволять определить delivered
+  поведение и его границы без обращения к устаревшему MVP-файлу.
+- `project-foundation`: workspace больше не хранит корневой MVP delivery map;
+  локальные инструкции направляют к durable documentation и canonical
+  OpenSpec authority.
+
+## Impact
+
+Затрагиваются `docs`, корневые workspace файлы, документация и `AGENTS.md` в
+`frontend`, `backend` и `specs`, а также OpenSpec requirements и remediation
+registry. Runtime-код, HTTP API, зависимости, generated artifacts, CI/CD и
+Prisma e2e policy не изменяются.