К основному содержанию
правило CX Codex

frontend — правило для Claude Code: React/Next.js стандарты

Правило frontend для React и Next.js проектов: shadcn/ui, Tailwind CSS v4, FSD-lite архитектура, Server Components по умолчанию.

MIT ★ 1 472 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает frontend

Правило задаёт стандарты кода для фронтенда на React и Next.js. Использует компоненты shadcn/ui как основу UI, расширяет их через cva-варианты и композицию вместо кастомного CSS. Server Components по умолчанию, Client Components — только для интерактива и API. Обязательны семантический HTML, ARIA-метки и навигация с клавиатуры.

Архитектура FSD-lite: общий код в src/, фичи в src/features/[feature]/ без кросс-импортов между фичами. Имена файлов в kebab-case по схеме <домен>-<роль>.tsx для компонентов, <домен>.<вид>.ts для остального. Запрещены index.tsx, utils.ts, helpers.ts и прочие grab-bag имена. Импорты абсолютные через @/, import type обязателен для типов.

Правило применяется только к файлам **/*.{tsx,jsx,css,scss} и только когда вызвано явно. Без FFmpeg, Python и внешних API не требует ничего — это набор соглашений для IDE.

Какие задачи решает

  • навязать единый стиль кода в React/Next.js команде
  • запретить prop drilling глубже трёх уровней
  • отучить разработчиков от grab-bag файлов вроде utils.ts
  • заставить использовать Server Components по умолчанию
  • проверить доступность каждого компонента при ревью

Примеры запросов агенту

  • Добавь карточку товара, используй shadcn/ui Card и вынеси в src/features/catalog/components/product-card.tsx
  • Перепиши этот хук в use-cart-sync.ts, атомы Jotai положи в cart.atoms.ts
  • Проверь, что в OrderSummaryCard есть ARIA-метки и навигация с клавиатуры

Как установить frontend

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

2Вручную: положить файлы

.claude/rules/frontend.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о frontend

Как установить frontend в Claude Code?

Выполни /plugin marketplace add first-fluke/oh-my-agent, затем /plugin install oma@oh-my-agent. Правило окажется в .claude/rules/frontend.md.

Что делает правило frontend?

Задаёт стандарты кода для React и Next.js: shadcn/ui компоненты, Tailwind CSS v4, FSD-lite архитектура, Server Components по умолчанию, единые имена файлов и запрет grab-bag модулей.

Почему запрещены файлы utils.ts и helpers.ts?

Grab-bag имена скрывают назначение модуля. Правило требует называть файлы по домену и роли: format-price.ts, cart.atoms.ts, orders.queries.ts.

Исходный текст

frontend.md · MIT
---
description: React/Next.js frontend coding standards with shadcn/ui, Tailwind CSS v4, and FSD-lite architecture
globs: "**/*.{tsx,jsx,css,scss}"
alwaysApply: false
---

# Frontend Coding Standards

## Core Rules

Apply framework-specific rules only to that framework. Existing project choices take precedence over starter defaults; scoped changes do not authorize migrations.

1. **Component Reuse**: Use `shadcn/ui` components first. Extend via `cva` variants or composition. Avoid custom CSS.
2. **Design Fidelity**: Code must map 1:1 to `DESIGN.md` (Section 9 — Agent Prompt Guide) and Design Tokens. Resolve discrepancies before implementation.
3. **Rendering Strategy**: Default to Server Components for performance. Use Client Components only for interactivity and API integration.
4. **Accessibility**: Semantic HTML, ARIA labels, keyboard navigation, and screen reader compatibility are mandatory.
5. **Tool First**: Check for existing solutions and tools before coding.
7. **Request proxy convention**: when the target project uses Next.js 16+ with `proxy.ts`, preserve that convention. Check the installed framework version and routing before recommending a file rename. Diagnose wiring from code and tests.
7. **No Prop Drilling**: Avoid passing props beyond 3 levels. Use the project's client-state library (Jotai atoms or a Zustand store — see oma-frontend `resources/tech-stack.md`) instead. Avoid React Context.
8. **Auth Boundary**: Client code must not import database adapters or server-only auth code. Keep server-side application logic in the project's existing server boundary.
9. **Animation library**: preserve the project's existing animation library for scoped edits. For new motion-based implementations, use the `motion` package and `motion/react` imports.
10. **Framework version**: preserve the installed framework and dependency ranges for scoped changes. Select versions when scaffolding or when an upgrade is explicitly requested; do not upgrade an existing app to satisfy a starter default.

