VENOM v2

Quantum Auto-Parallelization Framework for Claude Code

VENOM v2 transforma Claude Code en un orquestador inteligente de múltiples agentes IA que trabajan en paralelo. Detecta automáticamente el tipo de tarea y ejecuta los agentes apropiados para máxima eficiencia.

Instalación

Instalación Local (Proyecto Específico)

# Navega a tu proyecto
cd mi-proyecto

# Instala VENOM
npx @elsabro/venom-v2 install

Instalación Global (Todos los Proyectos)

# Instala globalmente en ~/.claude
npx @elsabro/venom-v2 install --global

Nota: La instalación local tiene prioridad sobre la global. Puedes tener ambas sin conflictos.

Comandos CLI

| Comando | Descripción | |---------|-------------| | npx @elsabro/venom-v2 install | Instala en el proyecto actual | | npx @elsabro/venom-v2 install --global | Instala globalmente | | npx @elsabro/venom-v2 uninstall | Desinstala del proyecto | | npx @elsabro/venom-v2 uninstall --global | Desinstala instalación global | | npx @elsabro/venom-v2 update | Actualiza a la última versión | | npx @elsabro/venom-v2 help | Muestra ayuda completa | | npx @elsabro/venom-v2 version | Muestra versión actual |

Opciones

| Opción | Alias | Descripción | |--------|-------|-------------| | --global | -g | Instalación/desinstalación global | | --force | -f | Forzar sobreescritura | | --dry-run | -n | Simular sin hacer cambios |

Uso

Modo Automático (Por Defecto)

Simplemente escribe tu tarea en Claude Code. VENOM detecta automáticamente el tipo:

| Escribes... | Tipo Detectado | Agentes | |-------------|----------------|---------| | "implementa autenticación JWT" | EPIC_FEATURE | 3-4 por fase | | "arregla el bug de login" | BUG_FIX | 2 por fase | | "refactoriza el módulo de pagos" | REFACTOR | 2 por fase | | "explica cómo funciona el router" | EXPLORATION | 3 paralelo | | "revisa el código del PR" | REVIEW | 3 paralelo | | "typo rápido en el readme" | QUICK | 1 agente |

Modificadores en el Prompt

# Modo rápido - 1 solo agente, sin fases
"rápido: arregla el typo en el header"

# Modo exhaustivo - todas las fases completas
"exhaustivo: implementa sistema de notificaciones"

Comando Manual: /quantum

Para forzar máxima paralelización:

/quantum implementa sistema de cache con Redis

Arquitectura

12 Agentes Especializados

┌─────────────────────────────────────────────────────────────┐
│                    AGENTES VENOM v2                         │
├─────────────────────────────────────────────────────────────┤
│  EXPLORERS (haiku)     │  BUILDERS (sonnet)                │
│  - architecture        │  - code-implementer               │
│  - pattern             │  - test-writer                    │
│  - dependency          │  - doc-writer                     │
├─────────────────────────────────────────────────────────────┤
│  VALIDATORS (sonnet)   │  FIXERS (sonnet)                  │
│  - code-reviewer       │  - test-fixer                     │
│  - security-scanner    │  - lint-fixer                     │
│  - performance-analyzer│  - type-fixer                     │
└─────────────────────────────────────────────────────────────┘

Fases de Ejecución

1. Exploración - 3 agentes analizan arquitectura, patrones y dependencias en paralelo
2. Implementación - Código, tests y documentación se crean simultáneamente
3. Validación - Tests, lint y TypeScript se ejecutan en background
4. Auto-Fix - Corrección automática de errores encontrados
5. Review - 3 revisores paralelos (código, seguridad, performance)

Hooks Integrados

| Hook | Momento | Función | |------|---------|---------| | UserPromptSubmit | Al escribir | Detecta tipo de tarea, inyecta plan | | PostToolUse | Después de Edit/Write | Valida en background | | Stop | Al terminar | Verifica completitud |

Instalación Global vs Local

Local (default)

• Instala en .claude/ del proyecto actual
• Solo afecta a ese proyecto
• Ideal para proyectos con configuración específica

Global (--global)

• Instala en ~/.claude/
• Aplica a TODOS los proyectos
• No interfiere con instalaciones locales
• Las instalaciones locales siempre tienen prioridad

Sin Conflictos

VENOM está diseñado para no interferir con configuraciones existentes de Claude Code:

• Usa un archivo marcador .venom-installed para trackear su instalación
• Solo elimina archivos que él mismo creó
• Preserva archivos existentes al usar --force
• Desinstalación limpia que no afecta otros archivos

Estructura de Archivos

Al instalar, VENOM crea:

tu-proyecto/
├── .claude/
│   ├── .venom-installed          # Marcador de instalación
│   ├── settings.json             # Configuración de hooks
│   ├── hooks/
│   │   ├── quantum-detector.js   # Auto-detección de tareas
│   │   └── auto-validate.sh      # Validación en background
│   ├── skills/
│   │   └── quantum/SKILL.md      # Skill /quantum manual
│   └── agents/
│       ├── explorers/            # 3 agentes de exploración
│       ├── builders/             # 3 agentes de construcción
│       ├── validators/           # 3 agentes de validación
│       └── fixers/               # 3 agentes de corrección
└── CLAUDE.md                     # Actualizado con config de VENOM

Desinstalación

Del Proyecto Local

npx @elsabro/venom-v2 uninstall

Instalación Global

npx @elsabro/venom-v2 uninstall --global

La desinstalación:

• Elimina solo archivos creados por VENOM
• Preserva archivos que no son de VENOM
• Elimina directorios vacíos
• No elimina automáticamente la sección de CLAUDE.md (editar manualmente si deseas)

Actualización

# Actualiza la instalación local
npx @elsabro/venom-v2 update

# Actualiza la instalación global
npx @elsabro/venom-v2 update --global

El comando update:

1. Verifica la última versión en npm
2. Compara con la versión instalada
3. Reinstala si hay nueva versión disponible

Personalización

Edita tu CLAUDE.md para reglas personalizadas:

## Custom Rules
- NO usar security-scanner (proyecto interno)
- Tests siempre con coverage > 80%
- Skip doc-writer
- Usar Jest en lugar de Vitest

Requisitos

• Node.js >= 18.0.0
• Claude Code CLI instalado
• npm o npx disponible

Ejemplos

Instalar en proyecto nuevo

mkdir mi-proyecto && cd mi-proyecto
npm init -y
npx @elsabro/venom-v2 install

Ver qué haría sin instalar

npx @elsabro/venom-v2 install --dry-run

Forzar reinstalación

npx @elsabro/venom-v2 install --force

Instalar globalmente y verificar

npx @elsabro/venom-v2 install --global
ls ~/.claude/

Solución de Problemas

"Ya existe una carpeta .claude"

# Usa --force para agregar VENOM sin eliminar archivos existentes
npx @elsabro/venom-v2 install --force

"VENOM v2 ya está instalado"

# Para actualizar
npx @elsabro/venom-v2 update

# Para reinstalar desde cero
npx @elsabro/venom-v2 install --force

Desinstalar completamente

# Local
npx @elsabro/venom-v2 uninstall
rm -rf .claude/  # Si quieres eliminar todo

# Global
npx @elsabro/venom-v2 uninstall --global

Enlaces

• npm
• Issues

Licencia

MIT