VENOM v2 - Quantum Auto-Parallelization Framework for Claude Code. Multi-agent orchestration with 12 specialized subagents.
npm install @elsabro/venom-v2Quantum 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.
---
``bashNavega a tu proyecto
cd mi-proyecto
$3
`bash
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 |$3
| Opción | Alias | Descripción |
|--------|-------|-------------|
|
--global | -g | Instalación/desinstalación global |
| --force | -f | Forzar sobreescritura |
| --dry-run | -n | Simular sin hacer cambios |---
Uso
$3
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 |
$3
`bash
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"
`$3
Para forzar máxima paralelización:
`bash
/quantum implementa sistema de cache con Redis
`---
Arquitectura
$3
`
┌─────────────────────────────────────────────────────────────┐
│ 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 │
└─────────────────────────────────────────────────────────────┘
`$3
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)
$3
| 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
$3
- Instala en .claude/ del proyecto actual
- Solo afecta a ese proyecto
- Ideal para proyectos con configuración específica$3
- Instala en ~/.claude/
- Aplica a TODOS los proyectos
- No interfiere con instalaciones locales
- Las instalaciones locales siempre tienen prioridad$3
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
$3
`bash
npx @elsabro/venom-v2 uninstall
`$3
`bash
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
`bash
Actualiza la instalación local
npx @elsabro/venom-v2 updateActualiza 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:`markdown
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
$3
`bash
mkdir mi-proyecto && cd mi-proyecto
npm init -y
npx @elsabro/venom-v2 install
`$3
`bash
npx @elsabro/venom-v2 install --dry-run
`$3
`bash
npx @elsabro/venom-v2 install --force
`$3
`bash
npx @elsabro/venom-v2 install --global
ls ~/.claude/
`---
Solución de Problemas
$3
`bash
Usa --force para agregar VENOM sin eliminar archivos existentes
npx @elsabro/venom-v2 install --force
`$3
`bash
Para actualizar
npx @elsabro/venom-v2 updatePara reinstalar desde cero
npx @elsabro/venom-v2 install --force
`$3
`bash
Local
npx @elsabro/venom-v2 uninstall
rm -rf .claude/ # Si quieres eliminar todoGlobal
npx @elsabro/venom-v2 uninstall --global
``---
---
MIT