Skip to content

v4-quick-start.md

Latest commit

 

History

History
269 lines (192 loc) · 7.34 KB

v4-quick-start.md

File metadata and controls

269 lines (192 loc) · 7.34 KB
Raw

Guía de Inicio Rápido AIOX v4

🌐 EN | PT | ES

Versión: 2.1 Última Actualización: 2026-01-26 Tiempo para Completar: 5 minutos

Prerrequisitos

Antes de comenzar, asegúrate de tener:

  • Node.js 18+ instalado (node --version)
  • npm 9+ instalado (npm --version)
  • Git instalado (git --version)
  • GitHub CLI (gh) instalado y autenticado (gh auth status)
  • Un IDE con IA o Claude Code CLI

Paso 1: Instalar AIOX Core

Opción A: Wizard de Instalación npx (Recomendado)

# Ejecutar el wizard de instalación interactivo
npx aiox-core@latest

# O crear un nuevo proyecto con nombre específico
npx aiox-core@latest init mi-proyecto
cd mi-proyecto

Opción B: Clonar Repositorio (Desarrollo)

git clone https://github.com/SynkraAI/aiox-core.git
cd aiox-core
npm install

Paso 2: Verificar Instalación

Ejecuta el comando de diagnóstico:

npx aiox-core@latest doctor

O si está instalado globalmente:

aiox doctor

Verificación Manual

# Verificar que la estructura core existe
ls -la .aiox-core/

# Verificar directorios principales
ls .aiox-core/core/
ls .aiox-core/development/agents/

Estructura esperada:

.aiox-core/
├── core/               # Core del framework (registry, health-check, orchestration)
├── development/        # Agentes, tareas, workflows
├── product/            # Templates, checklists
└── infrastructure/     # Scripts, herramientas, integraciones

Paso 3: Activar Tu Primer Agente

AIOX usa agentes especializados para diferentes tareas. En tu IDE con IA o Claude Code CLI, escribe:

@aiox-master

El agente te saludará y mostrará comandos disponibles:

🎯 AIOX Master listo!
Escribe *help para ver comandos disponibles.

Prueba Estos Comandos

Comando Descripción
*help Mostrar todos los comandos disponibles
*status Mostrar estado del proyecto
*agents Listar todos los agentes disponibles

Paso 4: Explorar Agentes Disponibles

Agente Activación Propósito
@dev (Dex) Desarrollo Implementación de código, debugging
@qa (Quinn) Calidad Pruebas y validación
@architect (Aria) Arquitectura Diseño de sistema y documentación
@pm (Sage) Product Manager Requisitos y planificación
@devops (Gage) DevOps Git push, creación de PR, CI/CD
@po (Maven) Product Owner Creación de stories y backlog
@sm (River) Scrum Master Gestión de sprint
@analyst (Nova) Analista de Negocios Análisis de requisitos

Ejemplo: Activar Agente Desarrollador

@dev

El agente desarrollador (Dex) se activará con un saludo mostrando:

  • Estado del proyecto
  • Comandos rápidos
  • Opciones de colaboración entre agentes

Paso 5: Crear Tu Primera Story

Las stories dirigen el desarrollo en AIOX. Activa el Product Owner y crea una:

@po *create-story

Sigue los prompts para definir:

  1. Título de la story
  2. Descripción
  3. Criterios de aceptación
  4. Prioridad

Referencia Rápida

Comandos de Agente

Todos los comandos de agente usan el prefijo *:

*help          # Mostrar ayuda
*status        # Mostrar estado
*exit          # Salir del agente actual

Comandos CLI

# Instalación y setup
npx aiox-core@latest           # Ejecutar wizard
npx aiox-core@latest doctor    # Ejecutar diagnósticos
npx aiox-core@latest info      # Mostrar info del sistema

# Desarrollo
npm run lint                           # Verificar estilo de código
npm run typecheck                      # Verificar tipos TypeScript
npm test                               # Ejecutar pruebas unitarias
npm run validate:structure             # Validar estructura AIOX

Estructura del Proyecto

tu-proyecto/
├── .aiox-core/                    # Core del framework
│   ├── core/                      # Módulos core
│   │   ├── registry/              # Registro de servicios (200+ workers)
│   │   ├── health-check/          # Sistema de health check
│   │   ├── orchestration/         # Orquestación de workflows
│   │   └── quality-gates/         # Capas de validación de calidad
│   ├── development/               # Assets de desarrollo
│   │   ├── agents/                # Definiciones de agentes (12 agentes)
│   │   ├── tasks/                 # Workflows de tareas (~140 tareas)
│   │   └── workflows/             # Workflows multi-etapa
│   ├── product/                   # Assets de producto
│   │   ├── templates/             # Templates de documentos
│   │   └── checklists/            # Checklists de validación
│   └── infrastructure/            # Infraestructura
│       ├── scripts/               # Scripts utilitarios (~80)
│       ├── integrations/          # Adaptadores de PM tools
│       └── templates/             # Templates de configuración
├── .claude/                       # Configuración Claude Code
│   ├── commands/AIOX/agents/      # Skills de agentes
│   └── rules/                     # Reglas de agentes
├── docs/                          # Documentación
│   └── stories/                   # Stories de desarrollo
└── src/                           # Tu código fuente

Próximos Pasos

  1. Lee la guía completa: Comenzando
  2. Entiende la arquitectura: Arquitectura Core
  3. Aprende sobre agentes: Definiciones de Agentes
  4. Únete a la comunidad: Discord

Solución de Problemas

Errores "Comando no encontrado"

# Asegúrate que Node.js está en el PATH
node --version

# Limpia el cache npm si persisten problemas
npm cache clean --force

Agente no responde

  1. Asegúrate de estar en un IDE con IA (Cursor, VS Code con Claude, etc.) o Claude Code CLI
  2. Verifica que estás usando sintaxis correcta: @nombre-del-agente
  3. Verifica que el archivo del agente existe: ls .aiox-core/development/agents/

Errores de permisos

# Corregir permisos npm (macOS/Linux)
sudo chown -R $(whoami) ~/.npm

# O usa un gestor de versiones Node (recomendado)
# nvm, fnm, o volta

Estructura AIOX no encontrada

# Reinstalar AIOX en el proyecto actual
npx aiox-core@latest install

# O clonar de nuevo
git clone https://github.com/SynkraAI/aiox-core.git

Obtener Ayuda

¡Bienvenido a AIOX! ¡Feliz coding!