workspace/README.md

Workspace - Fábrica de Software con Agentes IA

Visión General

Este workspace implementa una arquitectura integral para desarrollo de software gestionado por agentes de IA, con soporte para múltiples proyectos, reutilización de componentes y base de conocimiento compartida.

Estructura Principal

~/workspace/
├── core/                    # Núcleo de la fábrica
│   ├── orchestration/       # Sistema de agentes unificado
│   ├── modules/             # Módulos de código reutilizables
│   └── standards/           # Estándares técnicos globales
│
├── projects/                # Proyectos/Productos
│   ├── erp-suite/           # Suite ERP (verticales)
│   ├── gamilit/             # Plataforma EdTech
│   ├── trading-platform/    # Bots de trading
│   ├── betting-analytics/   # Predicción apuestas
│   └── inmobiliaria-analytics/
│
├── customers/               # Implementaciones personalizadas
│   └── template/            # Template para nuevos clientes
│
├── knowledge-base/          # Base de conocimiento (RAG)
│   ├── patterns/            # Patrones de diseño
│   ├── reference/           # Código de referencia
│   ├── guides/              # Guías de integración
│   └── snippets/            # Snippets reutilizables
│
├── workspaces/              # Workspaces efímeros por tarea
│
└── devtools/                # Herramientas de desarrollo
    ├── scripts/             # Scripts de automatización
    ├── templates/           # Templates de proyectos
    └── docker/              # Configuración Docker

Sistema de Agentes

El workspace utiliza el Sistema NEXUS para orquestación de agentes:

Agentes Orquestadores

• NEXUS-BACKEND - NestJS, APIs, servicios
• NEXUS-FRONTEND - React, componentes, UI
• NEXUS-DATABASE - PostgreSQL, schemas, RLS
• NEXUS-DEVOPS - CI/CD, deployment
• NEXUS-INTEGRATION - Validación 3 capas
• NEXUS-TESTING - QA, tests E2E

Principios de Orquestación

1. Cualquier agente puede orquestar a cualquier otro
2. Contexto completo en cada invocación
3. Fases anidadas: Análisis → Planeación → Validación → Ejecución
4. Pool compartido de 15 subagentes

Inicio Rápido

Clonar el workspace

# Clon completo con submodules (Odoo, etc.)
git clone --recurse-submodules https://github.com/rckrdmrd/workspace.git
cd workspace

# Ver guía de setup completa
cat SETUP.md

Usar el script de desarrollo

# Ver comandos disponibles
./devtools/scripts/dev.sh help

# Ver estado del workspace
./devtools/scripts/dev.sh status

# Iniciar servicios Docker (PostgreSQL, Redis, etc.)
./devtools/scripts/dev.sh docker-up

# Iniciar un proyecto
./devtools/scripts/dev.sh start gamilit
./devtools/scripts/dev.sh start trading
./devtools/scripts/dev.sh start mecanicas

# Instalar todas las dependencias
./devtools/scripts/dev.sh install

# Ver asignación de puertos
./devtools/scripts/dev.sh ports

Para trabajar en un proyecto existente

cd ~/workspace/projects/<proyecto>
npm install  # Instalar dependencias

# Leer el contexto del proyecto
cat orchestration/PROXIMA-ACCION.md
cat orchestration/00-guidelines/CONTEXTO-PROYECTO.md

Para crear un nuevo proyecto

./devtools/scripts/bootstrap-project.sh <nombre> <tipo>

Proyectos Activos

Proyecto	Estado	Backend	Frontend
Gamilit	MVP 60%	NestJS :3000	React :5173
Trading Platform	50%	Express :3001	React :5174
ERP Suite	35%	Express :3010+	React :5175
Mecánicas Diesel	MVP 95%	Express :3011	-

CI/CD

GitHub Actions configurados en .github/workflows/:

• ci.yml - Lint, test, build por proyecto
• docker-build.yml - Construcción de imágenes Docker

Documentación

• Sistema de Agentes: core/orchestration/README.md
• Directivas Globales: core/orchestration/directivas/
• Estándares: core/standards/
• Por Proyecto: projects/<proyecto>/docs/

Enlaces Útiles

• Análisis de Implementación
• Arquitectura de Orquestación
• Sugerencias y Mejores Prácticas

---

Workspace creado: 2025-12-05 Basado en: Sistema NEXUS de Gamilit + Arquitectura Integral de Fábrica de Software