Files
specs/openspec/changes/refresh-project-documentation-and-agent-entrypoints/proposal.md
T

48 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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 не изменяются.