agent.md: как улучшить качество кода, генерируемого LLM¶
7.0/10
На сайте Фабьена Санглара опубликована статья со своим файлом agent.md — набором правил, которые помогают LLM-ассистентам писать более качественный код: от обязательных фигурных скобок и коротких имён функций до комментариев с пояснением «что» и «почему» и ASCII-схем для описания систем. Материал вызвал активное обсуждение на Hacker News (343 очка, 146 комментариев), где пользователи делятся альтернативными подходами и собственными AGENTS.md. Часть правил, по мнению комментаторов, лучше закреплять в линтерах, а не только в инструкциях для ИИ, а некоторые предлагают выносить стандарты кодирования в отдельный CODING_STANDARDS.md, чтобы не засорять контекст. Практическая ценность материала — в конкретных, воспроизводимых рекомендациях для рабочих процессов AI-assisted разработки.
Контекст¶
AGENTS.md (или agent.md) — это файл с инструкциями и правилами кодирования, который AI-ассистенты читают в начале каждой сессии, чтобы учитывать стиль и требования конкретного проекта. Формат постепенно становится де-факто стандартом: один AGENTS.md совместим со множеством AI-агентов и инструментов. Автор статьи, Фабьен Санглар, сначала был разочарован качеством кода, генерируемого LLM в середине 2025 года, но к 2026 году нашёл рабочий подход — создал собственный agent.md, который автоматически внедряет его предпочтения в стиле кода в каждый сеанс работы с ассистентом.
Влияние¶
Для разработчиков, использующих LLM-ассистентов, статья даёт готовый шаблон agent.md, который можно сразу адаптировать под проект; главный практический вывод из обсуждения — часть правил стоит автоматизировать через линтеры и ревью-агентов, чтобы они применялись и к коду, написанному людьми.
Обсуждение¶
В комментариях согласны с пользой явных правил, но спорят о месте их хранения: OptionOfT предлагает enforce через линтеры, gregwebs советует выносить большинство правил в CODING_STANDARDS.md и подключать их только при написании и ревью кода, а также использовать субагентные ревью. andai приводит пример, когда LLM сгенерировал функцию с именем draw_image_with_html_image_element_and_sw_and_sh_and_dx_and_dy_and_dw_and_dh, подтверждая необходимость ограничения длины имён; YuechenLi делится собственным AGENTS.md с «правилом конвергенции» (успех, значимый прогресс или блокер).