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

principles — правило для Claude Code: как установить и использовать

Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов.

Apache-2.0 ★ 141 обновлён 2026-11-17

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/principles.md
Открыть на GitHub

Что делает principles

Правило внедряет стандарты разработки, ориентированные на композицию, доступность и производительность. Оно диктует предпочтение нативной семантике HTML и отказ от избыточных зависимостей ради уменьшения размера бандла. Каждое решение по архитектуре проверяется на прозрачность реализации, удобство стилизации через CSS-переменные и наличие документации JSDoc.

Интеграция дисциплинирует процесс написания UI, исключая создание монолитных или «чёрных ящиков». В процессе работы над проектом агент обращается к этому файлу при создании новых компонентов, обеспечивая соблюдение базовых принципов доступности и поддержки клавиатурной навигации.

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

  • предотвратить создание монолитных компонентов
  • обеспечить доступность интерфейса по умолчанию
  • упростить поддержку и стилизацию кода
  • снизить количество лишних зависимостей

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

  • Используй принципы из правил при рефакторинге формы авторизации.
  • Проверь этот компонент на соответствие правилу composability.
  • Примени стандарты accessibility при обновлении модального окна.

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

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

.claude/rules/principles.md

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

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

Вопросы о principles

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

Скопируй содержимое правила в файл .claude/rules/principles.md внутри проекта.

Что делает principles?

Оно задаёт обязательные архитектурные требования к компонентам, делая их компонуемыми, доступными и производительными.

На что опирается правило в работе?

На использование семантического HTML, отказ от переусложнённых HOC и соблюдение стандартов оформления кода через JSDoc.

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

principles.md · Apache-2.0
---
title: Core Component Principles
impact: HIGH
impactDescription: Foundation of component architecture decisions
tags: principles, composability, accessibility, customization, performance, transparency, dx
---

## Core Component Principles

These six principles guide all component design decisions. Apply them consistently when building, refactoring, or evaluating components.

### 1. Composability and Reusability

Favor composition over inheritance. Build components that combine and nest to create complex UIs.

**Incorrect (monolithic, hard to customize):**

```tsx
<Accordion data={data} />
```

**Correct (composable, each layer customizable):**

```tsx
<Accordion.Root open={open} onOpenChange={setOpen}>
  {items.map((item) => (
    <Accordion.Item key={item.id}>
      <Accordion.Trigger>{item.title}</Accordion.Trigger>
      <Accordion.Content>{item.content}</Accordion.Content>
    </Accordion.Item>
  ))}
</Accordion.Root>
```

### 2. Accessible by Default

Components must be usable by all users. Accessibility is not optional—it's a baseline feature.

**Incorrect (generic div with click handler):**

```tsx
<div onClick={handleClick} className="button">
  Click me
</div>
```

**Correct (semantic button element):**

```tsx
<button onClick={handleClick}>Click me</button>
```

Best practices:

- Use semantic HTML (`<button>`, `<ul>/<li>`, `<nav>`, etc.)
- Provide proper ARIA roles, states, and properties
- Support keyboard navigation for all interactive elements
- Ensure focus management in modals, dropdowns, and overlays

### 3. Customizability and Theming

Components should be easy to restyle or adapt to different design requirements.

**Correct (design tokens and className override):**

```tsx
export function Button({ className, ...props }: ButtonProps) {
  return <button className={cn("base-button-styles", className)} {...props} />;
}
```

Best practices:

- Use CSS variables (design tokens) for colors, spacing, typography
- Always allow `className` prop for style overrides
- Provide sensible default styling
- Avoid hard-coded colors, fonts, or spacing values

### 4. Lightweight and Performant

Components should be lean in terms of assets and dependencies.

**Incorrect (heavy dependency for simple task):**

```tsx
import { entireDateLibrary } from "heavy-date-lib";
```

**Correct (native APIs or lightweight alternatives):**

```tsx
const formatDate = (date: Date) => date.toLocaleDateString();
```

Best practices:

- Keep bundle size minimal
- Use tree-shaking friendly imports
- Lazy load heavy features when possible
- Optimize for initial render performance

