Arquitetura de Alto Nível do AIOX v4
🌐 EN | PT | ES
Versão: 2.1.0
Última Atualização: 2025-12-09
Status: Documento Oficial de Arquitetura
AIOX (AI Operating System) é um framework sofisticado para orquestração de agentes de IA, workers e humanos em fluxos de trabalho complexos de desenvolvimento de software. A versão 2.1 introduz uma arquitetura modular com 4 módulos, estratégia multi-repositório e quality gates de 3 camadas.
Capacidades Principais v4.2
Capacidade
Descrição
11 Agentes Especializados Dev, QA, Arquiteto, PM, PO, SM, Analista, Engenheiro de Dados, DevOps, UX, Master
115+ Tarefas Executáveis Criação de stories, geração de código, testes, deploy, documentação
52+ Templates PRDs, stories, docs de arquitetura, regras de IDE, quality gates
Arquitetura de 4 Módulos Core, Development, Product, Infrastructure
3 Camadas de Quality Gate Pre-commit, Automação de PR, Revisão Humana
Estratégia Multi-Repo 3 repositórios públicos + 2 privados
Sistema de Squads Times modulares de agentes de IA (ETL, Creator, MMOS)
┌─────────────────────────────────────────────────────────────────────────┐
│ FRAMEWORK AIOX v4 │
│ ═══════════════════ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ CLI / FERRAMENTAS │ │
│ │ (aiox agents, aiox tasks, aiox squads, aiox workflow) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌────────────────────┼────────────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ DEVELOPMENT │ │ PRODUCT │ │ INFRASTRUCTURE │ │
│ │ MODULE │ │ MODULE │ │ MODULE │ │
│ │ ──────────── │ │ ──────────── │ │ ─────────────── │ │
│ │ • 11 Agentes │ │ • 52+ Tmpls │ │ • 55+ Scripts │ │
│ │ • 115+ Tasks │ │ • 11 Chklsts │ │ • Configs Tools │ │
│ │ • 7 Wrkflws │ │ • Dados PM │ │ • Integrações │ │
│ │ • Scripts Dev│ │ │ │ • Adapters PM │ │
│ └──────┬───────┘ └──────┬───────┘ └────────┬────────┘ │
│ │ │ │ │
│ └──────────────────┼────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ MÓDULO CORE │ │
│ │ ═══════════ │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │ │
│ │ │ Config │ │ Registry │ │ Quality Gates │ │ │
│ │ │ System │ │ (Service │ │ (3 Camadas) │ │ │
│ │ │ │ │ Discovery) │ │ │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │ │
│ │ │ MCP │ │ Session │ │ Elicitation │ │ │
│ │ │ System │ │ Manager │ │ Engine │ │ │
│ │ │ │ │ │ │ │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │ │
│ │ │ │
│ │ SEM DEPENDÊNCIAS INTERNAS (Camada de Fundação) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Relacionamentos entre Módulos ┌────────────────────────────────────────────────────────────────────────┐
│ FLUXO DE DEPENDÊNCIA DE MÓDULOS │
│ │
│ ┌──────────────┐ │
│ │ CLI/Tools │ │
│ └──────┬───────┘ │
│ │ │
│ ┌─────────────────┼─────────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ development/ │ │ product/ │ │infrastructure/ │ │
│ │ │ │ │ │ │ │
│ │ • Agentes │ │ • Templates │ │ • Scripts │ │
│ │ • Tarefas │ │ • Checklists │ │ • Ferramentas │ │
│ │ • Workflows │ │ • Dados PM │ │ • Integrações │ │
│ └───────┬────────┘ └───────┬────────┘ └───────┬────────┘ │
│ │ │ │ │
│ │ depende apenas de │ │
│ └──────────────────┼──────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────┐ │
│ │ core/ │ │
│ │ │ │
│ │ SEM DEPEND. │ │
│ │ INTERNAS │ │
│ └────────────────┘ │
│ │
│ REGRAS: │
│ • core/ não tem dependências internas │
│ • development/, product/, infrastructure/ dependem APENAS de core/ │
│ • Dependências circulares são PROIBIDAS │
│ • CLI/Tools pode acessar qualquer módulo │
│ │
└────────────────────────────────────────────────────────────────────────┘
Estrutura de Repositórios ┌─────────────────────────────────────────────────────────────────────────┐
│ ORGANIZAÇÃO SYNKRA │
│ │
│ REPOSITÓRIOS PÚBLICOS │
│ ═══════════════════ │
│ │
│ ┌────────────────────┐ ┌────────────────────┐ │
│ │ SynkraAI/ │ │ SynkraAI/ │ │
│ │ aiox-core │ │ aiox-squads │ │
│ │ (MIT) │◄────│ (MIT) │ │
│ │ │ │ │ │
│ │ • Core Framework │ │ • ETL Squad │ │
│ │ • 11 Agentes Base │ │ • Creator Squad │ │
│ │ • Quality Gates │ │ • MMOS Squad │ │
│ │ • Hub Discussões │ │ │ │
│ └────────────────────┘ └────────────────────┘ │
│ │ │
│ │ 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 Partners │ │
│ └────────────────────┘ └────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Pacote
Registry
Licença
@aiox/corenpm público
MIT
@aiox/squad-etlnpm público
MIT
@aiox/squad-creatornpm público
MIT
@aiox/squad-mmosnpm público
MIT
@aiox/mcp-presetsnpm público
Apache 2.0
Categoria
Tecnologia
Versão
Notas
Runtime
Node.js
≥18.0.0
Plataforma para todos os scripts
Linguagem
TypeScript/JavaScript
ES2022
Desenvolvimento principal
Definição
Markdown + YAML
N/A
Agentes, tarefas, templates
Gerenciador de Pacotes
npm
≥9.0.0
Gerenciamento de dependências
Quality Gates
Husky + lint-staged
Latest
Hooks de pre-commit
Revisão de Código
CodeRabbit
Latest
Revisão com IA
CI/CD
GitHub Actions
N/A
Workflows de automação
aiox-core/
├── .aiox-core/ # Camada do Framework
│ ├── core/ # Módulo Core (fundação)
│ │ ├── config/ # Gerenciamento de configuração
│ │ ├── registry/ # Service Discovery
│ │ ├── quality-gates/ # Sistema QG de 3 camadas
│ │ ├── mcp/ # Configuração global MCP
│ │ └── session/ # Gerenciamento de sessão
│ │
│ ├── development/ # Módulo Development
│ │ ├── agents/ # 11 definições de agentes
│ │ ├── tasks/ # 115+ definições de tarefas
│ │ ├── workflows/ # 7 definições de workflows
│ │ └── scripts/ # Scripts de desenvolvimento
│ │
│ ├── product/ # Módulo Product
│ │ ├── templates/ # 52+ templates
│ │ ├── checklists/ # 11 checklists
│ │ └── data/ # Base de conhecimento PM
│ │
│ ├── infrastructure/ # Módulo Infrastructure
│ │ ├── scripts/ # 55+ scripts de infraestrutura
│ │ ├── tools/ # CLI, MCP, configs locais
│ │ └── integrations/ # Adaptadores PM
│ │
│ └── docs/ # Documentação do Framework
│ └── standards/ # Documentos de padrões
│
├── docs/ # Documentação do Projeto
│ ├── stories/ # Stories de desenvolvimento
│ ├── architecture/ # Docs de arquitetura
│ └── epics/ # Planejamento de épicos
│
├── squads/ # Implementações de Squads
│ ├── etl/ # Squad ETL
│ ├── creator/ # Squad Creator
│ └── mmos-mapper/ # Squad MMOS
│
├── .github/ # Automação GitHub
│ ├── workflows/ # Workflows CI/CD
│ ├── ISSUE_TEMPLATE/ # Templates de issues
│ └── CODEOWNERS # Propriedade do código
│
└── .husky/ # Git hooks (QG Camada 1)
Módulo
Caminho
Propósito
Conteúdos Principais
Core .aiox-core/core/Fundação do framework
Config, Registry, QG, MCP, Session
Development .aiox-core/development/Artefatos de dev
Agentes, Tarefas, Workflows, Scripts
Product .aiox-core/product/Artefatos PM
Templates, Checklists, Dados
Infrastructure .aiox-core/infrastructure/Config do sistema
Scripts, Ferramentas, Integrações
Agente
ID
Arquétipo
Responsabilidade
Dex
devBuilder
Implementação de código
Quinn
qaGuardian
Garantia de qualidade
Aria
architectArchitect
Arquitetura técnica
Nova
poVisionary
Backlog do produto
Kai
pmBalancer
Estratégia de produto
River
smFacilitator
Facilitação de processos
Zara
analystExplorer
Análise de negócios
Dara
data-engineerArchitect
Engenharia de dados
Felix
devopsOptimizer
CI/CD e operações
Uma
ux-expertCreator
Experiência do usuário
Pax
aiox-masterOrchestrator
Orquestração do framework
Sistema de Quality Gate de 3 Camadas ┌─────────────────────────────────────────────────────────────────────────┐
│ QUALITY GATES 3 CAMADAS │
│ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ CAMADA 1: PRE-COMMIT (Local) │ │
│ │ ═══════════════════════════ │ │
│ │ • ESLint, Prettier, TypeScript │ │
│ │ • Testes unitários (rápidos) │ │
│ │ • Ferramenta: Husky + lint-staged │ │
│ │ • Bloqueante: Não consegue fazer commit se falhar │ │
│ │ • Problemas capturados: 30% │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ CAMADA 2: AUTOMAÇÃO DE PR (CI/CD) │ │
│ │ ════════════════════════════════ │ │
│ │ • Revisão com IA CodeRabbit │ │
│ │ • Testes de integração, análise de cobertura │ │
│ │ • Scan de segurança, benchmarks de performance │ │
│ │ • Ferramenta: GitHub Actions + CodeRabbit │ │
│ │ • Bloqueante: Checks necessários para merge │ │
│ │ • Problemas capturados: +50% adicional (80% total) │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ CAMADA 3: REVISÃO HUMANA (Estratégica) │ │
│ │ ══════════════════════════════════ │ │
│ │ • Alinhamento de arquitetura │ │
│ │ • Correção da lógica de negócio │ │
│ │ • Casos extremos, qualidade da documentação │ │
│ │ • Ferramenta: Expertise humana │ │
│ │ • Bloqueante: Aprovação final necessária │ │
│ │ • Problemas capturados: 20% finais (100% total) │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ │
│ RESULTADO: 80% dos problemas capturados automaticamente │
│ Tempo de revisão humana: 30 min/PR (vs 2-4h na v2.0) │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Última Atualização: 2025-12-09
Versão: 2.1.0
Mantenedor: @architect (Aria)