definitions — правило для Claude Code: термины UI и установка
Правило definitions для Claude Code классифицирует UI-артефакты и задаёт точные названия для компонентов, блоков, шаблонов и паттернов.
Apache-2.0 ★ 141 обновлён 2026-11-17
.claude/rules/definitions.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/definitions.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/definitions.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/definitions.mdВручную: положить файлы
.clinerules/definitions.mdПо шагам, с командами для каждой платформы: 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