Правила Kodik

Правила Kodik — это постоянные инструкции, которые включаются в системный промпт агента при каждом разговоре. Используйте их, чтобы задать стиль кода, требования к документации, соглашения о паттернах или любые другие предпочтения для конкретного проекта или глобально.

Где хранятся правила

Правила рабочего пространства

Используйте директорию .kodik/rules/ в корне проекта. Она может содержать любое количество .md-файлов; Kodik рекурсивно читает их и объединяет в единый набор правил. Файлы сортируются по имени, поэтому числовые префиксы (01-coding.md, 02-docs.md) позволяют управлять порядком.

Пример структуры папки:

your-project/
.kodik/
├── rules/
│   ├── 01-coding.md
│   ├── 02-documentation.md
│   └── current-sprint.md

Глобальные правила

Глобальные правила хранятся в ~/.kodik/rules/ на Linux, macOS и Windows (в домашней директории текущего пользователя). Kodik рекурсивно читает все .md-файлы внутри неё.

Правила workspace разрешаются из точного workspace, выбранного chat-сессией. До предоставления доверия этому workspace они неактивны и доступны только для чтения. Правила в .agents не поддерживаются как источник совместимости.

Ссылочные директории .kodik и rules, а также ссылочные файлы правил отображаются как неактивные: Kodik не загружает их в промпт агента и не изменяет. Чтобы Kodik мог использовать и управлять ими, скопируйте содержимое в обычную lowercase-директорию .kodik/rules/.

Правила плагинов

Установленные и включённые плагины могут предоставлять собственные правила. Они добавляются в системный промпт автоматически под заголовком # Plugin Rules — редактировать их не нужно. Отключение плагина убирает его правила.

Включение и отключение правил

Каждый файл правил можно включить или отключить отдельно через всплывающую панель под полем ввода чата. Панель показывает:

Глобальные правила (из пользовательских настроек)
Правила рабочего пространства (из .kodik/rules/ текущего проекта)

Одним кликом можно включать только нужные правила — например, react-rules.md при работе с React-компонентами или memory-bank.md при работе с банком памяти. Изменения применяются к следующему запросу.

Создание правила

Нажмите кнопку + на вкладке Правил, и просто объясните Kodik, что именно должна делать эта правило, и он создаст её для вас и автоматически появится в списке активных правил.

Советы по написанию эффективных правил

Конкретика важнее общих слов. Вместо «пиши хороший код» — «все публичные функции должны иметь JSDoc-комментарии».
Держите файлы сфокусированными. Один файл — одна область (например, стиль кода, тестирование, документация).
Избегайте избыточности. Правила занимают место в системном промпте; длинные или дублирующие правила снижают качество ответов.
Итерируйте. Проверяйте, как правила влияют на ответы агента, и уточняйте формулировки.

Пример структуры правила

# Руководство по проекту

## Стиль кода

- Предпочитать функциональные компоненты классам (React)
- Все функции должны иметь JSDoc-комментарии
- Использовать `const` везде, где возможно

## Тестирование

- Юнит-тесты обязательны для бизнес-логики
- Интеграционные тесты для API-эндпоинтов

## Документация

- Обновлять `/docs` при изменении публичного API
- Вести записи в CHANGELOG.md

Связь с AGENTS.md

Файл AGENTS.md — это отдельный механизм, дополняющий правила. Он описывает высокоуровневую архитектуру, соглашения и запуск команд для агентов. Правила .kodik/rules лучше подходят для детальных инструкций по стилю; AGENTS.md — для архитектурного контекста.