Arquitectura de Alto Nivel AIOX v4
🌐 EN | PT | ES
Versión: 2.1.0
Última Actualización: 2025-12-09
Estado: Documento Oficial de Arquitectura
AIOX (AI Operating System) es un framework sofisticado para orquestar agentes de IA, workers y humanos en flujos de trabajo complejos de desarrollo de software. La versión 2.1 introduce una arquitectura modular con 4 módulos, estrategia multi-repositorio y quality gates de 3 capas.
Capacidad
Descripción
11 Agentes Especializados Dev, QA, Architect, PM, PO, SM, Analyst, Data Engineer, DevOps, UX, Master
115+ Tareas Ejecutables Creación de stories, generación de código, testing, deployment, documentación
52+ Plantillas PRDs, stories, documentos de arquitectura, reglas IDE, quality gates
Arquitectura de 4 Módulos Core, Development, Product, Infrastructure
Quality Gates de 3 Capas Pre-commit, Automatización PR, Revisión Humana
Estrategia Multi-Repo 3 repositorios públicos + 2 privados
Sistema de Squad Equipos modulares de agentes IA (ETL, Creator, MMOS)
Arquitectura de 4 Módulos ┌─────────────────────────────────────────────────────────────────────────┐
│ FRAMEWORK AIOX v4 │
│ ═══════════════════ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ CLI / HERRAMIENTAS │ │
│ │ (aiox agents, aiox tasks, aiox squads, aiox workflow) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌────────────────────┼────────────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ DEVELOPMENT │ │ PRODUCT │ │ INFRASTRUCTURE │ │
│ │ MÓDULO │ │ MÓDULO │ │ MÓDULO │ │
│ │ ──────────── │ │ ──────────── │ │ ─────────────── │ │
│ │ • 11 Agentes │ │ • 52+ Plntls │ │ • 55+ Scripts │ │
│ │ • 115+ Tareas│ │ • 11 Chklsts │ │ • Configs Tool │ │
│ │ • 7 Wrkflws │ │ • PM Data │ │ • Integraciones │ │
│ │ • Dev Scripts│ │ │ │ • PM Adapters │ │
│ └──────┬───────┘ └──────┬───────┘ └────────┬────────┘ │
│ │ │ │ │
│ └──────────────────┼────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ MÓDULO CORE │ │
│ │ ═══════════ │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │ │
│ │ │ Config │ │ Registry │ │ Quality Gates │ │ │
│ │ │ System │ │ (Service │ │ (3 Capas) │ │ │
│ │ │ │ │ Discovery) │ │ │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │ │
│ │ │ MCP │ │ Session │ │ Elicitation │ │ │
│ │ │ System │ │ Manager │ │ Engine │ │ │
│ │ │ │ │ │ │ │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │ │
│ │ │ │
│ │ SIN DEPENDENCIAS INTERNAS (Capa de Fundación) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
┌────────────────────────────────────────────────────────────────────────┐
│ FLUJO DE DEPENDENCIAS DE MÓDULOS │
│ │
│ ┌──────────────┐ │
│ │ CLI/Tools │ │
│ └──────┬───────┘ │
│ │ │
│ ┌─────────────────┼─────────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ development/ │ │ product/ │ │infrastructure/ │ │
│ │ │ │ │ │ │ │
│ │ • Agentes │ │ • Plantillas │ │ • Scripts │ │
│ │ • Tareas │ │ • Checklists │ │ • Herramientas│ │
│ │ • Workflows │ │ • PM Data │ │ • Integraciones│ │
│ └───────┬────────┘ └───────┬────────┘ └───────┬────────┘ │
│ │ │ │ │
│ │ depende solo de │ │
│ └──────────────────┼──────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────┐ │
│ │ core/ │ │
│ │ │ │
│ │ SIN DEPEND. │ │
│ │ INTERNAS │ │
│ └────────────────┘ │
│ │
│ REGLAS: │
│ • core/ no tiene dependencias internas │
│ • development/, product/, infrastructure/ dependen SOLO de core/ │
│ • Las dependencias circulares están PROHIBIDAS │
│ • CLI/Tools puede acceder a cualquier módulo │
│ │
└────────────────────────────────────────────────────────────────────────┘
Estructura de Repositorios ┌─────────────────────────────────────────────────────────────────────────┐
│ ORGANIZACIÓN SYNKRA │
│ │
│ REPOSITORIOS PÚBLICOS │
│ ═════════════════════ │
│ │
│ ┌────────────────────┐ ┌────────────────────┐ │
│ │ SynkraAI/ │ │ SynkraAI/ │ │
│ │ aiox-core │ │ aiox-squads │ │
│ │ (MIT) │◄────│ (MIT) │ │
│ │ │ │ │ │
│ │ • Framework Core │ │ • ETL Squad │ │
│ │ • 11 Agentes Base │ │ • Creator Squad │ │
│ │ • Quality Gates │ │ • MMOS Squad │ │
│ │ • Hub Discusiones │ │ │ │
│ └────────────────────┘ └────────────────────┘ │
│ │ │
│ │ dependencia opcional │
│ ▼ │
│ ┌────────────────────┐ │
│ │ SynkraAI/ │ │
│ │ mcp-ecosystem │ │
│ │ (Apache 2.0) │ │
│ │ │ │
│ │ • Docker MCP │ │
│ │ • Configs IDE │ │
│ │ • MCP Presets │ │
│ └────────────────────┘ │
│ │
│ REPOSITORIOS PRIVADOS │
│ ═════════════════════ │
│ │
│ ┌────────────────────┐ ┌────────────────────┐ │
│ │ SynkraAI/mmos │ │ SynkraAI/ │ │
│ │ (Proprietary+NDA) │ │ certified-partners│ │
│ │ │ │ (Proprietary) │ │
│ │ • MMOS Minds │ │ • Premium Squads │ │
│ │ • DNA Mental™ │ │ • Portal Partners │ │
│ └────────────────────┘ └────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Paquete
Registry
Licencia
@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
Categoría
Tecnología
Versión
Notas
Runtime
Node.js
≥18.0.0
Plataforma para todos los scripts
Lenguaje
TypeScript/JavaScript
ES2022
Desarrollo principal
Definición
Markdown + YAML
N/A
Agentes, tareas, plantillas
Gestor Paquetes
npm
≥9.0.0
Gestión de dependencias
Quality Gates
Husky + lint-staged
Latest
Hooks pre-commit
Code Review
CodeRabbit
Latest
Revisión potenciada por IA
CI/CD
GitHub Actions
N/A
Workflows de automatización
Estructura de Directorios aiox-core/
├── .aiox-core/ # Capa del framework
│ ├── core/ # Módulo core (fundación)
│ │ ├── config/ # Gestión de configuración
│ │ ├── registry/ # Service Discovery
│ │ ├── quality-gates/ # Sistema QG de 3 capas
│ │ ├── mcp/ # Configuración global MCP
│ │ └── session/ # Gestión de sesiones
│ │
│ ├── development/ # Módulo de desarrollo
│ │ ├── agents/ # 11 definiciones de agentes
│ │ ├── tasks/ # 115+ definiciones de tareas
│ │ ├── workflows/ # 7 definiciones de workflows
│ │ └── scripts/ # Scripts de desarrollo
│ │
│ ├── product/ # Módulo de producto
│ │ ├── templates/ # 52+ plantillas
│ │ ├── checklists/ # 11 checklists
│ │ └── data/ # Base de conocimiento PM
│ │
│ ├── infrastructure/ # Módulo de infraestructura
│ │ ├── scripts/ # 55+ scripts de infraestructura
│ │ ├── tools/ # CLI, MCP, configs locales
│ │ └── integrations/ # PM adapters
│ │
│ └── docs/ # Documentación del framework
│ └── standards/ # Documentos de estándares
│
├── docs/ # Documentación del proyecto
│ ├── stories/ # Stories de desarrollo
│ ├── architecture/ # Documentos de arquitectura
│ └── epics/ # Planificación de épicas
│
├── squads/ # Implementaciones de Squad
│ ├── etl/ # ETL Squad
│ ├── creator/ # Creator Squad
│ └── mmos-mapper/ # MMOS Squad
│
├── .github/ # Automatización GitHub
│ ├── workflows/ # Workflows CI/CD
│ ├── ISSUE_TEMPLATE/ # Plantillas de issues
│ └── CODEOWNERS # Propiedad del código
│
└── .husky/ # Git hooks (Capa 1 QG)
Módulo
Ruta
Propósito
Contenidos Clave
Core .aiox-core/core/Fundación del framework
Config, Registry, QG, MCP, Session
Development .aiox-core/development/Artefactos de desarrollo
Agentes, Tareas, Workflows, Scripts
Product .aiox-core/product/Artefactos PM
Plantillas, Checklists, Data
Infrastructure .aiox-core/infrastructure/Config del sistema
Scripts, Tools, Integraciones
Agente
ID
Arquetipo
Responsabilidad
Dex
devConstructor
Implementación de código
Quinn
qaGuardián
Aseguramiento de calidad
Aria
architectArquitecto
Arquitectura técnica
Nova
poVisionario
Backlog de producto
Kai
pmEquilibrador
Estrategia de producto
River
smFacilitador
Facilitación de procesos
Zara
analystExplorador
Análisis de negocio
Dara
data-engineerArquitecto
Ingeniería de datos
Felix
devopsOptimizador
CI/CD y operaciones
Uma
ux-expertCreador
Experiencia de usuario
Pax
aiox-masterOrquestador
Orquestación del framework
Sistema de Quality Gates de 3 Capas ┌─────────────────────────────────────────────────────────────────────────┐
│ QUALITY GATES 3 CAPAS │
│ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ CAPA 1: PRE-COMMIT (Local) │ │
│ │ ══════════════════════════ │ │
│ │ • ESLint, Prettier, TypeScript │ │
│ │ • Tests unitarios (rápidos) │ │
│ │ • Herramienta: Husky + lint-staged │ │
│ │ • Bloqueante: No se puede hacer commit si falla │ │
│ │ • Issues detectados: 30% │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ CAPA 2: AUTOMATIZACIÓN PR (CI/CD) │ │
│ │ ═════════════════════════════════ │ │
│ │ • Revisión IA CodeRabbit │ │
│ │ • Tests de integración, análisis de cobertura │ │
│ │ • Escaneo de seguridad, benchmarks de rendimiento │ │
│ │ • Herramienta: GitHub Actions + CodeRabbit │ │
│ │ • Bloqueante: Checks requeridos para merge │ │
│ │ • Issues detectados: +50% adicional (80% total) │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ CAPA 3: REVISIÓN HUMANA (Estratégica) │ │
│ │ ═════════════════════════════════════ │ │
│ │ • Alineación arquitectónica │ │
│ │ • Corrección de lógica de negocio │ │
│ │ • Casos edge, calidad de documentación │ │
│ │ • Herramienta: Experiencia humana │ │
│ │ • Bloqueante: Aprobación final requerida │ │
│ │ • Issues detectados: 20% final (100% total) │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ │
│ RESULTADO: 80% de issues detectados automáticamente │
│ Tiempo de revisión humana: 30 min/PR (vs 2-4h en v2.0) │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Última Actualización: 2025-12-09
Versión: 2.1.0
Responsable: @architect (Aria)