В реальных проектах код редко живёт в единственном репозитории. Фронтенд, бэкенд, документация, общие библиотеки разбросаны по разным репозиториям, и одно изменение функциональности может потребовать затронуть несколько репозиториев одновременно. Для DeepAgents одно-репозиторный режим работает, но он не имеет естественного понимания меж-репозиторных связей — приходится каждый раз в разговоре вручную говорить, что 'это изменение также нужно синхронизировать в двух других репозиториях', что явно неэффективно.
Механизм Monospecs HagiCode — структурированное решение, разработанное для много-репозиторных сценариев. Через конфигурационный файл .hagicode/monospecs.yaml он объявляет все адреса, имена и связи под-репозиториев в группе проектов, предоставляя DeepAgents автоматическую меж-репозиторную карту при запуске предложений:
Monospecs по сути устраняет когнитивные слепые пятна DeepAgents в меж-репозиторной кооперации. Рассуждения DeepAgents мощны, но ему всё ещё нужна точная карта, чтобы локализовать масштаб изменений — и Monospecs — эта систематически управляемая карта проекта.
- Автоматическое осознание связей между репозиториями: при создании предложения по разработке DeepAgents может напрямую прочитать список под-репозиториев из конфигурации Monospecs, зная, что 'фронтенд-код этого изменения находится в repos/frontend, определения API в repos/backend, документация в repos/docs' — вам больше не нужно каждый раз вручную перечислять, какие репозитории задействованы.
- Отслеживание изменений между репозиториями: когда предложение охватывает несколько под-репозиториев, каталог предложений OpenSpec остаётся в главном репозитории, а под-репозитории несут только изменения кода. Так спецификации и код остаются разделёнными, под-репозитории остаются чистыми, но вся цепочка решений и записи обсуждений изменения централизованы в одном месте. При архивации commit_when_archive может также автоматически коммитить спецификации в главный репозиторий, избавляя от головной боли ручного управления версиями.
- Умное определение целевого репозитория при ИИ-коммитах: при ИИ-коммитах HagiCode анализирует ваши изменения относительно конфигурации Monospecs и автоматически предлагает, в какой целевой репозиторий должен идти коммит. Не нужно делать cd в каждый каталог в терминале — HagiCode берёт на себя суждение, к какому репозиторию принадлежит этот код.
- AGENTS.md для каждого репозитория: каждый под-репозиторий может иметь собственный AGENTS.md, сообщающий DeepAgents о технологическом стеке, стандартах кодирования и конвенциях разработки этого репозитория. DeepAgents автоматически читает соответствующее руководство при работе в разных репозиториях, всегда действуя в соответствии со стандартами вашей команды.