Init commit

2026-07-20 19:28:56 +07:00
commit d71b45d86f
122 changed files with 8439 additions and 0 deletions
@@ -0,0 +1,50 @@
+---
+description: ВСЕГДА использовать MCP-плагин shadcn UI перед любым UI-кодом
+alwaysApply: true
+---
+
+# shadcn MCP — обязательно
+
+Перед **любой** задачей с UI (новый экран, компонент, стили, рефакторинг внешнего вида) — **сначала MCP** `plugin-shadcn-shadcn`, не память и не веб-поиск.
+
+CLI и docs — **после** MCP, по команде из `get_add_command_for_items`.
+
+Enterprise / PRO (Data Grid, Filters, Frame, blocks) — дополнительно [`reui-mcp.mdc`](reui-mcp.mdc) и MCP **`user-reui`**.
+
+## Порядок (строго)
+
+0. Поиск существующих shared / `reui-kit`
+1. **`get_project_registries`** — какие registry доступны (`@shadcn`, `@reui`)
+2. **`search_items_in_registries`** — компонент, block, example
+3. **`get_item_examples_from_registries`** — полный код примера перед написанием JSX
+4. **`get_add_command_for_items`** — точная CLI-команда `pnpm dlx shadcn@latest add ...`
+5. Выполнить add из `apps/web` (см. [`frontend-monorepo.mdc`](frontend-monorepo.mdc))
+6. **CLI docs:** `cd apps/web && pnpm dlx shadcn@latest docs <component>` — сверить API с [ui.shadcn.com/docs/components](https://ui.shadcn.com/docs/components)
+7. Сверить examples из MCP с API из docs CLI — реализовать только после совпадения
+8. Адаптировать пример под TanStack Router / Query → `apps/web/src/`
+9. **Context7** — только TanStack / Recharts / не-shadcn
+10. **`get_audit_checklist`** — перед merge PR
+
+## Когда вызывать MCP
+
+| Задача | MCP |
+|--------|-----|
+| Новая страница / layout | `user-reui` compose/block **или** shadcn `search` → block |
+| Нет примитива в `@evofw/ui` | `plugin-shadcn-shadcn` → add |
+| Data Grid, Filters, Frame, KPI | `user-reui` ([`reui-mcp.mdc`](reui-mcp.mdc)) |
+| Сомнение в API/props | examples + `get_component` |
+| Ревью UI перед сдачей | `get_audit_checklist` / ReUI `validate_usage` |
+
+## Запрещено
+
+- Писать UI по памяти, не проверив MCP
+- Копипаст с ui.shadcn.com / reui.io без CLI
+- Самописные примитивы, если есть item в registry
+- Пропускать MCP «потому что компонент простой»
+
+## Сервер и инструменты
+
+- **MCP:** `plugin-shadcn-shadcn` + `user-reui`
+- Перед вызовом — schema инструмента
+
+Связанные: [`shadcn-ui-production.mdc`](shadcn-ui-production.mdc), [`reui-mcp.mdc`](reui-mcp.mdc), skill `.agents/skills/shadcn`.