rckrdmrd
ea1879f4ad
- Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
101 lines
3.5 KiB
Markdown
101 lines
3.5 KiB
Markdown
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
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
|
|
```bash
|
|
./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](/home/isem/docs-workspace/ANALISIS-IMPLEMENTACION-WORKSPACE.md)
|
|
- [Arquitectura de Orquestación](/home/isem/docs-workspace/ARQUITECTURA-ORQUESTACION-AGENTES.md)
|
|
- [Sugerencias y Mejores Prácticas](/home/isem/docs-workspace/SUGERENCIAS-MEJORES-PRACTICAS.md)
|
|
|
|
---
|
|
*Workspace creado: 2025-12-05*
|
|
*Basado en: Sistema NEXUS de Gamilit + Arquitectura Integral de Fábrica de Software*
|