[SEMANA-3-AGENTES] feat: Add IDE configurations (L3)

- Add CLAUDE.md with project-specific instructions
- Add .trae/rules/ and AGENT-CAPABILITIES.md
- Add .windsurf/rules/ and AGENT-CAPABILITIES.md
- Add .gemini/antigravity/README.md
- Stack: Express.js 5.0.1 + React 18.2.0 + Python/FastAPI (hybrid)
- Type: STANDALONE (no propagation)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-01-24 17:45:06 -06:00
parent b77ac246b4
commit fea1f67e9a
6 changed files with 700 additions and 0 deletions

View File

@ -0,0 +1,130 @@
# Gemini Agent Configuration - Trading Platform
**Proyecto:** trading-platform
**Tipo:** STANDALONE
**Sistema:** SIMCO v4.0.0 + NEXUS v4.0
---
## Herencia
Este proyecto hereda configuraciones de:
- `workspace-v2/.gemini/antigravity/`
- `workspace-v2/orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
- `workspace-v2/orchestration/agents/configs/SHARED-PROJECT-REGISTRY.yml`
---
## Identificación del Proyecto
```yaml
aliases: ["trading-platform", "trading", "oqi"]
root: "projects/trading-platform/"
type: "STANDALONE"
nivel_nexus: "L2"
arquitectura: "hybrid"
```
---
## Stack Tecnológico
### TypeScript Stack
| Componente | Tecnología |
|------------|------------|
| Backend | Express.js 5.0.1 |
| Frontend | React 18.2.0 |
| Build | Vite 6.2.0 |
### Python Stack
| Componente | Tecnología |
|------------|------------|
| ML Engine | FastAPI |
| Data Service | Python 3.11 |
| ML Libraries | TensorFlow, scikit-learn |
---
## Credenciales BD
```yaml
db_name: trading_platform
db_user: trading_user
db_pass: trading_dev_2026
db_port: 5432
schemas:
- core
- trading
- ml
- portfolio
```
---
## Boot Sequence
Al trabajar en este proyecto:
1. Cargar `workspace-v2/CLAUDE.md`
2. Cargar `projects/trading-platform/CLAUDE.md`
3. Cargar `orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
4. Identificar stack (TypeScript vs Python)
5. Cargar contexto específico según tarea
---
## Servicios y Puertos
| Servicio | Puerto | Stack |
|----------|--------|-------|
| Backend API | 3080 | TypeScript |
| Frontend | 3000 | TypeScript |
| ML Engine | 3083 | Python |
| Trading Agents | 3086 | Python |
| LLM Agent | 3085 | Python |
| MCP Auth | 3095 | TypeScript |
| MCP Wallet | 3090 | TypeScript |
---
## Epics en Desarrollo (9)
| ID | Nombre | Progreso |
|----|--------|----------|
| OQI-001 | fundamentos-auth | 70% |
| OQI-002 | educativo | 30% |
| OQI-003 | trading-charts | 40% |
| OQI-004 | cuentas-inversion | 35% |
| OQI-005 | pagos-stripe | 50% |
| OQI-006 | senales-ml | 60% |
| OQI-007 | llm-strategy-agent | 25% |
| OQI-008 | portfolio-manager | 20% |
| OQI-009 | mt4-gateway | 15% |
---
## Paths de Trabajo
```
Backend: projects/trading-platform/apps/backend/src/
Frontend: projects/trading-platform/apps/frontend/src/
ML Engine: projects/trading-platform/apps/ml-engine/
Database: projects/trading-platform/apps/database/
MCPs: projects/trading-platform/mcp-*/
Docs: projects/trading-platform/docs/
```
---
## Propagación
Como STANDALONE, NO propaga a otros proyectos.
Completamente independiente.
---
## Referencias
- CLAUDE.md: `projects/trading-platform/CLAUDE.md`
- Directivas: `projects/trading-platform/orchestration/directivas/`
- Inventarios: `projects/trading-platform/orchestration/inventarios/`

View File

