Claude Code Compound Engineering

El plugin Compound Engineering extiende Claude Code con agentes especializados, comandos slash, habilidades y flujos de trabajo estructurados para ciclos de Planificar, Trabajar, Revisar y Componer.

Instalación

Paso	Comando
Instalar Claude Code	Sigue la configuración en claude.ai/code
Clonar plugin	git clone https://github.com/anthropics/claude-code-plugins
Agregar a Claude Code	Agrega la ruta del plugin en la configuración de Claude Code
Verificar	Ejecuta /help en Claude Code para ver los comandos disponibles

Ciclo de trabajo principal

Fase	Comando Slash	Descripción
Planificar	/plan	Transforma descripciones de funcionalidades en planes de implementación estructurados
Trabajar	/lfg	Ingeniería autónoma completa — ejecuta planes con coordinación multi-agente
Revisar	/review-pr	Revisión integral de PR usando agentes especializados en paralelo
Componer	/compound	Documenta problemas resueltos para construir conocimiento institucional

Comandos Slash

Planificación y arquitectura

Comando	Descripción
/plan	Crear planes de implementación estructurados con detalle a nivel de archivo
/brainstorm	Explorar requisitos y enfoques antes de planificar
/deepen-plan	Mejorar un plan con agentes de investigación en paralelo para profundidad y mejores prácticas
/plan_review	Múltiples agentes especializados revisan un plan en paralelo

Desarrollo y ejecución

Comando	Descripción
/lfg	Flujo completo de ingeniería autónoma — planificar, implementar, probar, revisar
/resolve_parallel	Resolver todos los comentarios TODO usando procesamiento en paralelo
/resolve_pr_parallel	Resolver todos los comentarios de PR usando procesamiento en paralelo
/resolve_todo_parallel	Resolver todos los todos pendientes del CLI usando procesamiento en paralelo

Revisión y calidad

Comando	Descripción
/review-pr	Revisión integral de PR con agentes especializados (código, seguridad, rendimiento)
/code-review	Revisar un cambio de código específico contra el plan y estándares
/test-browser	Ejecutar pruebas de navegador en páginas afectadas por el PR o rama actual
/reproduce-bug	Reproducir e investigar bugs usando registros, consola y capturas de pantalla

Documentación y conocimiento

Comando	Descripción
/compound	Documentar un problema resuelto para conocimiento institucional
/changelog	Crear changelogs atractivos para merges recientes a main
/deploy-docs	Validar y preparar documentación para GitHub Pages
/release-docs	Construir y actualizar sitio de documentación con componentes actuales

Utilidades

Comando	Descripción
/generate_command	Crear un nuevo comando slash personalizado
/triage	Clasificar y categorizar hallazgos para el sistema de todos del CLI
/feature-video	Grabar un video de demostración de funcionalidad y agregar a la descripción del PR
/agent-native-audit	Ejecutar revisión integral de arquitectura agent-native

Agentes especializados

Agentes de revisión de código

Agente	Propósito
code-reviewer	Revisa bugs, errores lógicos, seguridad y calidad de código
code-simplifier	Simplifica código para mayor claridad preservando funcionalidad
silent-failure-hunter	Identifica fallos silenciosos y manejo inadecuado de errores
comment-analyzer	Analiza comentarios para precisión y mantenibilidad
pr-test-analyzer	Revisa calidad y completitud de cobertura de pruebas
type-design-analyzer	Análisis experto de diseño de tipos e invariantes
code-simplicity-reviewer	Pase final para cumplimiento YAGNI y complejidad mínima

Agentes de arquitectura y seguridad

Agente	Propósito
architecture-strategist	Evalúa decisiones de diseño del sistema y límites de componentes
security-sentinel	Auditorías de seguridad, evaluación de vulnerabilidades, cumplimiento OWASP
performance-oracle	Analiza rendimiento, algoritmos, cuellos de botella, escalabilidad
agent-native-reviewer	Asegura que las funcionalidades sean accesibles para agentes, no solo humanos
pattern-recognition-specialist	Detecta patrones de diseño, anti-patrones y duplicación de código