## Architecture (FSD-lite)

- **Root (`src/`)**: Shared logic (components, lib, types). Hoist common code here.
- **Feature (`src/features/*/`)**: Feature-specific logic. **No cross-feature imports.** Unidirectional flow only.

```
src/features/[feature]/
├── components/           # Feature UI components
│   └── skeleton/         # Loading skeleton components
├── types/                # Feature-specific type definitions
└── utils/                # Feature-specific utilities & helpers
```

## Naming Conventions

### Symbols

- Components/Types/Interfaces: `PascalCase`
- Functions/Vars/Hooks: `camelCase`
- Constants: `SCREAMING_SNAKE_CASE`
- Imports: Absolute `@/` is MANDATORY (no relative `../../`)
- MUST use `import type` for interfaces/types

### File Naming — self-describing names

**Principle: the filename alone must answer "what domain + what role". If a reader has to open the file to know what it is, the name is wrong.**

All files are `kebab-case`. Components use `<domain>-<ui-role>.tsx`; non-component modules use `<domain>.<kind>.ts`.

| Kind | Pattern | Example |
|------|---------|---------|
| Component | `<domain>-<ui-role>.tsx` | `order-summary-card.tsx` → `OrderSummaryCard` |
| Skeleton | `<component>-skeleton.tsx` | `order-summary-card-skeleton.tsx` |
| Hook | `use-<behavior>.ts` | `use-order-polling.ts` |
| TanStack Query | `<domain>.queries.ts` / `<domain>.mutations.ts` | `orders.queries.ts` |
| Jotai atoms | `<domain>.atoms.ts` | `cart.atoms.ts` |
| Zustand store | `<domain>.store.ts` | `cart.store.ts` |
| Zod schema | `<domain>.schema.ts` | `checkout.schema.ts` |
| Types | `<domain>.types.ts` | `order.types.ts` |
| Constants | `<domain>.constants.ts` | `payment.constants.ts` |
| API client | `<domain>.api.ts` | `orders.api.ts` |
| Utility | one capability per file, named as a verb phrase | `format-price.ts`, `parse-tracking-number.ts` |
| Test | colocated `<target>.test.ts(x)` | `format-price.test.ts` |

Rules:

1. **Filename = kebab-case of the main export.** One main export per file; `order-summary-card.tsx` exports `OrderSummaryCard`.
2. **Keep the domain in the name even inside a feature directory.** Editor tabs and search results show only the basename — `cart-summary-card.tsx`, not `summary-card.tsx` inside `features/cart/components/`.
3. **`index.ts` only as a feature public-API barrel** (`src/features/<feature>/index.ts`). Never `index.tsx` as a component file.
4. **Grab-bag filenames are BANNED**: `utils.ts`, `helpers.ts`, `common.ts`, `misc.ts`, `data.ts`, `styles.ts`, and bare `types.ts` / `constants.ts` / `hooks.ts` without a domain prefix. Split them by domain or capability instead.
5. **Version/status suffixes are BANNED**: `*-v2`, `*-new`, `*-old`, `*-final`, `*-copy`, `*-refactored`. Git owns history, not filenames.
6. **No abbreviations** beyond universally known ones (`api`, `db`, `i18n`, `a11y`): `user-profile-card.tsx`, never `usr-prf-crd.tsx`.

## Performance

- Target First Contentful Paint (FCP) < 1s
- Use `next/dynamic` for heavy components, `next/image` for media
- Responsive Breakpoints: 320px, 768px, 1024px, 1440px

