Dans les projets réels, le code vit rarement dans un seul dépôt. Frontend, backend, documentation, bibliothèques partagées sont dispersés à travers différents repos, et un seul changement de fonctionnalité peut nécessiter de toucher plusieurs repos simultanément. Pour OpenCode, le mode mono-repo fonctionne, mais il n'a pas de compréhension native des relations cross-repo — vous devez lui dire manuellement dans chaque conversation que 'ce changement doit aussi se synchroniser à deux autres repos', ce qui est clairement inefficace.
Le mécanisme Monospecs de HagiCode est la solution structurée conçue pour les scénarios multi-repo. Via le fichier de configuration .hagicode/monospecs.yaml, il déclare toutes les adresses, noms et relations des sous-repos dans le groupe de projets, donnant à OpenCode une carte cross-repo automatique au lancement des propositions :
Monospecs élimine essentiellement les angles morts cognitifs de OpenCode dans la collaboration cross-repo. Le raisonnement de OpenCode est puissant, mais il a toujours besoin d'une carte précise pour localiser la portée des changements — et Monospecs est cette carte de projet gérée systématiquement.
- Prise de conscience automatique des relations de repo : lors de la création d'une proposition de développement, OpenCode peut lire directement la liste des sous-repos depuis la configuration Monospecs, sachant que 'le code frontend de ce changement est dans repos/frontend, les définitions d'API dans repos/backend, la documentation dans repos/docs' — vous n'avez plus besoin d'énumérer manuellement quels repos sont impliqués à chaque fois.
- Suivi des changements cross-repo : quand une proposition couvre plusieurs sous-repos, le répertoire de propositions OpenSpec reste dans le repo principal, les sous-repos ne portant que les changements de code. Cela maintient les specs et le code séparés, les sous-repos restent propres, mais toute la chaîne de décision et les enregistrements de discussion du changement sont centralisés en un seul endroit. À l'archivage, commit_when_archive peut aussi auto-committer les specs dans le repo principal, économisant les maux de tête de gestion de version manuelle.
- Ciblage intelligent de repo lors des commits IA : lors des commits IA, HagiCode analyse vos changements par rapport à la configuration Monospecs et suggère automatiquement vers quel repo cible le commit devrait aller. Vous n'avez pas besoin de cd dans chaque répertoire dans le terminal — HagiCode gère le jugement du repo auquel ce code appartient.
- AGENTS.md par repo : chaque sous-repo peut avoir son propre AGENTS.md indiquant à OpenCode la stack technique, les standards de codage et les conventions de développement de ce repo. OpenCode lit automatiquement les conseils correspondants en opérant sur différents repos, se comportant toujours selon les standards de votre équipe.
