Colección de Subagentes de Claude Code
Una colección integral de subagentes de IA especializados para Claude Code, diseñada para mejorar los flujos de trabajo de desarrollo con experiencia específica en cada dominio.
Descripción general
Este repositorio contiene 76 subagentes especializados que amplían las capacidades de Claude Code. Cada subagente es experto en un dominio específico, invocado automáticamente según el contexto o llamado explícitamente cuando sea necesario. Todos los agentes están configurados con modelos Claude específicos según la complejidad de la tarea para un rendimiento óptimo y rentabilidad.
Subagentes disponibles
Desarrollo y Arquitectura
- backend-architect - Diseña APIs RESTful, límites de microservicios y esquemas de bases de datos
- frontend-developer - Construye componentes React, implementa diseños responsivos y gestiona el estado del cliente
- ui-ux-designer - Crea diseños de interfaces, wireframes y sistemas de diseño
- ui-visual-validator - Verifica si las modificaciones de la UI han cumplido sus objetivos mediante análisis riguroso de capturas de pantalla
- mobile-developer - Desarrolla aplicaciones React Native o Flutter con integraciones nativas
- graphql-architect - Diseña esquemas GraphQL, resolutores y federación
- architect-reviewer - Revisa cambios de código para consistencia y patrones arquitectónicos
Especialistas en Lenguajes
- python-pro - Escribe código Python idiomático con características avanzadas y optimizaciones
- ruby-pro - Escribe código Ruby idiomático con metaprogramación, patrones Rails, desarrollo de gems y frameworks de pruebas
- golang-pro - Escribe código Go idiomático con goroutines, canales e interfaces
- rust-pro - Escribe código Rust idiomático con patrones de propiedad, ciclos de vida e implementación de traits
- c-pro - Escribe código C eficiente con correcta gestión de memoria y llamadas al sistema
- cpp-pro - Escribe código C++ idiomático con características modernas, RAII, smart pointers y algoritmos STL
- javascript-pro - Domina JavaScript moderno con ES6+, patrones asíncronos y APIs de Node.js
- typescript-pro - Domina TypeScript con tipos avanzados, genéricos y seguridad estricta de tipos
- php-pro - Escribe código PHP idiomático con características modernas y optimizaciones de rendimiento
- java-pro - Domina Java moderno con streams, concurrencia y optimización JVM
- elixir-pro - Escribe código Elixir idiomático con patrones OTP, programación funcional y frameworks Phoenix
- csharp-pro - Escribe código C# moderno con características avanzadas y optimización .NET
- scala-pro - Domina desarrollo Scala empresarial con programación funcional, sistemas distribuidos y procesamiento de big data
- flutter-expert - Domina el desarrollo con Flutter usando Dart, widgets e integraciones de plataforma
- unity-developer - Construye juegos en Unity con scripts optimizados y ajuste de rendimiento
- minecraft-bukkit-pro - Domina el desarrollo de plugins para servidores Minecraft con Bukkit, Spigot y APIs de Paper
- ios-developer - Desarrolla aplicaciones nativas iOS con Swift/SwiftUI
- sql-pro - Escribe consultas SQL complejas, optimiza planes de ejecución y diseña esquemas normalizados
Infraestructura y Operaciones
- devops-troubleshooter - Depura problemas en producción, analiza logs y soluciona fallos en despliegues
- deployment-engineer - Configura pipelines CI/CD, contenedores Docker y despliegues en la nube
- cloud-architect - Diseña infraestructura AWS/Azure/GCP y optimiza costos en la nube
- hybrid-cloud-architect - Diseña infraestructura híbrida en la nube entre AWS/Azure/GCP y entornos locales OpenStack
- kubernetes-architect - Diseña infraestructura cloud-native con Kubernetes como núcleo y principios GitOps en AWS/Azure/GCP y entornos híbridos.
- database-optimizer - Optimiza consultas SQL, diseña índices eficientes y gestiona migraciones de bases de datos
- database-admin - Administra operaciones de bases de datos, respaldos, replicación y monitoreo
- terraform-specialist - Escribe módulos avanzados de Terraform, gestiona archivos de estado e implementa mejores prácticas IaC
- incident-responder - Maneja incidentes de producción con urgencia y precisión
- network-engineer - Depura la conectividad de red, configura balanceadores de carga y analiza patrones de tráfico
- dx-optimizer - Especialista en Experiencia de Desarrollador que mejora herramientas, configuración y flujos de trabajo
Calidad y Seguridad
- code-reviewer - Revisión experta de código con enfoque profundo en seguridad de configuración y confiabilidad en producción
- security-auditor - Revisa código para detectar vulnerabilidades y asegurar cumplimiento OWASP
- test-automator - Crea suites de pruebas integrales con tests unitarios, de integración y e2e
- performance-engineer - Perfila aplicaciones, optimiza cuellos de botella e implementa estrategias de caché
- debugger - Especialista en depuración de errores, fallos de prueba y comportamientos inesperados
- error-detective - Busca patrones de error, rastros de pila y anomalías en registros y bases de código
- search-specialist - Experto en investigación web usando técnicas avanzadas de búsqueda y síntesis
Datos e IA
- data-scientist - Experto en análisis de datos para consultas SQL, operaciones BigQuery y obtención de insights
- data-engineer - Construye pipelines ETL, almacenes de datos y arquitecturas de streaming
- ai-engineer - Desarrolla aplicaciones LLM, sistemas RAG y pipelines de prompts
- ml-engineer - Implementa pipelines de ML, servición de modelos e ingeniería de características
- mlops-engineer - Construye pipelines de ML, seguimiento de experimentos y registros de modelos
- prompt-engineer - Optimiza prompts para LLMs y sistemas de IA
Dominios Especializados
- api-documenter - Crea especificaciones OpenAPI/Swagger y escribe documentación para desarrolladores
- payment-integration - Integra Stripe, PayPal y procesadores de pago
- quant-analyst - Construye modelos financieros, realiza backtesting de estrategias y analiza datos de mercado
- risk-manager - Monitorea riesgos de portafolio, múltiplos-R y límites de posición
- legacy-modernizer - Refactoriza bases de código legado e implementa modernización gradual
- context-manager - Gestiona contexto entre múltiples agentes y tareas de larga duración
Documentación
- docs-architect - Crea documentación técnica exhaustiva a partir de bases de código existentes
- mermaid-expert - Crea diagramas Mermaid para flujos, secuencias, ERDs y arquitecturas
- reference-builder - Genera referencias técnicas exhaustivas y documentación de API
- tutorial-engineer - Crea tutoriales paso a paso y contenido educativo a partir de código
Negocios y Marketing
- business-analyst - Analiza métricas, genera informes y rastrea KPIs
- content-marketer - Redacta publicaciones de blog, contenido para redes sociales y boletines por correo
- hp-pro - Socio para contrataciones, onboarding/offboarding, PTO y licencias, desempeño, políticas de cumplimiento y relaciones laborales.
- sales-automator - Redacta correos en frío, seguimientos y plantillas de propuestas
- customer-support - Gestiona tickets de soporte, respuestas a FAQ y correos de atención al cliente
- legal-advisor - Redacta políticas de privacidad, términos de servicio, avisos legales y descargos de responsabilidad
SEO y Optimización de Contenidos
- seo-content-auditor - Analiza el contenido proporcionado para calidad, señales E-E-A-T y mejores prácticas SEO
- seo-meta-optimizer - Crea títulos meta, descripciones y sugerencias de URL optimizadas
- seo-keyword-strategist - Analiza el uso de palabras clave, calcula la densidad, sugiere variaciones semánticas
- seo-structure-architect - Optimiza la estructura de contenido, jerarquía de encabezados y marcado schema
- seo-snippet-hunter - Da formato al contenido para snippets destacados y funciones SERP
- seo-content-refresher - Identifica elementos obsoletos y sugiere actualizaciones de contenido
- seo-cannibalization-detector - Analiza varias páginas para detectar solapamiento y conflictos de palabras clave
- seo-authority-builder - Analiza el contenido para señales E-E-A-T e indicadores de confianza
- seo-content-writer - Redacta contenido optimizado para SEO basado en palabras clave y briefs
- seo-content-planner - Crea esquemas de contenido, grupos temáticos y calendarios
Asignaciones de Modelos
Todos los 76 subagentes están configurados con modelos Claude específicos según la complejidad de la tarea:
🚀 Haiku (Rápido y Económico) - 15 agentes
Modelo:haiku
data-scientist- Consultas SQL y análisis de datosapi-documenter- Documentación OpenAPI/Swaggerreference-builder- Referencias técnicas exhaustivas y documentación de APIbusiness-analyst- Seguimiento de métricas y KPIscontent-marketer- Publicaciones de blog y redes socialescustomer-support- Tickets de soporte y preguntas frecuentessales-automator- Correos en frío y propuestassearch-specialist- Investigación web y recopilación de informaciónlegal-advisor- Políticas de privacidad y documentos de cumplimientoseo-meta-optimizer- Optimización de títulos y descripciones metaseo-keyword-strategist- Densidad de palabras clave y análisis semánticoseo-structure-architect- Estructura de contenido y marcado schemaseo-snippet-hunter- Formato para snippets destacadosseo-content-refresher- Actualizaciones de frescura de contenidoseo-cannibalization-detector- Detección de solapamiento de palabras claveseo-content-planner- Calendarios y esquemas de contenido
⚡ Sonnet (Rendimiento Equilibrado) - 45 agentes
Modelo:sonnetDesarrollo y Lenguajes:
python-pro- Desarrollo en Python con características avanzadasruby-pro- Desarrollo en Ruby con metaprogramación, patrones Rails y desarrollo de gemasjavascript-pro- JavaScript moderno y Node.jstypescript-pro- TypeScript avanzado con sistemas de tiposgolang-pro- Concurrencia en Go y patrones idiomáticosrust-pro- Seguridad de memoria en Rust y programación de sistemasc-pro- Programación en C y sistemas embebidoscpp-pro- C++ moderno con STL y plantillasphp-pro- PHP moderno con características avanzadasjava-pro- Java moderno con streams y concurrenciaelixir-pro- Elixir con patrones OTP y Phoenixcsharp-pro- C# moderno con frameworks .NET y patronesscala-pro- Scala empresarial con Apache Pekko, Akka, Spark y ZIO/Cats Effectflutter-expert- Desarrollo en Flutter con gestión de estado y animacionesunity-developer- Desarrollo y optimización de juegos en Unityminecraft-bukkit-pro- Desarrollo de plugins para Minecraft con Bukkit/Spigot/Paperios-developer- Desarrollo nativo en iOS con Swift/SwiftUIfrontend-developer- Componentes React y UIui-ux-designer- Diseño de interfaces y wireframesui-visual-validator- Validación rigurosa de UI mediante análisis de capturas de pantallabackend-architect- Diseño de API y microserviciosmobile-developer- Apps en React Native/Fluttersql-pro- Optimización compleja de SQLgraphql-architect- Esquemas y resolvers de GraphQL
devops-troubleshooter- Depuración en produccióndeployment-engineer- Pipelines de CI/CDdatabase-optimizer- Optimización de consultasdatabase-admin- Operaciones de base de datosterraform-specialist- Infraestructura como códigonetwork-engineer- Configuración de redesdx-optimizer- Experiencia del desarrolladordata-engineer- Pipelines ETL
test-automator- Creación de suites de pruebascode-reviewer- Análisis de calidad de códigodebugger- Investigación de erroreserror-detective- Análisis de registrosml-engineer- Despliegue de modelos de MLlegacy-modernizer- Migraciones de frameworkspayment-integration- Procesamiento de pagosmermaid-expert- Diagramas Mermaid y documentación visualflutter-expert- Desarrollo en Flutterseo-content-auditor- Auditoría de calidad de contenido y análisis E-E-A-Tseo-authority-builder- Optimización de señales de autoridadseo-content-writer- Creación de contenido optimizado para SEO
🧠 Opus (Capacidad Máxima) - 15 agentes
Modelo:opus
ai-engineer- Aplicaciones LLM y sistemas RAGsecurity-auditor- Análisis de vulnerabilidadesperformance-engineer- Optimización de aplicacionesincident-responder- Manejo de incidentes en producciónmlops-engineer- Infraestructura MLarchitect-reviewer- Consistencia arquitectónicacloud-architect- Diseño de infraestructura en la nubeprompt-engineer- Optimización de prompts para LLMcontext-manager- Coordinación multi-agentequant-analyst- Modelado financierorisk-manager- Gestión de riesgos de portafoliodocs-architect- Documentación técnica integral a partir de bases de códigotutorial-engineer- Tutoriales paso a paso y contenido educativo
Instalación
Estos subagentes están disponibles automáticamente al colocarlos en el directorio ~/.claude/agents/.
cd ~/.claude
git clone https://github.com/wshobson/agents.gitUso
Invocación Automática
Claude Code delegará automáticamente al subagente apropiado según el contexto de la tarea y la descripción del subagente.Invocación Explícita
Mencione al subagente por nombre en su solicitud:"Use the code-reviewer to check my recent changes"
"Have the security-auditor scan for vulnerabilities"
"Get the performance-engineer to optimize this bottleneck"Ejemplos de Uso
Tareas con un Solo Agente
# Code quality and review
"Use code-reviewer to analyze this component for best practices"
"Have code-reviewer scrutinize these configuration changes"
"Have security-auditor check for OWASP compliance issues"Development tasks
"Get backend-architect to design a user authentication API"
"Use frontend-developer to create a responsive dashboard layout"Infrastructure and operations
"Have devops-troubleshooter analyze these production logs"
"Use cloud-architect to design a scalable AWS architecture"
"Get network-engineer to debug SSL certificate issues"
"Use database-admin to set up backup and replication"Data and AI
"Get data-scientist to analyze this customer behavior dataset"
"Use ai-engineer to build a RAG system for document search"
"Have mlops-engineer set up MLflow experiment tracking"Business and marketing
"Have business-analyst create investor deck with growth metrics"
"Use content-marketer to write SEO-optimized blog post"
"Get sales-automator to create cold email sequence"
"Have customer-support draft FAQ documentation"Flujos de trabajo multiagente
Estos subagentes trabajan juntos sin problemas, y para orquestaciones más complejas, puedes usar la colección Claude Code Commands que ofrece 52 comandos predefinidos con barra que aprovechan estos subagentes en flujos de trabajo sofisticados.
# Feature development workflow
"Implement user authentication feature"
Automatically uses: backend-architect → frontend-developer → test-automator → security-auditor
Performance optimization workflow
"Optimize the checkout process performance"
Automatically uses: performance-engineer → database-optimizer → frontend-developer
Production incident workflow
"Debug high memory usage in production"
Automatically uses: incident-responder → devops-troubleshooter → error-detective → performance-engineer
Network connectivity workflow
"Fix intermittent API timeouts"
Automatically uses: network-engineer → devops-troubleshooter → performance-engineer
Database maintenance workflow
"Set up disaster recovery for production database"
Automatically uses: database-admin → database-optimizer → incident-responder
ML pipeline workflow
"Build end-to-end ML pipeline with monitoring"
Automatically uses: mlops-engineer → ml-engineer → data-engineer → performance-engineer
Product launch workflow
"Launch new feature with marketing campaign"
Automatically uses: business-analyst → content-marketer → sales-automator → customer-support
Flujos de trabajo avanzados con comandos Slash
Para una orquestación multi-subagente más sofisticada, utiliza el repositorio companion Commands:
# Complex feature development (8+ subagents)
/full-stack-feature Build user dashboard with real-time analyticsProduction incident response (5+ subagents)
/incident-response Database connection pool exhaustedML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testingSecurity-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architectureFormato de subagente
Cada subagente sigue esta estructura:
---
name: subagent-name
description: When this subagent should be invoked
model: haiku # Optional - specify which model to use (haiku/sonnet/opus)
tools: tool1, tool2 # Optional - defaults to all tools
System prompt defining the subagent's role and capabilities
Configuración del Modelo
A partir de Claude Code v1.0.64, los subagentes pueden especificar qué modelo de Claude deben usar. Esto permite una delegación de tareas rentable basada en la complejidad:
- Baja Complejidad (Haiku): Tareas simples como análisis básico de datos, generación de documentación y respuestas estándar
- Complejidad Media (Sonnet): Tareas de desarrollo, revisión de código, pruebas y trabajo estándar de ingeniería
- Alta Complejidad (Opus): Tareas críticas como auditoría de seguridad, revisión de arquitectura, respuesta a incidentes e ingeniería AI/ML
haiku- Rápido y rentable para tareas simplessonnet- Rendimiento equilibrado para la mayoría del trabajo de desarrolloopus- Más capaz para análisis complejos y tareas críticas
Patrones de Orquestación de Agentes
Claude Code coordina automáticamente a los agentes utilizando estos patrones comunes:
Flujos de Trabajo Secuenciales
User Request → Agent A → Agent B → Agent C → ResultExample: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor
Parallel Execution
User Request → Agent A + Agent B (simultaneously) → Merge ResultsExample: "Optimize application performance"
performance-engineer + database-optimizer → Combined recommendations
Ramificación Condicional
User Request → Analysis → Route to appropriate specialistExample: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter
Revisión y Validación
Primary Agent → Review Agent → Final ResultExample: "Implement payment processing"
payment-integration → security-auditor → Validated implementation
Cuándo Usar Cada Agente
🏗️ Planificación y Arquitectura
- backend-architect: Diseño de API, esquemas de bases de datos, arquitectura de sistemas
- frontend-developer: Planificación de UI/UX, arquitectura de componentes
- ui-ux-designer: Diseño de interfaces, wireframes, sistemas de diseño, investigación de usuarios
- cloud-architect: Diseño de infraestructura, planificación de escalabilidad
🔧 Implementación y Desarrollo
- python-pro: Tareas de desarrollo específicas en Python
- ruby-pro: Metaprogramación en Ruby, aplicaciones Rails, desarrollo de gemas, pruebas con RSpec/Minitest
- golang-pro: Tareas de desarrollo específicas en Go
- rust-pro: Desarrollo en Rust, seguridad de memoria, programación de sistemas
- c-pro: Programación en C, sistemas embebidos, código crítico en rendimiento
- javascript-pro: JavaScript moderno, patrones asíncronos, código Node.js/navegador
- typescript-pro: TypeScript avanzado, genéricos, inferencia de tipos, patrones empresariales
- java-pro: Desarrollo moderno en Java, streams, concurrencia, Spring Boot
- elixir-pro: Desarrollo en Elixir, patrones OTP, frameworks Phoenix, programación funcional
- csharp-pro: Desarrollo moderno en C#, frameworks .NET, patrones empresariales
- scala-pro: Scala empresarial con programación funcional, actores Apache Pekko/Akka, Apache Spark, ZIO/Cats Effect, arquitecturas reactivas
- flutter-expert: Desarrollo en Flutter, Dart, gestión de estado, animaciones, despliegue multiplataforma
- unity-developer: Desarrollo de juegos en Unity, scripting en C#, optimización de rendimiento
- minecraft-bukkit-pro: Desarrollo de plugins para Minecraft, sistemas de eventos, funcionalidades del lado del servidor
- ios-developer: Desarrollo nativo de iOS con Swift/SwiftUI
- sql-pro: Consultas de bases de datos, diseño de esquemas, optimización de consultas
- mobile-developer: Desarrollo en React Native/Flutter
🛠️ Operaciones y Mantenimiento
- devops-troubleshooter: Problemas en producción, inconvenientes de despliegue
- incident-responder: Caídas críticas que requieren respuesta inmediata
- database-optimizer: Rendimiento de consultas, estrategias de indexado
- database-admin: Estrategias de respaldo, replicación, gestión de usuarios, recuperación ante desastres
- terraform-specialist: Infraestructura como código, módulos de Terraform, gestión de estado
- network-engineer: Conectividad de red, balanceadores de carga, SSL/TLS, depuración de DNS
📊 Análisis y Optimización
- performance-engineer: Cuellos de botella en aplicaciones, optimización
- security-auditor: Escaneo de vulnerabilidades, controles de cumplimiento
- data-scientist: Análisis de datos, insights, reportes
- mlops-engineer: Infraestructura de ML, seguimiento de experimentos, registros de modelos, automatización de pipelines
🧪 Garantía de Calidad
- code-reviewer: Calidad de código, seguridad de configuración, fiabilidad en producción
- test-automator: Estrategia de pruebas, creación de suites de pruebas
- debugger: Investigación de errores, resolución de fallos
- error-detective: Análisis de registros, reconocimiento de patrones de error, análisis de causa raíz
- search-specialist: Investigación profunda en la web, análisis competitivo, verificación de hechos
📚 Documentación
- api-documenter: Especificaciones OpenAPI/Swagger, documentación de API
- docs-architect: Documentación técnica integral, guías de arquitectura, manuales de sistema
- reference-builder: Referencias exhaustivas de API, guías de configuración, documentación de parámetros
- tutorial-engineer: Tutoriales paso a paso, rutas de aprendizaje, contenido educativo
💼 Negocios y Estrategia
- business-analyst: KPIs, modelos de ingresos, proyecciones de crecimiento, métricas para inversores
- risk-manager: Riesgo de portafolio, estrategias de cobertura, múltiplos R, dimensionamiento de posiciones
- content-marketer: Contenido SEO, publicaciones en blogs, redes sociales, campañas de correo electrónico
- sales-automator: Correos en frío, seguimientos, propuestas, nutrición de leads
- customer-support: Tickets de soporte, preguntas frecuentes, documentación de ayuda, solución de problemas
- legal-advisor - Redacción de políticas de privacidad, términos de servicio, avisos legales y exenciones de responsabilidad
Mejores Prácticas
🎯 Delegación de Tareas
- Deja que Claude Code delegue automáticamente - El agente principal analiza el contexto y selecciona los agentes óptimos
- Sé específico sobre los requisitos - Incluye restricciones, stack tecnológico y requisitos de calidad
- Confía en la experiencia de los agentes - Cada agente está optimizado para su dominio
🔄 Flujos de Trabajo Multiagente
- Empieza con solicitudes de alto nivel - Deja que los agentes coordinen tareas complejas de varios pasos
- Proporciona contexto entre agentes - Asegúrate de que los agentes tengan la información de fondo necesaria
- Revisa los puntos de integración - Comprueba cómo funcionan juntos los resultados de los diferentes agentes
🎛️ Control Explícito
- Utiliza invocación explícita para necesidades concretas - Cuando desees la perspectiva de un experto específico
- Combina varios agentes estratégicamente - Diferentes especialistas pueden validar el trabajo de otros
- Solicita patrones de revisión específicos - "Pide que security-auditor revise el diseño de la API hecho por backend-architect"
📈 Optimización
- Monitorea la efectividad del agente - Descubre qué agentes funcionan mejor para tus casos de uso
- Itera en tareas complejas - Utiliza la retroalimentación del agente para refinar los requisitos
- Aprovecha las fortalezas del agente - Adapta la complejidad de la tarea a las capacidades del agente
Contribuir
Para agregar un nuevo subagente:
- Crea un nuevo archivo
.mdsiguiendo el formato anterior - Usa nombres en minúsculas, separados por guiones
- Escribe descripciones claras sobre cuándo debe usarse el subagente
- Incluye instrucciones específicas en el prompt del sistema
Solución de Problemas
Problemas Comunes
El agente no se invoca automáticamente:
- Asegúrate de que tu solicitud indique claramente el dominio (ej., "problema de rendimiento" → performance-engineer)
- Sé específico sobre el tipo de tarea (ej., "revisar código" → code-reviewer)
- Proporciona más contexto sobre tu stack tecnológico y requisitos
- Usa la invocación explícita si necesitas un agente específico
- Esto es normal; diferentes especialistas pueden tener prioridades diferentes
- Solicita aclaración: "Conciliar las recomendaciones de security-auditor y performance-engineer"
- Proporciona información de fondo en tu solicitud
- Haz referencia a conversaciones previas o patrones establecidos
Obtener Ayuda
Si los agentes no funcionan como se espera:
- Revisa las descripciones de los agentes en sus archivos individuales
- Prueba con un lenguaje más específico en tus solicitudes
- Usa la invocación explícita para probar agentes específicos
- Proporciona más contexto sobre tu proyecto y objetivos
Licencia
Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.