Equipo de agentes IA · CreaRackSL

Referencia completa de agentes, perfiles y configuración Última actualización: Abril 2026

Arquitectura de agentes

Los agentes están distribuidos en dos repositorios según su naturaleza:

CreaRack-Pro/
└── Documentation/agents/          ← agentes técnicos especializados
    ├── dev-rack-editor.md            cargados via @ en CLAUDE.md
    ├── dev-map-editor.md             disponibles para Edu + Dani (Claude Code CLI)
    ├── dev-observatory.md            contexto profundo de cada módulo
    ├── dev-terminal.md
    ├── dev-signage.md
    ├── dev-auto-provision.md
    └── dev-cns.md

CreaRackSL-workspace/
└── agents/
    ├── biz/                        ← negocio (Txell via Claude Code)
    │   admin-billing · legal-rgpd · legal-contracts
    │   marketing-content · sales-outbound
    ├── dev/                        ← técnicos transversales (todos)
    │   dev-backend · dev-frontend
    │   dev-devops · dev-qa
    └── support/                    ← soporte y ventas (rotatorio)
        support-l1 · support-l2 · sales-demo

Por qué esta separación

Perfiles de sesión (workspace)

profile-biz · Txell

Archivo: profiles/profile-biz.md Agentes: admin-billing · legal-rgpd · legal-contracts · marketing-content · sales-outbound MCP servers: Gmail · Google Calendar Uso: Claude Code (Desktop app) → abrir en CreaRackSL-workspace/ → los agentes BIZ se cargan via @ en CLAUDE.md. Claude gestiona archivos y git automáticamente

profile-dev · Dani / Edu

Archivo: profiles/profile-dev.md Agentes workspace: dev-backend · dev-frontend · dev-devops · dev-qa Agentes CreaRack-Pro: cargados automáticamente via @Documentation/agents/ en CLAUDE.md MCP servers: GitHub · Filesystem Uso: Claude Code CLI en C:\dev\CreaRack-Pro — CLAUDE.md se carga automáticamente

profile-support · Rotatorio

Archivo: profiles/profile-support.md Agentes: support-l1 · support-l2 · sales-demo MCP servers: Gmail · Google Calendar Escalado: L1 (cualquiera) → L2 (Dani/Edu) → Crítico (Edu)

Agentes de negocio · workspace/agents/biz/

admin-billing

Propósito: Facturación, suscripciones, cobros y administración financiera. Conoce: IVA 21%, Modelo 303/200, retenciones IRPF 15%, formato factura CRK-YYYY-NNN Tareas: Facturas, seguimiento impagos, resumen mensual para asesoría, control gastos operativos Limitaciones: No reemplaza asesoría fiscal externa Pendiente: Datos SL (nombre legal, NIF, domicilio) al constituir la empresa

legal-rgpd

Propósito: Cumplimiento RGPD y LOPDGDD en el producto y la operativa. Conoce: RGPD (UE 2016/679) + LOPDGDD · AEPD · tipos de datos de CreaRack-Pro Tareas: Checklist ante nuevas funcionalidades, política de privacidad, RAT, DPAs con proveedores Limitaciones: Borradores y checklists — documentos vinculantes requieren abogado externo

legal-contracts

Propósito: Redacción y revisión de contratos. Conoce: Contratos SaaS, implantación, consultoría, NDA · cláusulas esenciales derecho español · SLA 99,5% Tareas: Borradores de contrato, NDAs, contratos con autónomos/agencias Limitaciones: Contratos >10.000€ o >1 año requieren revisión de abogado Pendiente: Ciudad para cláusula de jurisdicción

marketing-content

Propósito: Contenido de marketing: web, blog, LinkedIn, materiales de venta. Conoce: Tono NOC/técnico, público IT managers y responsables de red, keywords SEO, propuesta de valor Tareas: Posts LinkedIn, artículos blog, casos de éxito, fichas de producto, newsletter

sales-outbound

Propósito: Prospección comercial, leads y propuestas. Conoce: ICP (empresa 50-500 emp, CPD propio), proceso de venta 5 pasos, plantillas email frío, objeciones Tareas: Emails de prospección, follow-ups, argumentarios, propuestas con ROI

Agentes técnicos transversales · workspace/agents/dev/

Cubren el stack general y procesos transversales. Disponibles para todo el equipo.

dev-backend

Propósito: Stack backend general de CreaRack-Pro. Conoce: Django 6.0.3 · Python 3.14 · Django Ninja · Huey · PostgreSQL 18 · Valkey · VictoriaMetrics · RLS multi-tenancy · requirements.txt completo Restricciones: No usar Celery, NAPALM, Netmiko, DRF, TimescaleDB

