💡 Не только Claude Code. Файл правил — это паттерн «persistent context file», и у него есть общий стандарт: AGENTS.md. Его сами читают Codex, Cursor, GitHub Copilot, Antigravity, Hermes и другие агенты. У Claude Code свой CLAUDE.md, поэтому в нём одна строка @AGENTS.md: она подключает общий файл. Концепция универсальная: контекст лежит в файле, агент читает его при старте сессии.

⚡ Активация

💭 в уме · писать не нужно

Когда ты начинаешь новую сессию с Claude Code — что ты каждый раз объясняешь заново?

Не думай об этом как об «инструкциях». Представь это как годовые кольца дерева: каждый сезон оставляет след прямо в ткани древесины. Засуха, рост, морозы — всё вписано в структуру, не в отдельный архив. Дерево не «помнит» прошлый год — оно им сделано.

Прокрути в голове свою работу с агентом: что из твоего опыта уже «вросло» в структуру проекта? Что пока ещё не закреплено и каждый раз произносится устно, как будто впервые?

👁 Рефлексия

💭 в уме · писать не нужно

Каждый раз объяснять одно и то же — это потеря времени и токенов.

Но есть и обратная проблема: AGENTS.md с тысячей строк хуже, чем короткий — до ~200 строк. Чем длиннее — тем хуже агент следует инструкциям.

Не думай об этом как о «коротком конспекте». Представь себя ткачом у станка: нить основы натянута чётко и напряжённо — именно это натяжение держит всю ткань. Если добавить слишком много нитей сразу, ткань провиснет, петли запутаются.

Разгляди свою сисмодуль памяти: где сейчас натяжение правильное, а где — уже провисает под лишними нитями? Что держит форму, а что разрыхляет структуру?

💡 Концепция

Файлы памяти: три пишешь ты, один — Claude

AGENTS.md — контекст и правила проекта (главный)

Один файл на всё, что агент должен знать в каждой сессии: кто ты, что за проект, как работать и чего не делать. Его читает любой агент. Claude Code подключает его через CLAUDE.md с одной строкой @AGENTS.md.

# AGENTS.md

## Моя роль
[Профиль, экспертиза]

## Проект
[Что это, зачем нужно]

## Стек
- Node.js 18, TypeScript, React

## Структура
- /src — код
- /tests — тесты

## Как запустить
npm install && npm run dev

## Что делегировать
- Написание кода, тесты, документация

## Что решаю сам
- Архитектура, финальный review

## Правила
- Пиши тесты вместе с кодом
- Перед большой правкой покажи план

## Чего избегать
- Не меняй архитектуру без согласования

Лимит: до ~200 строк. Больше — хуже следование.

В большом проекте можно положить отдельный AGENTS.md в подпапку. В Claude Code он работает вместе с CLAUDE.md в той же подпапке (@AGENTS.md); Codex читает AGENTS.md сам. Для первого проекта хватит одного файла в корне.