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

definitions — правило для Claude Code: термины UI и установка

Правило definitions для Claude Code классифицирует UI-артефакты и задаёт точные названия для компонентов, блоков, шаблонов и паттернов.

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

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

Что делает definitions

Правило definitions разделяет UI-артефакты по роли: primitive отвечает за поведение и доступность без стилей, component добавляет оформление, pattern описывает повторяемое решение, а block собирает законченную композицию для конкретного сценария. Page означает представление одного маршрута, template объединяет несколько страниц, а utility содержит невизуальную логику.

Внутри есть схема классификации и примеры на React с Props API, children/slots, render prop, controlled и uncontrolled-состояниями, provider/context, portal, headless-подходом, вариантами и design tokens. Правило также разбирает ошибочное обозначение стилизованного диалога как primitive: стили переводят его в component. Для Claude Code файл нужно разместить по пути .claude/rules/definitions.md.

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

  • различить primitive и стилизованный component
  • назвать UI-артефакт по его роли в интерфейсе
  • отделить block от page и template
  • описать невизуальную логику как utility

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

  • Классифицируй этот UI-элемент как primitive, component, block, page или template.
  • Проверь, правильно ли назван стилизованный диалог в Dialog.tsx.
  • Определи, какие элементы здесь относятся к pattern и utility.

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

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

.claude/rules/definitions.md

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

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

Вопросы о definitions

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

Создайте правило по пути .claude/rules/definitions.md и поместите туда содержимое definitions.

Что делает definitions?

Правило задаёт термины для UI-артефактов и помогает различать primitive, component, pattern, block, page, template и utility по их роли, стилям и уровню композиции.

Чем primitive отличается от component в definitions?

Primitive содержит поведение и доступность без оформления. Component добавляет визуальные стили или объединяет несколько элементов; стилизованный диалог относится к component.

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

definitions.md · Apache-2.0
---
title: Component Artifact Definitions
impact: MEDIUM
impactDescription: Essential for correct component classification
tags: definitions, primitive, component, block, template, pattern, utility, terminology
---

## Component Artifact Definitions

Precise terminology for classifying and naming UI artifacts.

### Primitive (Unstyled Component)

The **lowest-level building block** providing behavior and accessibility without styling. Completely headless.

```tsx
// Primitive - behavior only, no styling
function DialogPrimitive({ open, onOpenChange, children }) {
  return (
    <Dialog.Root open={open} onOpenChange={onOpenChange}>
      {children}
    </Dialog.Root>
  );
}
```

**Examples:** Radix UI Primitives, React Aria Components, Headless UI

### Component

A **styled, reusable UI unit** that adds visual design to primitives or composes multiple elements.

```tsx
// Component - styled and reusable
function Button({ variant = "primary", size = "md", children, ...props }) {
  return (
    <button
      className={cn("base-button-styles", variants[variant], sizes[size])}
      {...props}
    >
      {children}
    </button>
  );
}
```

**Examples:** shadcn/ui components, Material UI, Ant Design

### Pattern

A **specific composition** solving a UI/UX problem. Documentation-focused, not a reusable component.

**Examples:** Form validation with inline errors, confirming destructive actions, typeahead search

### Block

An **opinionated, production-ready composition** solving a concrete interface use case.

```tsx
// Block - complete, opinionated composition
function PricingTable({ plans, onSelectPlan }) {
  return (
    <div className="pricing-table">
      {plans.map((plan) => (
        <Card key={plan.id}>
          <Card.Header>
            <Card.Title>{plan.name}</Card.Title>
          </Card.Header>
          <Card.Content>
            <div className="price">{plan.price}</div>
          </Card.Content>
          <Card.Footer>
            <Button onClick={() => onSelectPlan(plan.id)}>Select Plan</Button>
          </Card.Footer>
        </Card>
      ))}
    </div>
  );
}
```

**Examples:** Pricing table, auth screens, onboarding stepper, AI chat panel

### Page

A **complete, single-route view** composed of multiple blocks.

```tsx
function LandingPage() {
  return (
    <Layout>
      <HeroBlock />
      <FeaturesBlock />
      <PricingBlock />
      <FooterBlock />
    </Layout>
  );
}
```

### Template

A **multi-page collection** or full-site scaffold bundling pages, routing, layouts, and providers.

**Examples:** SaaS starter, e-commerce template, dashboard starter

### Utility (Non-visual)

A **helper** for developer ergonomics or composition; not rendered UI.

```tsx
function useControllableState({ prop, defaultProp, onChange }) {
  const [state, setState] = useState(defaultProp);
  const value = prop !== undefined ? prop : state;
  const setValue = (newValue) => {
    if (prop === undefined) setState(newValue);
    onChange?.(newValue);
  };
  return [value, setValue];
}
```

