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