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

Правила

Как работать в вашем проекте — команды сборки, стиль, запреты. Агент читает правила сам перед работой.

Открыть как Markdown

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

AGENTS.md

Самый простой способ — файл AGENTS.md в корне проекта. Агент читает его в каждом чате.

AGENTS.md
# Магазин цветов

- Пакетный менеджер — bun. Перед коммитом: `bun run check`.
- Цены храним в копейках, показываем в рублях.
- Тексты для покупателей — на «вы», без восклицательных знаков.
- Не трогай `src/payments/legacy` — его заменяет `src/payments/gateway`.

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

Если в проекте уже есть CLAUDE.md, импорт перенесёт его в AGENTS.md.

Файлы правил

Для правил, которые нужны не всегда, используйте отдельные файлы .mdc в папке .razum/rules/:

.razum/rules/database.mdc
---
description: Миграции и запросы к базе данных
globs: db/**/*.ts
alwaysApply: false
---

- Каждая миграция обратима: пиши и `up`, и `down`.
- Запросы — только через `db/query.ts`, без сырого SQL в обработчиках.
ПолеЗначение
alwaysApply: trueПравило действует в каждой задаче
globsПравило подключается, когда агент работает с подходящими файлами
descriptionПо описанию агент решает, нужно ли правило в этой задаче

Свои правила для всех проектов

Правила в ~/.razum/rules/ действуют во всех проектах на этом компьютере — например, «отвечай по-русски» или «не используй сокращения в именах». Если у правила проекта и вашего одинаковое имя, побеждает правило проекта.

Где их видно и как создать

Все правила — в меню «+» поля ввода → «Правила». Создать правило можно попросив агента:

Создай правило для этого проекта: все даты в интерфейсе показываем в формате ДД.ММ.ГГГГ.

Правила сотрудника — это другое

Сотрудник запоминает правила из разговора с вами — они хранятся в его роли, а не в файлах. → Роль и память

На странице