dev-frontend

Propósito: Arquitectura frontend y patrones de desarrollo. Conoce: HTMX + JS Modular (112 archivos) · servicios centralizados · Konva.js · ECharts · xterm.js · Vite · estética NOC Restricciones: No jQuery · sin frameworks CSS externos · HTMX primero

dev-devops

Propósito: Infraestructura, despliegue y operaciones. Conoce: Hetzner Cloud · Dokploy + Traefik · Docker Compose · GitHub Actions · SSH producción · nombres reales de contenedores · backups Nota: Único agente con contexto de producción — útil también para Txell para entender el estado del sistema

dev-qa

Propósito: Calidad, testing y revisión de código. Conoce: pytest · pytest-asyncio · pytest-cov · checklist pre-PR · áreas críticas · 33/33 tests referencia

Agentes especializados por módulo · CreaRack-Pro/Documentation/agents/

Estado: ✅ Los 7 agentes especializados están creados y operativos (03-04-2026). Se cargan via @Documentation/agents/nombre.md en CLAUDE.md de CreaRack-Pro. Límite: ~50KB total entre todos los @ — cargar solo los relevantes para la sesión.

dev-rack-editor-source ✅

Archivo: Documentation/agents/dev-rack-editor-source.md Módulo: racks/ + static/js/pages/editor/ Cubre: Konva.js canvas, state management, 41+ endpoints, 6 modelos, stencils, SSH, backups

dev-map-editor ✅

Archivo: Documentation/agents/dev-map-editor.md Módulo: blueprints/ + static/js/pages/blueprints/ Cubre: 8 módulos JS, Auto-Plan AI, digitalización de planos, Konva.js drawing tools

dev-observatory ✅

Archivo: Documentation/agents/dev-observatory.md Módulo: monitoring/ + static/js/pages/observatory/ Cubre: Network Observatory, VictoriaMetrics, ECharts, SNMP polling, alerts Prioridad: Alta — muchos submódulos con lógica compleja

dev-terminal ✅

Archivo: Documentation/agents/dev-terminal.md Módulo: terminal/ + terminal/agent/ Cubre: Local Agent, multi-pane SSH, xterm.js, SFTP, CreaRackAgent.exe, Fleet Management

dev-signage ✅

Archivo: Documentation/agents/dev-signage.md Módulo: signage/ Cubre: Digital Signage CMS, playlists, scheduling, SVG composer, client portal, VAL adapters

dev-auto-provision ✅

Archivo: Documentation/agents/dev-auto-provision.md Módulo: network/ Cubre: SNMP agent, device discovery, network profiles, wizard pipeline

dev-cns ✅

Archivo: Documentation/agents/dev-cns.md Módulo: monitoring/ CNS + ITSM Cubre: Edge Intelligence, AI insights, ITSM integration, anomaly detection, WebSocket

Agentes de soporte · workspace/agents/support/

support-l1

Propósito: Atención primer nivel: dudas de uso, onboarding, incidencias comunes. Conoce: FAQ completo, formatos imagen (PNG/JPG/PDF, mínimo 150 DPI), conexión dispositivos, cuándo escalar a L2 Uso: Cualquier miembro del equipo

support-l2

Propósito: Diagnóstico técnico de incidencias escaladas. Conoce: Comandos diagnóstico (logs Django/Huey), checklist por tipo de incidencia, métricas a revisar Uso: Solo Dani o Edu

sales-demo

Propósito: Preparación y ejecución de demos para clientes potenciales. Conoce: Estructura demo 30-45min, 3 bloques (plano + dispositivos + valor), objeciones frecuentes Uso: Cualquier miembro del equipo

Hoja de ruta

Prioridad alta — próximas semanas

Prioridad media — cuando el módulo esté estable

Prioridad futura — cuando el equipo crezca

Cómo crear un agente especializado (CreaRack-Pro)

1. Crear CreaRack-Pro/Documentation/agents/dev-nombre.md
2. Estructura recomendada:

# Agente · dev-nombre

## Propósito
Una frase que describe qué hace este agente.

## Módulo
Archivos y apps Django que cubre.

## Arquitectura
Descripción de la estructura del módulo.

## Patrones y convenciones
Cómo está construido este módulo específicamente.

## APIs y endpoints relevantes
Endpoints Django Ninja del módulo.

## Tareas habituales
Lista de tareas concretas para este módulo.

## Integración con otros módulos
Dependencias y conexiones con otros agentes.

3. Añadir la referencia en CLAUDE.md de CreaRack-Pro:

@Documentation/agents/dev-nombre.md

4. Recordar el límite ~50KB total — no cargar todos los agentes a la vez.

Mantenimiento