Claude Rules
lifedever/claude-rulesБиблиотека шаблонов стандартов кодирования для AI-ассистентов. Автоматически определяет технологический стек и генерирует файл правил из слоёв base + language + framework. Совместима с Claude Code, Cursor, Antigravity, GitHub Copilot.
Установка
git clone https://github.com/lifedever/claude-rules.gitREADME
Claude Rules
English | 中文
Библиотека шаблонов стандартов кодирования для AI-ассистентов. Комбинируйте слои base + language + framework, чтобы сгенерировать файл правил для конкретного проекта — это позволяет поддерживать чистоту и единообразие кода, создаваемого AI.
Проблема
AI-ассистенты склонны копировать стиль существующего кода в legacy-проектах — включая плохие практики. Основной принцип этой библиотеки:
Не имитируй legacy-код. Рефакторь согласно стандартам.
Каждое правило — конкретная, применимая на практике директива (без расплывчатых формулировок вроде «используй правильный XX»), с примерами сравнения «Плохо / Хорошо».
Структура директорий
claude-rules/
├── base/ # Универсальный слой (обязательный)
│ ├── core.md # Базовые принципы: отношение к legacy-коду, метрики качества, именование, архитектура
│ └── git.md # Соглашения по сообщениям Git-коммитов
│
├── languages/ # Выбери по языку
│ ├── typescript.md # Без any/enum/barrel exports, as const, import type
│ ├── javascript.md # ES2022+, JSDoc-аннотации типов, только ESM
│ ├── java.md # Java 17+: record/sealed/pattern matching, Optional
│ ├── kotlin.md # Null safety, структурный параллелизм, sealed class
│ ├── swift.md # guard let, async/await, actor, Protocol
│ ├── python.md # ruff, аннотации типов, Protocol, uv/poetry
│ ├── html.md # Семантические теги, доступность, без div soup
│ ├── css.md # Custom properties, Flexbox/Grid, BEM, современные возможности
│ ├── go.md # Оборачивание ошибок, маленькие интерфейсы, структурный параллелизм
│ └── rust.md # Владение/заимствование, thiserror/anyhow, итераторы, Clippy
│
└── frameworks/ # Выбери по фреймворку
├── vue.md # script setup, ref vs reactive, паттерны composable
├── react.md # Правила хуков, корректный useEffect, слои состояния
├── swiftui.md # @Observable (не устаревший ObservableObject), SwiftData
├── springboot.md # Слоистая архитектура, DTO, глобальная обработка исключений
└── tauri.md # Дизайн команд, инкапсуляция сервисов, конфигурация безопасности
Трёхслойная архитектура
┌─────────────────────────────────────────────┐
│ base (обязательный) │ core.md + git.md
│ Отношение к legacy / Метрики качества / │ Применяется ко всем проектам
│ Именование / Архитектура │
├─────────────────────────────────────────────┤
│ language (на выбор) │ typescript.md / java.md / ...
│ Система типов / Соглашения по именованию / │ По языку проекта
│ Языковые возможности │
├─────────────────────────────────────────────┤
│ framework (на выбор) │ vue.md / react.md / ...
│ Стандарты компонентов / Управление │ По фреймворку проекта
│ состоянием / Архитектурные паттерны │
└─────────────────────────────────────────────┘
Приоритет правил: framework > language > base (более конкретные правила перекрывают общие)
Использование
Claude Code Plugin (рекомендуется)
Установка
# Шаг 1: Добавь маркетплейс
claude plugin marketplace add lifedever/claude-rules
# Шаг 2: Установи плагин
claude plugin install init-claude-rules@claude-rules
# Шаг 3: Перезапусти Claude CodeИспользование
Открой любой проект в Claude Code и выполни:
/init-rules
Плагин выполнит следующее:
- Автоматически определит технологический стек проекта (TypeScript, Vue, React и т.д.)
- Попросит подтвердить обнаруженный стек
- Прочитает подходящие файлы правил из плагина
- Сгенерирует
CLAUDE.mdв корне проекта
Обновление
Когда в upstream добавляются новые правила, обнови локальный кэш:
claude plugin marketplace update claude-rules
Затем перезапусти Claude Code. Чтобы применить обновлённые правила к проекту, в котором уже есть CLAUDE.md, снова выполни /init-rules — плагин спросит подтверждение перед перезаписью.
Удаление
claude plugin uninstall init-claude-rules@claude-rules
claude plugin marketplace remove claude-rulesРучное использование
Склонируй репозиторий и объедини нужные файлы правил:
git clone https://github.com/lifedever/claude-rules.git
cd claude-rules
# Пример: проект Vue 3 + TypeScript
cat base/core.md base/git.md languages/typescript.md frameworks/vue.md > /path/to/project/CLAUDE.mdПравила написаны на обычном Markdown и работают с любым AI-инструментом. Просто помести результат туда, где его ожидает твой инструмент:
| Инструмент | Целевой файл |
|---|---|
| Claude Code | CLAUDE.md |
| Cursor | .cursorrules или .cursor/rules/*.mdc |
| Antigravity | .antigravity/rules.md |
| GitHub Copilot | .github/copilot-instructions.md |
Принципы дизайна
- Применимость — каждое правило напрямую исполняемо AI, без расплывчатых формулировок
- Примеры — ключевые правила включают сравнение кода «Плохо» и «Хорошо»
- Количественность — функции ≤30 строк, файлы ≤300 строк, вложенность ≤3 уровней, параметры ≤4
- Актуальность — используются современные API для каждого языка/фреймворка (
@Observable,record,as constи т.д.) - Конкретность — вместо «обрабатывай ошибки правильно» указывается точный способ их обработки
Участие в разработке
PR с новыми языками или фреймворками приветствуются. Пожалуйста, соблюдай следующие требования:
- Правила должны быть конкретными и применимыми — без формулировок «используй подходящий/правильный»
- Ключевые правила должны включать примеры кода (плохая практика + хорошая практика)
- Рекомендуй современные идиомы — не документируй устаревшие API
- Пиши на английском языке