@ -0,0 +1,75 @@
# Agent Capabilities - Trae IDE (Trading Platform)
**Proyecto:** trading-platform
**Versión:** 1.0.0
**Sistema:** SIMCO v4.0.0
---
## Herencia
Este archivo extiende:
- `workspace-v2/.trae/rules.md`
- `workspace-v2/orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
---
## Capacidades en este Proyecto
### Operaciones Permitidas
| Operación | Status | Notas |
|-----------|--------|-------|
| Crear módulos backend (TS) | ✅ | Express.js en apps/backend/ |
| Crear componentes frontend | ✅ | React en apps/frontend/ |
| Modificar ML engine (Python) | ✅ | FastAPI en apps/ml-engine/ |
| Crear MCPs | ✅ | Servicios MCP en raíz |
| Modificar DDL | ✅ | Con validación de coherencia |
| Escribir tests | ✅ | Jest (TS) + Pytest (Python) |
| Git operations | ✅ | Commit, push, pull |
### Limitaciones Específicas
1. **NO ejecutar** trades reales en desarrollo
2. **NO usar** API keys de producción
3. **NO mezclar** código TypeScript y Python en mismo servicio
---
## Validaciones Requeridas
Antes de marcar tarea como completada:
```bash
# Backend TypeScript
cd apps/backend
npm run build
npm run lint
npm run test
# Frontend
cd apps/frontend
npm run build
npm run lint
# ML Engine (Python)
cd apps/ml-engine
python -m pytest
```
---
## Contexto del Proyecto
- **12 apps/módulos** en monorepo
- **9 epics** en desarrollo
- **Arquitectura híbrida** TypeScript + Python
- **Tipo** STANDALONE (independiente)
---
## Quick Reference
- CLAUDE.md: `projects/trading-platform/CLAUDE.md`
- Rules: `projects/trading-platform/.trae/rules/project_rules.md`
- Docs: `projects/trading-platform/docs/`

View File

@ -0,0 +1,102 @@
# Project Rules - Trading Platform (Trae IDE)
**Proyecto:** trading-platform
**Tipo:** STANDALONE
**Sistema:** SIMCO v4.0.0
---
## Reglas Heredadas
Este proyecto hereda TODAS las reglas de:
- `workspace-v2/CLAUDE.md`
- `workspace-v2/.trae/rules.md`
Las reglas aquí son EXTENSIONES específicas del proyecto.
---
## Arquitectura Híbrida
- **TypeScript:** Express.js backend, React frontend, MCPs
- **Python:** FastAPI (ml-engine, data-service)
- **Monorepo:** Múltiples apps en `/apps/` y servicios MCP en raíz
---
## Stack
- **Backend API:** Express.js 5.0.1
- **Frontend:** React 18.2.0 + Vite 6.2.0
- **ML Engine:** FastAPI + Python 3.11
- **Database:** PostgreSQL 16+
- **Cache:** Redis 7.x
---
## Credenciales BD
```
DB_HOST=localhost
DB_PORT=5432
DB_NAME=trading_platform
DB_USER=trading_user
DB_PASS=trading_dev_2026
```
---
## Reglas Específicas
### 1. Separación TypeScript/Python
- NO mezclar código entre stacks
- Comunicación via REST/gRPC únicamente
- Cada servicio tiene su propio package.json o requirements.txt
### 2. Trading Safety
- NUNCA ejecutar trades reales sin confirmación explícita
- Usar modo sandbox en desarrollo
- Validar límites de riesgo en código
### 3. ML Models
- Modelos en `apps/ml-engine/`
- Backtesting obligatorio antes de deploy
- Documentar métricas de performance
### 4. Tests
Cobertura mínima: 60%
- TypeScript: `npm run test`
- Python: `pytest`
---
## Paths de Trabajo
```
Backend: projects/trading-platform/apps/backend/src/
Frontend: projects/trading-platform/apps/frontend/src/
ML Engine: projects/trading-platform/apps/ml-engine/
Database: projects/trading-platform/apps/database/
MCPs: projects/trading-platform/mcp-*/
```
---
## Propagación
Como STANDALONE, trading-platform:
- **NO propaga** a otros proyectos
- **NO recibe** de otros proyectos
- Es completamente independiente
---
## Referencias
- CLAUDE.md local: `projects/trading-platform/CLAUDE.md`
- Directivas: `projects/trading-platform/orchestration/directivas/`
- Inventarios: `projects/trading-platform/orchestration/inventarios/`

View File

@ -0,0 +1,75 @@
# Agent Capabilities - Windsurf IDE (Trading Platform)
**Proyecto:** trading-platform
**Versión:** 1.0.0
**Modelo:** Cascade AI (NO-RAZONADOR)
---
## Paradigma NO-RAZONADOR
Windsurf NO toma decisiones autónomas.
Ejecuta instrucciones LITERALES únicamente.
---
## Capacidades
| Capacidad | Status |
|-----------|--------|
| Edición de archivos | ✅ |
| Creación de archivos | ✅ |
| Ejecución de comandos | ✅ |
| Git operations | ✅ |
| Decisiones autónomas | ❌ |
| Resolución de ambigüedad | ❌ |
---
## Limitaciones Críticas
1. **NO puede** interpretar instrucciones vagas
2. **NO puede** elegir entre alternativas
3. **NO puede** modificar plan sin aprobación
4. **Max 50 líneas** por operación
5. **NO puede** ejecutar trades reales
6. **NO puede** mezclar TypeScript/Python
---
## Formato de Tarea Atómica
```yaml
tarea:
id: "TASK-XXX-T01"
archivo: "path/to/file.ts"
stack: "typescript" # o "python"
operacion: "EDITAR"
lineas_desde: 45
lineas_hasta: 52
codigo_actual: |
// código exacto actual
codigo_nuevo: |
// código exacto nuevo
validacion:
- "npm run build" # o "pytest" para Python
- "npm run lint"
```
---
## Protocolo de Bloqueo
Si hay ambigüedad:
1. DETENER inmediatamente
2. NO intentar resolver
3. Reportar en BLOCKED-TASKS.yml
4. Esperar resolución de agente superior
---
## Referencias
- Shared configs: `orchestration/agents/configs/`
- Platform config: `orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
- Project rules: `.windsurf/rules/project_rules.md`

