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

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>

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