**Examples:** React hooks, class utilities, keybinding helpers, focus scopes

### Classification Decision Flow

1. **Behavior/a11y only, no styling?** → **Primitive**
2. **Styled, reusable UI element?** → **Component**
3. **Concrete product use case with opinionated composition?** → **Block**
4. **Multi-page scaffold with routing/providers?** → **Template**
5. **Documentation of recurring solution?** → **Pattern**
6. **Non-visual logic?** → **Utility**

### Common Classification Mistakes

**Incorrect (mislabeling a styled component as a primitive):**

```tsx
// Wrong: This is styled, so it's a Component, not a Primitive
function DialogPrimitive({ open, onOpenChange, children }) {
  return (
    <Dialog.Root open={open} onOpenChange={onOpenChange}>
      <Dialog.Content className="rounded-lg border bg-white p-6 shadow-lg">
        {children}
      </Dialog.Content>
    </Dialog.Root>
  );
}
```

**Correct (proper classification based on styling presence):**

```tsx
// Primitive - behavior only, no styling
function DialogPrimitive({ open, onOpenChange, children }) {
  return (
    <Dialog.Root open={open} onOpenChange={onOpenChange}>
      {children}
    </Dialog.Root>
  );
}

// Component - styled wrapper around primitive
function Dialog({ open, onOpenChange, children }) {
  return (
    <DialogPrimitive open={open} onOpenChange={onOpenChange}>
      <Dialog.Content
        className={cn("rounded-lg border bg-white p-6 shadow-lg")}
      >
        {children}
      </Dialog.Content>
    </DialogPrimitive>
  );
}
```

### Key Vocabulary

- **Props API** - Public configuration surface, typed and documented
- **Children/Slots** - Placeholders for caller-provided structure
- **Render Prop** - Function child delegating rendering
- **Controlled** - Value driven by props (parent is source of truth)
- **Uncontrolled** - Internal state with optional `defaultValue`
- **Provider/Context** - Supplies shared state to subtree
- **Portal** - Rendering outside DOM hierarchy for layering
- **Headless** - Behavior without styling
- **Styled** - Ships with default visual design
- **Variants** - Style/behavior permutations via props
- **Design Tokens** - Named values for theming

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →
react-bits Philotheephilix Скилл react-bits для Claude Code добавляет анимированные компоненты, текстовые эффекты и фоны WebGL/canvas в проекты React. Он запускается, когда нужно получить актуальный код компонентов React Bits из публичного реестра. CX Codex +1 617установок variant jakubkrehel Скилл variant для Claude Code создаёт несколько вариантов одного UI-компонента и выводит их в переключатель на реальной странице. Он включается по прямой просьбе исследовать конкретный элемент интерфейса. CX Codex +1 22 400установок state-machine jakubkrehel Скилл state-machine для Claude Code выводит состояния выбранного компонента на временную страницу с тестовыми данными и переключателем. Агент запускает его по явной просьбе. CX Codex +1 11 400установок icons Devin-AXIS Правило icons стандартизирует импорты иконок из конфигурации проекта и запрещает ручные размеры в компонентах. Нужно, чтобы все иконки в проекте подтягивались из одной библиотеки и выглядели согласованно. CX Codex +1 ★ 7 523звёзд репо image-to-ui UIZZE Скилл image-to-ui для Claude Code превращает скриншоты, макеты и эскизы в код интерфейса, рендерит его и сравнивает с оригиналом, чтобы исправить различия. CX Codex +1 138 900установок baseline-ui ibelick Скилл baseline-ui для Claude Code задаёт правила для чистки UI-кода. Запускается для правок интерфейса или проверки конкретного файла. CX Codex +1 27 000установок

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

Весь набор →
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звёзд репо polymorphism Правило polymorphism для Claude Code задаёт полиморфные React-компоненты с единым стилем и поведением. HTML-элемент меняется через проп as. CX Codex +1 ★ 141звёзд репо styling Правило styling для Claude Code задаёт стандарты вёрстки компонентов на Tailwind CSS. Направляет агента объединять классы через tailwind-merge, clsx и CVA. CX Codex +1 ★ 141звёзд репо components-build Скилл components-build для Claude Code помогает создавать, проверять и перерабатывать переиспользуемые компоненты React по спецификации components.build. Он подключается к задачам об API компонентов, доступности, стилях и типах TypeScript. CX Codex +1 ★ 141звёзд репо otto-design Скилл otto-design для Claude Code задаёт процесс проектирования интерфейсов Otto в Paper перед сборкой в SwiftUI. Включается при запросах на мокапы, редизайн или изменение экранов и карточек приложения. CX Codex +1 ★ 141звёзд репо

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

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