AI-агент (программа, которая сама пишет код по твоим запросам) — мощный инструмент. Но без инструкций он делает как считает нужным. Правила превращают его из непредсказуемого помощника в управляемого специалиста.
Без правил агент:
• Каждый раз "знакомится" с проектом заново — тратит время и твои деньги
• Принимает решения сам, не спрашивая тебя
• Может менять стиль кода от сессии к сессии
• Делает 5 попыток там, где с правилами хватило бы одной
С правилами агент — это предсказуемый специалист, который помнит договорённости и работает так, как ты решил.
Что это: обычный текстовый файл (формат Markdown — простая разметка с заголовками и списками), который лежит в корневой папке (главная папка) твоего проекта. Агент читает его автоматически при каждом запуске.
Что писать внутри:
• Кто ты — "я не программист, объясняй простым языком"
• Как общаться — "коротко, без воды, на русском"
• Что можно и нельзя — "не меняй архитектуру без спроса"
• Стек проекта (какие технологии используются) — "React + Go + PostgreSQL"
• Договорённости — "коммиты (сохранения в историю) на английском"
Как начать:
Скопируй готовый шаблон из материалов, замени примеры на свои данные, дополняй по мере работы. Не пытайся написать идеальный файл сразу — он будет расти вместе с проектом.
Что внутри:
• Словарь — переводчик с твоего языка на код. "Скринер" = файл screener.tsx. "Графики" = папка charts/. Ты говоришь "поправь скринер", агент сразу знает какой файл открыть.
• Модули — что где лежит. "Бэкенд (серверная часть) в папке /api, фронтенд (то, что видит пользователь) в /src".
• Горячие файлы — файлы, которые чаще всего редактируются и ломаются.
Список задач с приоритетами и зависимостями (какая задача должна быть сделана раньше другой). Агент знает что делать следующим и что уже сделано — не нужно каждый раз объяснять контекст.
Зачем:
• Агент не предложит задачу, зависимость которой ещё не готова
• Ты видишь прогресс — что закрыто, что в работе, что впереди
• При смене сессии агент продолжает с того места, где остановился
Что менялось, когда, зачем. Это не для красоты — это страховка. Когда ты открываешь проект через неделю и не помнишь что было сделано, CHANGELOG расскажет всё.
Что даёт:
• Не теряешь контекст между сессиями — открыл, прочитал последние записи, работаешь дальше
• Если что-то сломалось — видишь когда и какие изменения были перед этим
• Агент сам ведёт дневник, тебе не нужно писать руками
CLAUDE.md в папке проекта — это правила для конкретного проекта. Но есть вещи, которые одинаковы везде: твой стиль общения, язык, базовые запреты. Чтобы не копировать их в каждый проект, существует глобальный CLAUDE.md.
Он лежит в специальной папке ~/.claude/CLAUDE.md (символ ~ означает "домашняя папка пользователя" — это системная папка, у каждого пользователя компьютера своя). Написал один раз — агент помнит это во всех проектах.
Что писать в глобальном:
• "Я не программист, объясняй простым языком" — работает везде
• "Русский язык, код на английском" — работает везде
• "Не коммить без подтверждения" — работает везде
Что писать в проектном:
• Стек конкретного проекта, структура папок, специфичные договорённости
Шаг 1. Создай CLAUDE.md в папке проекта. Напиши кто ты, на каком языке общаться, что нельзя делать. Хватит 10 строк.
Шаг 2. Поработай неделю. Заметишь, что агент повторяет одни и те же ошибки — добавь правило. Забывает структуру проекта — создай PROJECT-MAP.md.
Шаг 3. Когда задач станет больше трёх — заведи ROADMAP.md. Агент будет сам предлагать следующую задачу.
Шаг 4. Когда заведёшь второй проект — вынеси общие правила в глобальный ~/.claude/CLAUDE.md.
Главное правило: правила — это живой документ. Он не должен быть идеальным с первого дня. Добавляй то, что реально мешает работе, убирай то, что не работает.