Estratégia Multi-Repositório
Versão: 2.1.0 Última Atualização: 2026-01-28 Status: Documento de Arquitetura Oficial
Índice
- Visão Geral
- Estrutura de Repositórios
- Repositório Principal (aios-core)
- Repositórios de Squads
- Repositório de Ecossistema MCP
- Repositórios Privados
- Mecanismo de Sincronização
- Distribuição de Pacotes
- Melhores Práticas
Visão Geral
AIOS v4 adota uma estratégia multi-repositório para viabilizar desenvolvimento modular, contribuições comunitárias e separação clara entre framework principal, extensões (squads) e componentes proprietários.
Objetivos de Design
| Objetivo | Descrição |
|---|---|
| Modularidade | Squads podem ser desenvolvidas e versionadas independentemente |
| Comunidade | Squads open-source incentivam contribuições comunitárias |
| Proteção de IP | Componentes proprietários permanecem em repositórios privados |
| Escalabilidade | Equipes podem trabalhar em repos separadas sem conflitos |
| Flexibilidade de Licenças | Componentes diferentes podem ter licenças diferentes |
Estrutura de Repositórios
Organização SynkraAI
├── REPOSITÓRIOS PÚBLICOS
│ ├── aios-core # Framework principal (MIT)
│ ├── aios-squads # Squads comunitárias (MIT)
│ └── mcp-ecosystem # Configurações MCP (Apache 2.0)
│
└── REPOSITÓRIOS PRIVADOS
├── mmos # MMOS proprietário (NDA)
└── certified-partners # Recursos de parceiros (Proprietário)Arquitetura Visual
┌─────────────────────────────────────────────────────────────────────────┐
│ ORGANIZAÇÃO SYNKRA │
│ │
│ REPOSITÓRIOS PÚBLICOS │
│ ═══════════════════════ │
│ │
│ ┌────────────────────┐ ┌────────────────────┐ │
│ │ SynkraAI/ │ │ SynkraAI/ │ │
│ │ aios-core │ │ aios-squads │ │
│ │ (MIT) │◄────│ (MIT) │ │
│ │ │ │ │ │
│ │ - Framework Core │ │ - Squad ETL │ │
│ │ - 11 Agentes Base │ │ - Squad Creator │ │
│ │ - Gates de Qualid │ │ - Squad MMOS │ │
│ │ - Hub Discussões │ │ - Squads Comum │ │
│ └────────────────────┘ └────────────────────┘ │
│ │ │
│ │ dependência opcional │
│ ▼ │
│ ┌────────────────────┐ │
│ │ SynkraAI/ │ │
│ │ mcp-ecosystem │ │
│ │ (Apache 2.0) │ │
│ │ │ │
│ │ - Docker MCP │ │
│ │ - Configs IDE │ │
│ │ - Presets MCP │ │
│ └────────────────────┘ │
│ │
│ REPOSITÓRIOS PRIVADOS │
│ ═══════════════════════ │
│ │
│ ┌────────────────────┐ ┌────────────────────┐ │
│ │ SynkraAI/mmos │ │ SynkraAI/ │ │
│ │ (Proprietário+NDA)│ │ certified-partners│ │
│ │ │ │ (Proprietário) │ │
│ │ - MMOS Minds │ │ - Squads Premium │ │
│ │ - DNA Mental │ │ - Portal Parceiros│ │
│ └────────────────────┘ └────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘Repositório Principal (aios-core)
Propósito
O repositório principal contém o framework AIOS fundamental que todos os projetos dependem.
Conteúdo
| Diretório | Descrição |
|---|---|
.aios-core/core/ | Fundações do framework (config, registry, gates de qualidade) |
.aios-core/development/ | Definições de agentes, tarefas, workflows |
.aios-core/product/ | Templates, checklists, dados de PM |
.aios-core/infrastructure/ | Scripts, ferramentas, integrações |
docs/ | Documentação do framework |
Licença
MIT - Licença permissiva para uso, modificação e distribuição do core.
Pacote npm
npm install @aios/coreRepositórios de Squads
Visão Geral
Squads são extensões modulares que adicionam capacidades especializadas ao AIOS.
Repositório aios-squads
aios-squads/
├── etl/ # Squad de processamento ETL
│ ├── squad.yaml # Manifesto da squad
│ ├── agents/ # Agentes específicos da squad
│ ├── tasks/ # Tarefas da squad
│ └── README.md # Documentação da squad
│
├── creator/ # Squad de criação de conteúdo
│ ├── squad.yaml
│ ├── agents/
│ └── tasks/
│
├── mmos/ # Squad de integração MMOS
│ ├── squad.yaml
│ ├── agents/
│ └── tasks/
│
└── templates/ # Templates de criação de squads
└── squad-template/Manifesto de Squad (squad.yaml)
name: etl
version: 1.0.0
description: Squad de processamento ETL para pipelines de dados
license: MIT
peerDependencies:
'@aios/core': '^2.1.0'
agents:
- id: data-engineer
extends: dev
tasks:
- extract-data
- transform-data
- load-data
exports:
- agents
- tasksLicença
MIT - Total liberdade open-source para contribuições comunitárias.
Pacotes npm
npm install @aios/squad-etl
npm install @aios/squad-creator
npm install @aios/squad-mmosRepositório de Ecossistema MCP
Propósito
Configurações MCP (Model Context Protocol) centralizadas para vários IDEs e ambientes.
Conteúdo
mcp-ecosystem/
├── docker/ # Configurações Docker MCP
│ ├── docker-compose.yml
│ └── mcp-servers/
│
├── ide-configs/ # Configurações específicas de IDE
│ ├── claude-code/
│ ├── cursor/
│ └── vscode/
│
└── presets/ # Bundles MCP pré-configurados
├── minimal/
├── development/
└── enterprise/Licença
Apache 2.0 - Licença permissiva para máxima adoção.
Pacote npm
npm install @aios/mcp-presetsRepositórios Privados
SynkraAI/mmos (Proprietário + NDA)
Contém componentes proprietários MMOS (Mental Model Operating System):
- Definições de MMOS Minds
- Algoritmos DNA Mental
- Dados de treinamento proprietários
- Customizações específicas de parceiros
Acesso: Requer NDA e acordo de licenciamento.
SynkraAI/certified-partners (Proprietário)
Recursos para parceiros AIOS certificados:
- Implementações de squads premium
- Acesso ao portal de parceiros
- Ferramentas de suporte empresarial
- Configurações white-label
Acesso: Requer status de parceiro certificado.
Mecanismo de Sincronização
Dependências Entre Repositórios
┌──────────────┐ depende de ┌──────────────┐
│ aios-squads │ ──────────────────► │ aios-core │
└──────────────┘ └──────────────┘
│ │
│ │
│ opcional │ opcional
│ │
▼ ▼
┌──────────────┐ ┌──────────────┐
│mcp-ecosystem │ │ mmos │
└──────────────┘ └──────────────┘Compatibilidade de Versões
| aios-core | aios-squads | mcp-ecosystem |
|---|---|---|
| ^2.1.0 | ^1.0.0 | ^1.0.0 |
| ^3.0.0 | ^2.0.0 | ^1.x.x |
Git Submodules (Opcional)
Para projetos que precisam de múltiplos repositórios:
# Adicionar squads como submódulo
git submodule add https://github.com/SynkraAI/aios-squads.git squads
# Adicionar ecossistema MCP como submódulo
git submodule add https://github.com/SynkraAI/mcp-ecosystem.git mcpDependências npm (Recomendado)
{
"dependencies": {
"@aios/core": "^2.1.0",
"@aios/squad-etl": "^1.0.0",
"@aios/mcp-presets": "^1.0.0"
}
}Distribuição de Pacotes
Escopo de Pacotes npm
| Pacote | Registry | Licença | Repositório |
|---|---|---|---|
@aios/core | npm public | MIT | aios-core |
@aios/squad-etl | npm public | MIT | aios-squads |
@aios/squad-creator | npm public | MIT | aios-squads |
@aios/squad-mmos | npm public | MIT | aios-squads |
@aios/mcp-presets | npm public | Apache 2.0 | mcp-ecosystem |
Workflow de Publicação
# A partir de aios-core
npm publish --access public
# A partir de aios-squads/etl
cd etl && npm publish --access public
# A partir de mcp-ecosystem
npm publish --access publicMelhores Práticas
Para Contribuidores do Núcleo
- Mudanças Atômicas - Mantenha PRs focadas em recursos ou correções únicos
- Compatibilidade para Trás - Evite mudanças breaking em versões menores
- Documentação - Atualize docs no mesmo PR que as mudanças de código
- Testes Entre Repositórios - Teste mudanças contra repositórios dependentes
Para Desenvolvedores de Squads
- Manifesto Primeiro - Defina squad.yaml antes de implementar
- Dependências de Pares - Especifique requisitos exatos de versão aios-core
- Testes Independentes - Squads devem ter seus próprios suites de testes
- Padrões README - Inclua exemplos de uso e requisitos
Para Consumidores de Projetos
- Bloquear Versões - Use versões exatas em produção
- Testar Atualizações - Execute suite de testes completa após atualizar dependências
- Monitorar Releases - Inscreva-se em notificações de release
- Relatar Problemas - Registre issues no repositório correto
Manutenção de Repositório
| Tarefa | Frequência | Responsabilidade |
|---|---|---|
| Atualizações de deps | Semanal | DevOps |
| Auditorias de segurança | Mensal | DevOps |
| Releases de versão | Conforme necessário | Mantenedores |
| Sincronização de docs | Por release | Contribuidores |
Documentos Relacionados
Última Atualização: 2026-01-28 | Time do Framework AIOS