Как делать инструкции к проекту для AI агентов При использовании AI агентов в больших проектах есть смысл объяснять нейронкам как этот проект устроен – это сэкономит много времени тебе и твоим коллегам на том чтобы каждый раз заново объяснять что где в проекте лежит, как вы тут вообще пишете код, какая архитектура и тд. Во всех популярных решениях эти файлы уже поддерживаются и агенты автоматически проверяют их наличие при каждый запросе. У всех агентов/ideшек своё кодовое название, например ClaudeCode ищет файлы claude.md. В файле можно в свободной форме описать всё что считаешь нужным, но я рекомендую не страдать хуйней и вместо того чтобы что-то там писать руками заставить агента самому себе нашлепать инструкций. Надо понимать что задача этого файла не рассказать нейронке как думать, а рассказать ей о проекте, потому что у каждого разработчика свой воркфлоу по работе агентами и свои фишки, например если твоему больному коллеге нейронка отвечает стихами, тебе это вряд ли будет нужно. Так вот, в типичном проекте агенту нужно знать по сути следующие вещи: - Дизайн система - Архитектура - Конвеншн по тестированию Может бэкенд господа что-то захотят добавить в этот список, но я не придумал что им такого отдельно может понадобиться. С дизайн системой всё просто – натравливаешь агента на модуль где она находится и просишь описать в инструкцию. С архитектурой – ищешь в проекте эталонную фичу и так же просишь описать в инструкцию. Потом ищешь самые секси тесты и так же кормишь агенту. По структуре файла. Агенты любят примеры – хорошо если внутри md файла будут сокращенные куски кода, это наглядно покажет как нужно делать. Еще один момент – если инструкцию делать одним файлом то она спокойно может перевалить за пару тысяч строк и каждый раз засирать контекст этой графоманией будет глупо, тем более что вряд ли агенту понадобится инфа про дизайн систему и тесты одновременно. Чтобы решить эту проблему можно использовать файл-роутер: в корневом файле пишешь чето типа "йо привет агент, это твоя инструкция. Если будешь писать тесты – открывай файл tests.md, если будешь делать ui, иди в design-system.md, если логику писать то в achitecture.md". То что выше описано работает на реальном проекте с 4 разными фреймворками в одной монорепе. Там кстати еще и роутинг был многоуровневый – сначала агенту нужно было понять какую часть проекта он пишет, а потом понять какую задачу решает. Удивляюсь что только один раз он перепутал стек и начал мне рассказывать про typescript вместо котлина. На этом всё, если у тебя был опыт составления инструкций для агентов, приходи рассказывай в комменты.