specs/openspec/changes/archive/2026-09-09-clarify-agent-context-routing/README.md

clarify-agent-context-routing — закрытие

Дата: 2026-09-09. Статус: архивирован; исходный план заменён последующим решением пользователя. Итоговая задача реализована для frontend и backend.

Основание

После первоначального переноса frontend conventions пользователь расширил задачу: применить рекомендации исследований к обоим code repositories и убрать обязательный OpenSpec/SDD. Решение закреплено в ADR 012. Затем пользователь явно запросил завершение, архивацию и commits.

Proposal, Design, Tasks и delta specs сохранены как история первоначального scope. Отметки Tasks относятся к прежнему этапу; они не означают соответствие итоговой структуры старому плану или проведение независимой SDD Validation. Архивация выполняется с --skip-specs: delta требует обязательных SDD-фаз и исключает backend в planning scope, поэтому её перенос в main specs не соответствует последующему решению пользователя.

Поставленный результат

• Короткие root/local AGENTS и загрузка conventions по задаче, пути и границе.
• Frontend router, SOURCES и четыре тематических руководства.
• Backend router, SOURCES и шесть тематических руководств.
• Общие engineering rules, HTTP contract workflow и docs/specs indexes.
• 18 routing cases с безопасными исключениями и неприменимыми контрпримерами.

Код приложения, dependencies, runtime configuration и gates не менялись. Основные specs и существовавшие архивы сохранены. OpenSpec остаётся optional; эта архивация не возвращает обязательный lifecycle.

Проверка

Проверки выполнены под .nvmrc соответствующих repositories:

• frontend: npm run verify — exit 0; 26 test files, 147 tests, сборки приложения и Storybook.
• backend: npm run verify — exit 0; 25 suites, 107 tests, Prisma generation и Nest build. Для Prisma cache потребовался повторный запуск с разрешённым доступом вне sandbox.
• docs: npm run verify — exit 0; Markdown lint и git diff --check.
• Root/local AGENTS, оба .ai дерева и specs index: Markdown lint — 19 файлов без ошибок; scoped navigation — 60 файлов, 413 links/anchors без ошибок.
• Все 18 routing cases проверены вручную. Это не эксперимент по качеству агента; результаты не доказывают first-pass acceptance или экономию токенов.

Runtime HTTP contract не менялся; отдельные contract/e2e проверки не запускались. Известное ограничение общего backend e2e и непроверенная детализация validation errors описаны в действующих документах; их исправление не входило в эту задачу.