Revisores específicos por lenguaje

Agente	Propósito
kieran-rails-reviewer	Revisión estricta de convenciones y calidad de Rails
kieran-python-reviewer	Revisión estricta de convenciones y calidad de Python
kieran-typescript-reviewer	Revisión estricta de convenciones y calidad de TypeScript
dhh-rails-reviewer	Revisión de Rails desde la perspectiva de DHH — detección de anti-patrones
julik-frontend-races-reviewer	Detección de condiciones de carrera en frontend JS/Stimulus

Agentes de datos y despliegue

Agente	Propósito
data-integrity-guardian	Migraciones de base de datos, restricciones de datos, integridad referencial
data-migration-expert	Valida mapeos de ID, seguridad de rollback, transformaciones de datos
deployment-verification-agent	Listas de verificación pre/post-despliegue, verificación SQL, planes de rollback

Agentes de investigación

Agente	Propósito
framework-docs-researcher	Obtiene documentación completa de frameworks y mejores prácticas
learnings-researcher	Busca aprendizajes institucionales en docs/solutions/
best-practices-researcher	Recopila mejores prácticas externas de documentación y OSS
git-history-analyzer	Análisis arqueológico del historial git y evolución del código
repo-research-analyst	Análisis integral de estructura y patrones del repositorio

Agentes de diseño

Agente	Propósito
figma-design-sync	Sincroniza la implementación con diseños de Figma
design-implementation-reviewer	Verifica que la UI coincida con las especificaciones de Figma
design-iterator	Refinamiento iterativo de diseño mediante N ciclos de captura-análisis-corrección

Habilidades

Habilidades de desarrollo

Habilidad	Activador
frontend-design	Construir componentes web con alta calidad de diseño
agent-native-architecture	Diseñar aplicaciones donde los agentes son ciudadanos de primera clase
dspy-ruby	Framework Ruby para aplicaciones LLM composables y type-safe
andrew-kane-gem-writer	Escribir gems de Ruby siguiendo patrones de Andrew Kane
dhh-rails-style	Escribir código Ruby/Rails al estilo DHH de 37signals

Habilidades de flujo de trabajo

Habilidad	Activador
brainstorming	Explorar intención y enfoques antes de la implementación
git-worktree	Gestionar Git worktrees para desarrollo paralelo aislado
file-todos	Gestionar sistema de seguimiento de tareas basado en archivos
every-style-editor	Revisar y editar texto para la guía de estilo de Every
compound-docs	Capturar problemas resueltos como documentación categorizada

Habilidades de integración de herramientas

Habilidad	Activador
agent-browser	Automatización del navegador usando el CLI agent-browser de Vercel
rclone	Subir y sincronizar archivos entre proveedores de almacenamiento en la nube
gemini-imagegen	Generar y editar imágenes usando la API de Gemini
xcode-test	Compilar y probar aplicaciones iOS en el simulador
skill-creator	Guía para crear nuevas habilidades efectivas

Hooks

Hook	Evento	Propósito
SessionStart	Inicialización de sesión	Configurar contexto, cargar memorias
PreToolUse	Antes de la ejecución de herramienta	Validar, bloquear comandos peligrosos
PostToolUse	Después de la ejecución de herramienta	Procesar resultados, activar seguimientos
Stop	Finalización del agente	Verificaciones finales, limpieza
UserPromptSubmit	El usuario envía un mensaje	Pre-procesar entrada del usuario

Flujo de revisión multi-agente

El comando /review-pr lanza múltiples agentes especializados en paralelo:

