Глоссарий
Инструкционный файл (AGENTS.md, CLAUDE.md): правила для кодинг-агента
Коротко: Инструкционный файл это текстовый файл в корне проекта (AGENTS.md, CLAUDE.md, .cursorrules), который кодинг-агент читает перед началом работы: там живут правила сборки, конвенции кода, ссылки на документацию. Файл доезжает до модели как инструкция с высоким приоритетом, поэтому устаревшая строка в нём перешибает живой код: в замере на 40 проектах агенты следовали протухшему файлу в 90% выборов, даже замечая конфликт. Лечение двоится: фраза о приоритете кода над конвенциями в пользовательском файле плюс регулярная ревизия содержимого. Чем короче файл, тем меньше у него шансов разойтись с кодом.
Наш рабочий минимум: в каждом инструкционном файле одна фраза о приоритете кода над конвенциями, а всё, что проверяется механически (стиль, импорты, типы), живёт в линтере, а не в прозе. Файл отвечает на «почему» и «куда», линтер на «как». Конфликт между ними при такой развязке не возникает.