© First Fluke · MIT · first-fluke/oh-my-agent

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
frontend-architect curiositech Скилл frontend-architect для выбора фронтенд-стека, развёртывания на Cloudflare Pages и архитектуры внутренних инструментов. Помогает подобрать фреймворк, настроить shadcn/ui и организовать дизайн-систему. CX Codex +1 191установок frontend-design customware-ai Скилл frontend-design для Claude Code задаёт визуальные правила при вёрстке на Tailwind и shadcn/ui: запрещает шаблонные серые интерфейсы, сетки карточек и сайдбары. CX Codex +1 1 600установок typescript-nodejs-nextjs-react-ui-css-cursorrules- PatrickJS typescript-nodejs-nextjs-react-ui-css-cursorrules- — правило для Cursor, задающее стиль TypeScript, Next.js App Router, React и Tailwind: функциональные компоненты, интерфейсы и mobile-first вёрстку. CX Codex +1 ★ 41 178звёзд репо typescript-nodejs-nextjs-app-cursorrules-prompt-fi PatrickJS Правило typescript-nodejs-nextjs-app-cursorrules-prompt-fi задаёт стандарты стека Next.js App Router, TypeScript, Tailwind и Shadcn UI для Cursor. Помогает писать серверные компоненты без лишнего клиентского состояния. CX Codex +1 ★ 41 178звёзд репо next.js-react-typescript-cursor-rules qdleader Правило next.js-react-typescript-cursor-rules задаёт стиль и структуру кода для Next.js, React и TypeScript. Подходит для проектов с App Router, Shadcn UI, Radix UI и Tailwind. CX Codex +1 ★ 571звёзд репо senior-frontend borghei Скилл senior-frontend для Claude Code, Codex, Cursor и других IDE создаёт React-проекты, компоненты, тесты и Storybook-файлы. Проверяет зависимости и подсвечивает тяжёлые пакеты. CX Codex +1 357установок

Из того же набора69

Весь набор →
research-explorer Субагент research-explorer, который ищет ответы сразу в трёх источниках: документация и код, сигналы рынка, академические работы. Собирает выводы с указанием источников и уровня надёжности. CX Codex ★ 1 472звёзд репо database Правило database задаёт стандарты проектирования схем, нормализации, индексации и миграций для SQL, NoSQL и векторных баз. Срабатывает при работе с файлами .sql и .prisma. CX Codex +1 ★ 1 472звёзд репо docs-curator Субагент docs-curator, который следит за дрейфом документации и обновляет MD-файлы, когда код меняется. Ловит неработающие ссылки, предлагает патчи и держит docs/**/*.md в актуальном состоянии. CX Codex ★ 1 472звёзд репо i18n-guide Правило i18n-guide задаёт язык ответов агента и определяет, какие строки переводить, а какие оставлять на английском. Пригодится в проектах с несколькими локалями и агентскими workflow. CX Codex +1 ★ 1 472звёзд репо oma-docs Сверяет ссылки в документации, обновляет тексты под изменения в коде и находит рассинхрон в переводах. Работает через CLI oma docs или ручной парсинг ссылок. CX Codex +1 ★ 1 472звёзд репо oma-scm Скилл oma-scm для Claude Code выполняет Git-операции: коммиты, ветки, слияния и разрешение конфликтов. Он задаёт явную область действий и предусматривает возможность отката. CX Codex +1 ★ 1 472звёзд репо oma-skill-creation Скилл oma-skill-creation создаёт и редактирует скиллы OMA в формате SSL-lite для Claude Code и Codex. Включается при проектировании структуры .agents/skills/{name}/SKILL.md, настройке роутинга и проверке линтером. CX Codex +1 ★ 1 472звёзд репо oma-mobile Скилл oma-mobile для мобильной разработки: помогает собрать экран или виджет на Flutter или React Native, подключить камеру, GPS, пуши и офлайн-режим. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой