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

steering-principles — правило для Claude Code

Правило steering-principles задаёт стандарты файлов памяти проекта: фиксирует паттерны и архитектуру без перегрузки агента полными списками файлов.

MIT ★ 3 774 обновлён 2026-10-22

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

Что делает steering-principles

Правило определяет steering-файлы как память проекта, а не исчерпывающую спецификацию. Если новый код следует существующим паттернам, файлы памяти обновлять не нужно. Документ требует фиксировать только архитектурные решения и правила именования, запрещая превращать контекст в покомпонентные каталоги.

Под требования попадают файлы product.md, tech.md, structure.md и специализированные заметки. В них запрещено хранить пароли, ключи API или внутренние IP. Каждый файл должен закрывать одну тему, укладываться в диапазон 100-200 строк и содержать конкретные примеры кода.

Обновление файлов строится по аддитивному принципу. Пользовательские секции нельзя стирать при автоматической перезаписи. Каждая правка сопровождается пометкой updated_at и причиной изменений. Служебные каталоги вроде .cursor/ или .claude/ исключаются из описания проекта.

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

  • Ограничить разрастание контекстных файлов проекта лимитом 100-200 строк
  • Зафиксировать архитектурные решения без перечисления каждого файла кодовой базы
  • Предотвратить попадание ключей API и внутренних сетевых адресов в память проекта
  • Сохранить ручные правки разработчика при автообновлении файлов контекста

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

  • Создай файл structure.md по правилам steering-principles для нашего проекта
  • Проверь tech.md на соответствие памяти проекта и сократи списки библиотек
  • Обнови product.md аддитивно, сохрани мои заметки и выставь метку updated_at

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

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

.claude/rules/steering-principles.md

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

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

Вопросы о steering-principles

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

Создайте файл правила и добавьте инструкции по пути .claude/rules/steering-principles.md.

Что делает steering-principles?

Оно задаёт правила ведения файлов контекста, заставляя описывать высокоуровневые соглашения вместо каталогов компонентов.

Какой размер файлов рекомендует это правило?

Стандартный объём одного файла составляет от 100 до 200 строк текста с обязательными примерами кода.

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

steering-principles.md · MIT
# Steering Principles

Steering files are **project memory**, not exhaustive specifications.

---

## Content Granularity

### Golden Rule
> "If new code follows existing patterns, steering shouldn't need updating."

### ✅ Document
- Organizational patterns (feature-first, layered)
- Naming conventions (PascalCase rules)
- Import strategies (absolute vs relative)
- Architectural decisions (state management)
- Technology standards (key frameworks)

### ❌ Avoid
- Complete file listings
- Every component description
- All dependencies
- Implementation details
- Agent-specific tooling directories (e.g. `.cursor/`, `.gemini/`, `.claude/`)
- Detailed documentation of `.kiro/` metadata directories (settings, automation)

### Example Comparison

**Bad** (Specification-like):
```markdown
- /components/Button.tsx - Primary button with variants
- /components/Input.tsx - Text input with validation
- /components/Modal.tsx - Modal dialog
... (50+ files)
```

**Good** (Project Memory):
```markdown
## UI Components (`/components/ui/`)
Reusable, design-system aligned primitives
- Named by function (Button, Input, Modal)
- Export component + TypeScript interface
- No business logic
```

---

## Security

Never include:
- API keys, passwords, credentials
- Database URLs, internal IPs
- Secrets or sensitive data

---

## Quality Standards

- **Single domain**: One topic per file
- **Concrete examples**: Show patterns with code
- **Explain rationale**: Why decisions were made
- **Maintainable size**: 100-200 lines typical

---

## Preservation (when updating)

- Preserve user sections and custom examples
- Additive by default (add, don't replace)
- Add `updated_at` timestamp
- Note why changes were made

---

## Notes

- Templates are starting points, customize as needed
- Follow same granularity principles as core steering
- All steering files loaded as project memory
- Light references to `.kiro/specs/` and `.kiro/steering/` are acceptable; avoid other `.kiro/` directories
- Custom files equally important as core files

---

## File-Specific Focus

- **product.md**: Purpose, value, business context (not exhaustive features)
- **tech.md**: Key frameworks, standards, conventions (not all dependencies)
- **structure.md**: Organization patterns, naming rules (not directory trees)
- **Custom files**: Specialized patterns (API, testing, security, etc.)

© gotalab · MIT · gotalab/cc-sdd

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

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
webgl-landing-steering MengTo Скилл webgl-landing-steering помогает выбрать визуальное направление, стек Three.js и ограничения производительности для лендинга с WebGL до написания кода. CX Codex +1 2 000установок write-coding-standards-from-file официальный github Скилл write-coding-standards-from-file для GitHub Copilot анализирует файлы проекта и формирует документ со стандартами кода. Выводит правила из существующих примеров. CX Codex +1 9 570установок aidd-context AI-Driven Dev Плагин aidd-context про знания о проекте: онбординг, память проекта, генерация скиллов, агентов, правил и хуков, диаграммы Mermaid. CX Codex +1 ★ 571звёзд репо create-skill siviter-xyz Скилл create-skill для Claude Code помогает создавать и обновлять скиллы для ИИ-агентов. Он подключается к таким просьбам и ведёт по структуре файлов и правилам проектирования. CX Codex +1 2 800установок Animation Principles - Teaching Others dylantarre Скилл Animation Principles - Teaching Others для Claude Code, который помогает объяснять 12 принципов анимации ученикам и коллегам. Разбирает типичные ошибки новичков и даёт готовые формулировки для каждого принципа. CX Codex +1 570установок memory-management aaron-he-zhu Скилл memory-management для Claude Code ведёт рабочую память проекта: сохраняет, находит, объединяет и архивирует заметки. Подключается к запросам о контексте между сессиями и удалении записей. CX Codex +1 1 200установок

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

Весь набор →
design-synthesis Правило design-synthesis для структурированного анализа собранных требований перед написанием design-документа. Три линзы — обобщение, выбор между построением и интеграцией, упрощение — помогают выбрать правильный масштаб решения. CX Codex +1 ★ 3 774звёзд репо tasks-parallel-analysis Правило tasks-parallel-analysis для Claude Code: отмечает в tasks.md задачи, которые можно выполнять параллельно, учитывая зависимости между ними. CX Codex +1 ★ 3 774звёзд репо requirements-review-gate Правило requirements-review-gate останавливает работу и требует отремонтировать черновик требований перед тем, как начать писать requirements.md. Проверяет полноту охвата, формат EARS и структуру. CX Codex +1 ★ 3 774звёзд репо design-review-gate Правило design-review-gate проверяет черновик архитектуры перед формированием design.md. Находит пробелы в спецификациях и связывает каждый пункт требований с файловой структурой. CX Codex +1 ★ 3 774звёзд репо ears-format Правило ears-format задаёт формат EARS для критериев приёмки: условие, система и действие. Пригодится в spec-driven разработке. CX Codex +1 ★ 3 774звёзд репо design-discovery-full Правило design-discovery-full проводит систематическое исследование требований, существующего кода, технологий и рисков перед тем, как начать дизайн. Помогает выбрать архитектуру на основе фактов, а не предположений. CX Codex +1 ★ 3 774звёзд репо design-review Правило design-review оценивает технический дизайн-документ перед началом кодинга и выносит вердикт GO или NO-GO. Ограничивает замечания тремя критическими пунктами со ссылками на требования. CX Codex +1 ★ 3 774звёзд репо cc-sdd-new-agent Скилл cc-sdd-new-agent помогает добавить нового coding-агента в cc-sdd по готовому SOP: от исследования формата до тестов и dry-run. CX Codex +1 ★ 3 774звёзд репо

Ещё в каталоге

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

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