Olá! Em um cenário onde meu projeto possui mais de um repositório (backend e frontend separados, por exemplo) qual a melhor estratégia para montar a infraestrutura de artefatos? uma infraestrutura para cada repo? tratar como um monorepo com esses projetos dentro de um diretório e desenvolver a infra na raiz desse diretório?
Olá, Multintegrada. Como vai?
Essa é uma excelente dúvida de arquitetura, principalmente quando estamos trabalhando com a abordagem de Spec Driven Development (SDD) e inteligência artificial. Quando o desenvolvimento é assistido por agentes, a estrutura dos seus artefatos (as especificações, os prompts e os esquemas que guiam a IA) impacta diretamente o contexto que os agentes conseguem enxergar.
Para cenários de repositórios separados (multi-repo), existem duas estratégias principais, cada uma com seus prós e contras. A escolha ideal vai depender de como os seus agentes de IA trabalham no dia a dia da empresa.
Mesmo que o código final (o runtime) seja buildado em repositórios separados, no SDD é altamente recomendado criar um repositório centralizador apenas para a infraestrutura de artefatos, especificações e documentação de design. Se você optar por unificar os diretórios localmente em um formato de monorepo para desenvolvimento, a infraestrutura de artefatos deve ficar na raiz.
/sdd-specs) na raiz desse ecossistema. Dentro dela, ficam os arquivos OpenAPI (Swagger) do backend, os diagramas de arquitetura, as regras de negócio gerais e os testes baseados em especificação.Nessa abordagem, a especificação daquela camada do software vive colada ao código dela. O backend tem sua própria pasta de specs e agentes, e o frontend também.
openapi.yaml) e os prompts do agente de backend. O repositório do frontend possui os arquivos de especificação de interface (component-specs.md) e os prompts do agente de frontend.Considerando que o SDD foca no desenvolvimento guiado por agentes que tomam decisões baseadas em arquivos de especificação, tratar a arquitetura de especificação de forma unificada (estilo Monorepo para os artefatos na raiz) costuma trazer melhores resultados.
Manter as especificações na raiz de um diretório unificado simplifica drasticamente o mapeamento de contexto (context pinning) dos seus agentes. Em vez de configurar a IA para buscar referências em múltiplos repositórios distintos do GitHub, você pode simplesmente apontar o agente para a raiz do workspace local, garantindo que ele compreenda o contrato do backend e os requisitos do frontend simultaneamente.
Espero que possa ter lhe ajudado!