docs(ai): adopt task-driven scoped context

This commit is contained in:
2026-09-09 16:23:11 +03:00
parent 7166ee51d1
commit b7a56b1eb5
17 changed files with 502 additions and 676 deletions
+10 -18
View File
@@ -1,21 +1,13 @@
# Разработка
Здесь размещаются устойчивые правила разработки, локальной проверки и поставки. Требования и планы изменений остаются в `../specs/openspec`.
Работа начинается с задачи пользователя; обязательного OpenSpec/SDD lifecycle нет.
Проектные факты выбирайте через [AI_INDEX](../AI_INDEX.md).
- [Frontend workflow](frontend-workflow.md) — Node 22, локальный запуск и
frontend verification.
- [Дизайн-система](design-system.md) — shared theme, токены и общий UI-набор.
- [UI-каталог Storybook](ui-catalog.md) — запуск, блоки Design System и Product с реальными компонентами
и композициями, безопасные примеры и границы проверки интерфейса.
- [Backend workflow](backend-workflow.md) — bootstrap backend, локальные
non-mutating gates и границы e2e.
- [Audit remediation registry](audit-remediation.md) — статусы findings, следующий
OpenSpec change и ссылки на canonical archived Completion Evidence.
- [Engineering governance](engineering-governance.md) — SDD roles и approvals,
единый UI/UX-пакет Design, Delivery Map, независимая Validation, completion
safeguards и risk-based testing.
- [OpenSpec authority и lifecycle](openspec-authority-and-lifecycle.md) — native
planning, Apply, semantic sync и archive без обязательного agent runtime.
- [Token-efficient agent workflow](agent-token-efficiency.md) — authority для
recovery, fingerprints, актуального handoff и повторного использования evidence.
- [Проверка runtime OpenAPI](runtime-openapi-verification.md) — отдельный read-only contract gate и его границы.
- [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, только по явному запросу.