┌─────────────────────────────────────────────────┐
│                  /review-pr                      │
├─────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │ Code     │  │ Security │  │ Perf     │      │
│  │ Reviewer │  │ Sentinel │  │ Oracle   │      │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘      │
│       │              │              │            │
│  ┌────┴─────┐  ┌────┴─────┐  ┌────┴─────┐      │
│  │ Silent   │  │ Type     │  │ Pattern  │      │
│  │ Failure  │  │ Design   │  │ Recog.   │      │
│  └────┬─────┘  └────┬─────┘  └────┴─────┘      │
│       └──────────┬───┘──────────────┘            │
│            Reporte Consolidado                   │
└─────────────────────────────────────────────────┘

Casos de uso comunes

Desarrollo de funcionalidades

# 1. Lluvia de ideas sobre el enfoque
/brainstorm

# 2. Crear un plan estructurado
/plan

# 3. Profundizar con agentes de investigación
/deepen-plan

# 4. Ejecutar de forma autónoma
/lfg

# 5. Revisar el PR
/review-pr

# 6. Documentar lo aprendido
/compound

Resolución de comentarios de PR

# Resolver todos los comentarios de PR en paralelo
/resolve_pr_parallel

# O resolver TODOs en todo el código
/resolve_parallel

Creación de comandos personalizados

# Generar un nuevo comando slash
/generate_command

# Crear una nueva habilidad
Usa la habilidad skill-creator como guía

Configuración

Estructura del plugin

compound-engineering/
├── plugin.json          # Manifiesto del plugin
├── commands/            # Definiciones de comandos slash
│   ├── lfg.md
│   ├── plan.md
│   ├── review-pr.md
│   └── ...
├── agents/              # Definiciones de agentes
│   ├── code-reviewer.md
│   ├── security-sentinel.md
│   └── ...
├── skills/              # Definiciones de habilidades
│   ├── frontend-design/
│   ├── agent-native-architecture/
│   └── ...
└── hooks/               # Hooks de eventos
    ├── session-start.md
    └── ...

Configuración de agentes

Los agentes se definen en archivos Markdown con frontmatter YAML:

---
name: "code-reviewer"
description: "Reviews code for bugs, logic errors, and quality"
tools:
  - Glob
  - Grep
  - Read
  - Task
model: sonnet  # or opus, haiku
---

Mejores prácticas

• Comienza con /brainstorm antes de saltar a la implementación — descubre casos extremos tempranamente
• Usa /plan para cualquier cosa no trivial — incluso funcionalidades “simples” se benefician del pensamiento estructurado
• Ejecuta /review-pr antes de fusionar — la revisión multi-agente detecta problemas que las revisiones de un solo pase no captan
• Documenta con /compound — el conocimiento institucional previene repetir errores
• Usa /deepen-plan para funcionalidades complejas — los agentes de investigación agregan profundidad desde documentación y mejores prácticas
• Aprovecha la resolución en paralelo — /resolve_parallel maneja TODOs más rápido que correcciones secuenciales
• Crea habilidades personalizadas para patrones repetidos — encapsula conocimiento del dominio para reutilización
• Usa el modelo haiku para agentes rápidos — minimiza costo y latencia para tareas sencillas

Solución de problemas

Problema	Solución
Agente no encontrado	Verifica la ruta del plugin en la configuración de Claude Code y reinicia
Comando no reconocido	Ejecuta /help para listar comandos disponibles, verifica plugin.json
Agente devuelve vacío	Verifica la disponibilidad del modelo, puede necesitar clave API para opus/sonnet
Revisión multi-agente lenta	Usa el modelo haiku para agentes rápidos, sonnet para los críticos
Habilidad no se activa	Verifica que la descripción de la habilidad coincida con la formulación de tu prompt
Hook no se dispara	Verifica que el tipo de evento del hook coincida (PreToolUse vs PostToolUse)
Plan demasiado vago	Usa /deepen-plan con agentes de investigación para más detalle
La revisión pierde contexto	Proporciona la URL del PR o nombre de rama explícitamente a /review-pr