View File

@ -0,0 +1,115 @@
# Project Rules - Trading Platform (Windsurf IDE)
**Proyecto:** trading-platform
**Tipo:** STANDALONE
**Sistema:** SIMCO v4.0.0
---
## IMPORTANTE: Windsurf es NO-RAZONADOR
Windsurf con Cascade NO razona autónomamente.
Sigue instrucciones LITERALMENTE.
Si hay ambigüedad:
1. DETENER
2. Reportar en orchestration/trazas/BLOCKED-TASKS.yml
3. Esperar resolución
---
## Reglas Heredadas
Hereda TODAS las reglas de:
- `workspace-v2/CLAUDE.md`
- `workspace-v2/.windsurf/rules.md`
---
## Arquitectura Híbrida
```yaml
typescript:
backend: Express.js 5.0.1
frontend: React 18.2.0 + Vite 6.2.0
mcps: Servicios independientes
python:
ml_engine: FastAPI + Python 3.11
data_service: Processing
```
---
## Credenciales BD
```
DB_HOST=localhost
DB_PORT=5432
DB_NAME=trading_platform
DB_USER=trading_user
DB_PASS=trading_dev_2026
```
---
## Paths Absolutos
```
Backend: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\backend\src\
Frontend: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\frontend\src\
ML Engine: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\ml-engine\
Database: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\database\
```
---
## Reglas de Edición
1. **Max 50 líneas** por cambio
2. **NO usar placeholders** (// ... resto del código)
3. **Código LITERAL** siempre
4. **Verificar** archivo existe antes de editar
5. **NO mezclar** TypeScript y Python en mismo archivo
---
## Validaciones Post-Cambio
```cmd
# Para TypeScript
cd C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\backend
npm run build
npm run lint
# Para Frontend
cd C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\frontend
npm run build
npm run lint
# Para Python
cd C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\ml-engine
python -m pytest
```
---
## Epics/Módulos (9)
```
fundamentos-auth, educativo, trading-charts,
cuentas-inversion, pagos-stripe, senales-ml,
llm-strategy-agent, portfolio-manager, mt4-gateway
```
---
## Bloqueos
Si encuentras:
- Ambigüedad en instrucciones → BLOQUEAR
- Archivo no existe → BLOQUEAR
- Mezcla TypeScript/Python → BLOQUEAR
- Trade real en desarrollo → BLOQUEAR
Reportar en: `orchestration/trazas/BLOCKED-TASKS.yml`

203
CLAUDE.md Normal file
View File

@ -0,0 +1,203 @@
# CLAUDE.md - Trading Platform
**Hereda de:** workspace-v2/CLAUDE.md
**Sistema:** SIMCO v4.0.0 + NEXUS v4.0
**Proyecto:** trading-platform
**Tipo:** STANDALONE
**Versión:** 1.0.0
**Actualizado:** 2026-01-24
---
## EXTENSIONES LOCALES
Este archivo EXTIENDE (no reemplaza) las reglas del workspace.
Para reglas base, ver: `../../CLAUDE.md`
---
## ARQUITECTURA HIBRIDA
Este proyecto usa una arquitectura híbrida TypeScript + Python:
```
┌─────────────────────────────────────────────────────────┐
│ TRADING PLATFORM │
├──────────────────────┬──────────────────────────────────┤
│ TypeScript Stack │ Python Stack │
├──────────────────────┼──────────────────────────────────┤
│ • Express.js Backend │ • FastAPI (ml-engine) │
│ • React Frontend │ • Data Service │
│ • MCP Connectors │ • Trading Agents │
│ • Portfolio Manager │ • Prediction Models │
└──────────────────────┴──────────────────────────────────┘
```
---
## STACK TECNOLOGICO
| Capa | Tecnología | Versión |
|------|------------|---------|
| Backend API | Express.js | 5.0.1 |
| Frontend | React | 18.2.0 |
| Build Tool | Vite | 6.2.0 |
| ML Engine | FastAPI (Python) | 3.11 |
| Database | PostgreSQL | 16+ |
| Cache | Redis | 7.x |
| Charts | lightweight-charts | 4.1.1 |
| State | Zustand | 4.4.7 |
| Data Fetching | TanStack Query | 5.14.0 |
---
## CREDENCIALES BD
```
Database: trading_platform
User: trading_user
Password: trading_dev_2026
Port: 5432
Host: localhost
Schemas: core, trading, ml, portfolio
```
---
## ESTRUCTURA DEL MONOREPO
```
trading-platform/
├── apps/
│ ├── backend/ → Express.js API
│ ├── frontend/ → React SPA
│ ├── database/ → DDL/Schemas
│ ├── data-service/ → Python data aggregation
│ ├── ml-engine/ → Python ML service
│ ├── mcp-binance-connector/
│ └── mcp-mt4-connector/
├── mcp-auth/ → Auth service (port 3095)
├── mcp-wallet/ → Wallet service (port 3090)
├── mcp-products/ → Products service (port 3091)
├── mcp-vip/ → VIP service (port 3092)
├── mcp-investment/ → Investment service (port 3093)
├── mcp-predictions/ → ML signals (port 3094)
├── packages/ → Shared packages
└── docker/ → Docker configs
```
---
## MODULOS/EPICS (9)
| ID | Módulo | Progreso | Descripción |
|----|--------|----------|-------------|
| OQI-001 | fundamentos-auth | 70% | Autenticación base |
| OQI-002 | educativo | 30% | Módulo educativo |
| OQI-003 | trading-charts | 40% | Charts de trading |
| OQI-004 | cuentas-inversion | 35% | Cuentas de inversión |
| OQI-005 | pagos-stripe | 50% | Integración Stripe |
| OQI-006 | senales-ml | 60% | Señales ML |
| OQI-007 | llm-strategy-agent | 25% | Agente LLM |
| OQI-008 | portfolio-manager | 20% | Gestión portafolio |
| OQI-009 | mt4-gateway | 15% | Gateway MetaTrader |
---
## PUERTOS DE SERVICIOS
| Servicio | Puerto |
|----------|--------|
| Backend API | 3080 |
| Frontend | 3000 |
| ML Engine | 3083 |
| Trading Agents | 3086 |
| LLM Agent | 3085 |
| MCP Auth | 3095 |
| MCP Wallet | 3090 |
| MCP Products | 3091 |
| MCP VIP | 3092 |
| MCP Investment | 3093 |
| MCP Predictions | 3094 |
---
## REGLAS ESPECIFICAS
### 1. Código TypeScript vs Python
- **TypeScript:** APIs, Frontend, MCPs
- **Python:** ML, Data processing, Trading agents
- NO mezclar: cada servicio es independiente
### 2. ML Models
- Los modelos ML están en `apps/ml-engine/`
- Usar TensorFlow para predicciones
- Validar con backtesting antes de deploy
### 3. Trading Safety
- NUNCA ejecutar trades reales sin confirmación
- Usar modo sandbox en desarrollo
- Validar límites de riesgo
### 4. API Keys
- Binance API: Solo read en desarrollo
- MT4: Cuenta demo únicamente
- Stripe: Test mode
---
## VALIDACIONES ADICIONALES
Además de las validaciones del workspace:
1. **TypeScript Backend:**
```bash
cd apps/backend && npm run build && npm run lint
```
2. **Frontend:**
```bash
cd apps/frontend && npm run build && npm run lint
```
3. **Python Services:**
```bash
cd apps/ml-engine && python -m pytest
```
---
## ALIASES LOCALES
- `@BACKEND` → apps/backend/src/
- `@FRONTEND` → apps/frontend/src/
- `@ML` → apps/ml-engine/
- `@DDL` → apps/database/
- `@DOCS` → docs/
- `@MCP` → mcp-*/
---
## ANTES DE IMPLEMENTAR
1. Identificar si es TypeScript o Python
2. Verificar módulo/epic correspondiente
3. Consultar directivas en `orchestration/directivas/`
4. Verificar impacto en otros servicios
---
## DESPUES DE IMPLEMENTAR
1. Actualizar inventarios locales
2. Ejecutar tests del servicio afectado
3. Commit y push siguiendo SIMCO-GIT
4. NO hay propagación (STANDALONE)
---
*Trading Platform v1.0.0 - Sistema SIMCO v4.0.0*