Em projetos reais, o código raramente vive em um único repositório. Frontend, backend, documentação, bibliotecas compartilhadas estão espalhadas por diferentes repos, e uma única mudança de funcionalidade pode precisar tocar vários repos simultaneamente. Para Codex, o modo mono-repo funciona, mas ele não tem compreensão nativa de relações cross-repo — você tem que dizer a ele manualmente em cada conversa que 'esta mudança também precisa sincronizar para outros dois repos', o que é claramente ineficiente.
O mecanismo Monospecs do HagiCode é a solução estruturada projetada para cenários multi-repo. Através do arquivo de configuração .hagicode/monospecs.yaml, ele declara todos os endereços, nomes e relações de sub-repos no grupo de projetos, dando ao Codex um mapa cross-repo automático ao lançar propostas:
O Monospecs essencialmente elimina os pontos cegos cognitivos do Codex na colaboração cross-repo. O raciocínio do Codex é poderoso, mas ainda precisa de um mapa preciso para localizar o escopo das mudanças — e o Monospecs é esse mapa de projeto gerenciado sistematicamente.
- Consciência automática de relações de repositório: ao criar uma proposta de desenvolvimento, Codex pode ler diretamente a lista de sub-repos da configuração do Monospecs, sabendo que 'o código frontend desta mudança está em repos/frontend, as definições de API em repos/backend, a documentação em repos/docs' — você não precisa mais listar manualmente quais repositórios estão envolvidos toda vez.
- Rastreamento de mudanças cross-repo: quando uma proposta abrange múltiplos sub-repos, o diretório de propostas do OpenSpec fica no repositório principal, com os sub-repos apenas carregando as mudanças de código. Isso mantém specs e código separados, os sub-repos permanecem limpos, mas toda a cadeia de decisão e os registros de discussão da mudança são centralizados em um só lugar. Ao arquivar, commit_when_archive também pode auto-committar as specs para o repositório principal, economizando dores de cabeça de gerenciamento de versão manual.
- Direcionamento inteligente de repositório em commits de IA: ao fazer commits de IA, o HagiCode analisa suas mudanças contra a configuração do Monospecs e sugere automaticamente para qual repositório alvo o commit deve ir. Você não precisa fazer cd em cada diretório no terminal — o HagiCode cuida do julgamento de a qual repositório este código pertence.
- AGENTS.md por repositório: cada sub-repo pode ter seu próprio AGENTS.md dizendo ao Codex sobre o stack tecnológico, os padrões de codificação e as convenções de desenvolvimento daquele repositório. Codex lê automaticamente a orientação correspondente ao operar em diferentes repositórios, comportando-se sempre de acordo com os padrões da sua equipe.