| Уровень | ⚙️ рабочая |
| Время | ~1 час, плюс неделя наблюдений |
| Понадобится | проект, в котором вы работаете не первый день, и агент, который в нём живёт |
| Качает | управлять контекстом: описать проект один раз вместо того, чтобы объяснять каждую сессию |
Заведите в своём проекте файл контекста — CLAUDE.md, AGENTS.md или тот,
который подхватывает ваш инструмент, — и добейтесь, чтобы он менял
поведение агента. Не «есть файл», а «до файла было так, после стало иначе».
Проверять будем экспериментом, а не ощущением.
Файл должен отвечать на то, чего в коде нет: чем занят проект, какие команды
запускают сборку и тесты, какие соглашения не выводятся из чтения кода, чего
делать нельзя и почему.
Захочется описать структуру проекта. Это самая частая ошибка: каталоги и
функции уже есть в репозитории и устаревают на первой же правке. Устаревший
файл контекста хуже отсутствующего — он врёт уверенно, и модель верит ему
больше, чем коду.
Файл вырастет до десяти страниц. Тогда его читают по диагонали и вы, и
модель, а платите вы за него в каждой сессии. Режьте.
Получится список благих намерений. «Писать чистый код», «следовать
лучшим практикам» — это ноль информации. Работают только конкретные, ваши,
проверенные граблями правила.
Разницы не будет видно. Три причины, в порядке частоты: инструмент не
подхватывает этот файл (проверьте, какое имя он ждёт); задача была подобрана
так, что нарушить соглашение негде; правило написано слишком обтекаемо.
Спросите у агента прямо, видит ли он файл и что в нём написано.
Файл начнёт устаревать через месяц. Обязательно начнёт. Лечится одним:
меняется соглашение — правится файл в том же коммите.