### 5. Transparency and Code Ownership

Components should not be black boxes. Developers should be able to inspect and modify them.

**Correct (clear, readable implementation):**

```tsx
export function Button({ children, onClick, ...props }: ButtonProps) {
  return (
    <button onClick={onClick} {...props}>
      {children}
    </button>
  );
}
```

**Incorrect (obfuscated or overly complex):**

```tsx
export const Button = compose(withHOC1, withHOC2, withHOC3)(BaseButton);
```

### 6. Well-documented and DX-Friendly

Components should come with clear documentation and examples.

**Correct (comprehensive JSDoc):**

```tsx
/**
 * Button component for primary actions.
 *
 * @example
 * <Button variant="primary" onClick={handleClick}>Click me</Button>
 *
 * @remarks
 * - Supports keyboard navigation (Enter/Space)
 * - Accessible by default with proper ARIA attributes
 */
export function Button({ ... }: ButtonProps) { }
```

A well-designed component applies all six principles together: **Composes** with other components, **works for everyone** with proper accessibility, **adapts** to different designs via theming, **performs** efficiently, **can be inspected** and modified, and **is easy to learn** through documentation.

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →
Animation Principles - Intermediate dylantarre Скилл Animation Principles - Intermediate помогает связывать классические принципы анимации в сложных сценах. Он пригодится, когда базовые правила уже понятны, но движения разваливаются. CX Codex +1 560установок design-motion-principles kylezantos Скилл design-motion-principles для Claude Code создаёт анимацию интерфейсов и проверяет уже готовую. Запускается на задачах с переходами, наведением и микровзаимодействиями. CX Codex +1 14 500установок motion-principles AThevon Скилл motion-principles для Claude Code и других платформ: кодирует анимации на web и мобильных платформах с готовыми правилами тайминга, easing и доступности. CX Codex +1 1 200установок mobile-principles AThevon Скилл mobile-principles для Claude Code задаёт принципы мобильного UX. Подключается, когда агент распознаёт мобильную задачу для веба, iOS или Android. CX Codex +1 990установок ux-principles manutej Скилл ux-principles подключает к агенту эвристики юзабилити, методы юзер-ресёрча и проверки доступности, чтобы интерфейсы проектировались по правилам, а не на глаз. CX Codex +1 840установок ui-ux-design-principles databricks-solutions Скилл ui-ux-design-principles для Claude Code: канон решений о пользовательском опыте — чек-лист ревью, жёсткие правила и ссылки на детали. Закрывает строки перед мержем интерфейса или при проверке чужого. CX Codex +1 ★ 38звёзд репо

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

Весь набор →
composition Правило composition для Claude Code помогает разбивать крупные UI-компоненты на небольшие субагенты с четкими задачами. Оно применяется при проектировании библиотек и сложных интерфейсов. CX Codex +1 ★ 141звёзд репо overview Правило overview для Claude Code задаёт принципы создания доступных и составных UI-компонентов. Оно подключается при проектировании компонентов и их API. CX Codex +1 ★ 141звёзд репо types Правило types для Claude Code стандартизирует описание пропсов компонентов в TypeScript. Оно задаёт архитектуру для создания гибких и типизированных интерфейсов в React-проектах. CX Codex +1 ★ 141звёзд репо data-attributes Правило data-attributes для Claude Code задаёт паттерны data-state и data-slot для стилизации состояний и связи компонентов. CX Codex +1 ★ 141звёзд репо as-child Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов. CX Codex +1 ★ 141звёзд репо documentation Правило documentation для Claude Code задаёт единый стандарт описания компонентов интерфейса. Ассистент оформляет справку со свойствами, примерами и требованиями доступности. CX Codex +1 ★ 141звёзд репо state Правило state для Claude Code задаёт паттерны управляемого и неуправляемого состояния React-компонентов. Оно включается при проектировании API компонентов. CX Codex +1 ★ 141звёзд репо accessibility Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG. CX Codex +1 ★ 141звёзд репо

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

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