Переходим на метарепозитории Не всем подходят и не все готовы переводить проекты на монорепозитории, но даже в таком случае есть выход для удобства агентного кодинга. Можно использовать метарепозиторий. Что это такое? Создаем под конкретный продукт один базовый репозиторий, в котором хранится вся общая проектная документация (спеки, adr, инструкции для агентов, возможно тикеты). Все репозитории проекта добавляются внутрь простым клоном в подпапки (mise сам умеет это делать на базе конфига). Работа при этом идет из корня, чтобы агент видел все и имел доступ ко всему. Для удобства я сделал шаблон, где все это настроено. Там и структура и инструменты и принципы работы. Забирайте: https://github.com/hexlet-boilerplates/ai-metarepo Зачем это вообще? Единый контекст по проекту. Если так не сделать, то где хранить общие доки? Сейчас все подходы ориентированы на работу с md файлами в гите. Плюс нужно видеть не только тот репозиторий где делается правка, но и все остальное. А еще это позволяет сразу делать pr по всем связанным репам (естественно с требованием обратной совместимости) Зачем клонировать репозитории? Если у агента нет возможности быстро грепать по всем связанным репозиториям, он будет видеть намного меньше контекста и принимать хуже решения. Конечно можно просто указать какие репы смотреть в AGENTS.md, но это банально менее удобно, особенно если вы захотите вносить связанные изменения и смотреть глазами в код (вдруг, иногда). Почему не git submodules? Submodules предназначены прежде всего для фиксации конкретных версий зависимых репозиториев, а нам это не нужно. Более того, они усложняют разработку: detached HEAD по умолчанию, дополнительные команды для обновления, необходимость коммитить изменения ссылок в родительском репозитории. Особенно неудобно это при активной работе сразу с несколькими репозиториями, о чем пишет даже GitHub А если в репозиториях есть свои артефакты для агентов? Да, можно реализовать каскад Метарепозиторий вообще один? Метарепозиториев может быть много, но каждый метарепозиторий это свой продукт, который живет отдельно. Нет смысла делать один метарепозиторий на компанию и засовывать туда не связанные между собой продукты. Можно по другому? Теоретически да. OpenSpec называют это мультирепой и работает это примерно так. Создается единый репозиторий, на который есть указатель из той репы с которой вы работаете. Подробнее в официальной доке https://openspec.dev/docs/stores Telegram | YouTube | AI Клуб | Внедрение AI

На каком языке писать документацию? Короче у меня тут щелкнуло по тому как нужно делать. Если не брать во внимание эффективность по токенам (что лично меня не сильно беспокоит), вырисовывается такая тема. Агенты изучают происходящее в основном грепом причем достаточно прямолинейно. На базе запроса формируется регулярка с "или" куда вставляются в том числе синонимы без окончаний, чтобы найти больше совпадений. Потом идет сужение до тех пор пока не будет что-то найдено или, наоборот, не найдено. А на каком языке будет вестись поиск? Вот в этом зарыта самая соль. Агент сам определяет на каком языке вы общаетесь и не спрашивая вас начинает что-то искать. Нетрудно догадаться что если часть доки написана на одном языке, часть на другом, а общаетесь вы вообще регулярно прыгая с русского на английский и наоборот, то легко получить ситуацию, когда агент будет промахиваться и принимать неверные решения. Поэтому важно вот что. Язык может быть любым, главное что вся дока, комментарии, коммиты и другие текстовые артефакты были написаны только на одном выбранном. Очень вероятно что в компании где трекер на русском, лучше чтобы и все остальное было на русском. Иначе, опять же, возможны промахи, либо надо будет дополнительно описывать где как искать. Распространяется ли это на скилы? Нет, скилы не грепаются и по ним не ведется поиск (хотя теоретически такое может быть во время правок). Скилы либо вызываются напрямую, либо на основе описания, которое автоматически загружено в контекст. Тут обычно проблем не возникает и агент понимает когда что дергать если плюс минус совпадает терминология и интент. Я для себя выбрал такую схему: все внутренние проекты где русскоязычная команда мы делаем на русском, все публичные или проекты на международку делаем на английском. А какая у вас схема? Telegram | YouTube | AI Клуб | Внедрение AI

Выпуск про Quality Gates уже доступен в для просмотра и прослушивания. В этот раз соло, я рассказываю про то, какие инструменты использую для контроля качества кода генерируемого агентами. Прохожусь по принципам работы с worktree, ускорением тестов и проверки барьеров абстракции. Для этого кстати написал несколько интересных библиотек, про которые рассказал в выпуске. https://www.youtube.com/watch?v=x-P_xC6No0I Telegram | Аудио | vk | LLM-разработчик