principles — правило для Claude Code: как установить и использовать
Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов.
Apache-2.0 ★ 141 обновлён 2026-11-17
.claude/rules/principles.mdЧто делает principles
Правило внедряет стандарты разработки, ориентированные на композицию, доступность и производительность. Оно диктует предпочтение нативной семантике HTML и отказ от избыточных зависимостей ради уменьшения размера бандла. Каждое решение по архитектуре проверяется на прозрачность реализации, удобство стилизации через CSS-переменные и наличие документации JSDoc.
Интеграция дисциплинирует процесс написания UI, исключая создание монолитных или «чёрных ящиков». В процессе работы над проектом агент обращается к этому файлу при создании новых компонентов, обеспечивая соблюдение базовых принципов доступности и поддержки клавиатурной навигации.
Какие задачи решает
- предотвратить создание монолитных компонентов
- обеспечить доступность интерфейса по умолчанию
- упростить поддержку и стилизацию кода
- снизить количество лишних зависимостей
Примеры запросов агенту
- Используй принципы из правил при рефакторинге формы авторизации.
- Проверь этот компонент на соответствие правилу composability.
- Примени стандарты accessibility при обновлении модального окна.
Как установить principles
Вручную: положить файлы
.claude/rules/principles.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/principles.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/principles.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/principles.mdВручную: положить файлы
.clinerules/principles.mdПо шагам, с командами для каждой платформы: 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