Guía para elegir el rol adecuado

Una guía de selección y sistema de ayuda cuando no estás seguro de qué rol usar.

Uso

bash
/role-help                      # Guía general de selección de roles
/role-help <situación/problema>  # Roles recomendados para situaciones específicas
/role-help compare <Rol 1>,<Rol 2> # Comparar roles

Ejemplos Básicos

bash
# Orientación general
/role-help
→ Lista de roles disponibles y sus características

# Recomendación específica de situación
/role-help "Preocupado por la seguridad de API"
→ Recomendación y uso del rol security

# Comparación de roles
/role-help compare frontend,mobile
→ Diferencias y uso apropiado entre roles frontend y mobile

Guía de Selección de Roles Basada en Situaciones

🔒 Relacionado con Seguridad

text
Usar rol security para:
✅ Implementación de funciones de login/autenticación
✅ Verificaciones de vulnerabilidades de seguridad para APIs
✅ Cifrado de datos y protección de privacidad
✅ Verificación de cumplimiento de seguridad
✅ Pruebas de penetración

Uso: /role security

🏗️ Arquitectura y Diseño

text
Usar rol architect para:
✅ Evaluación de diseño general del sistema
✅ Decisiones microservicios vs monolito
✅ Diseño de base de datos y selección de tecnología
✅ Consideraciones de escalabilidad y extensibilidad
✅ Evaluación de deuda técnica y planificación de mejoras

Uso: /role architect

⚡ Problemas de Rendimiento

text
Usar rol performance para:
✅ Aplicaciones lentas
✅ Optimización de consultas de base de datos
✅ Mejora de velocidad de carga de páginas web
✅ Optimización de uso de memoria y CPU
✅ Escalado y contramedidas de carga

Uso: /role performance

🔍 Investigación de Causa Raíz de Problemas

text
Usar rol analyzer para:
✅ Análisis de causa raíz de bugs y errores
✅ Investigación de fallas del sistema
✅ Análisis estructural de problemas complejos
✅ Análisis de datos e investigación estadística
✅ Entender por qué ocurren problemas

Uso: /role analyzer

🎨 Frontend y UI/UX

text
Usar rol frontend para:
✅ Mejoras de interfaz de usuario
✅ Cumplimiento de accesibilidad
✅ Diseño responsivo
✅ Mejora de usabilidad y facilidad de uso
✅ Tecnologías generales de frontend web

Uso: /role frontend

📱 Desarrollo de Aplicaciones Móviles

text
Usar rol mobile para:
✅ Optimización de aplicaciones iOS y Android
✅ Diseño UX específico para móviles
✅ Optimización de interfaz táctil
✅ Funciones de soporte offline y sincronización
✅ Cumplimiento de App Store y Google Play

Uso: /role mobile

👀 Revisión de Código y Calidad

text
Usar rol reviewer para:
✅ Verificaciones de calidad de código
✅ Evaluación de legibilidad y mantenibilidad
✅ Verificación de convenciones de codificación
✅ Propuestas de refactoring
✅ Revisiones de PR y commits

Uso: /role reviewer

🧪 Pruebas y Aseguramiento de Calidad

text
Usar rol qa para:
✅ Planificación de estrategia de pruebas
✅ Evaluación de cobertura de pruebas
✅ Directrices de implementación de pruebas automatizadas
✅ Medidas de prevención de bugs y mejora de calidad
✅ Automatización de pruebas en CI/CD

Uso: /role qa

Cuando se Necesitan Múltiples Roles

🔄 multi-role (Análisis Paralelo)

text
Usar multi-role para:
✅ Evaluación desde múltiples perspectivas profesionales
✅ Crear planes de mejora integrados
✅ Comparar evaluaciones de diferentes campos
✅ Organizar contradicciones y superposiciones

Ejemplo: /multi-role security,performance

🗣️ role-debate (Discusión)

text
Usar role-debate para:
✅ Trade-offs entre campos especializados
✅ Opiniones divididas sobre selección de tecnología
✅ Tomar decisiones de diseño a través de discusión
✅ Escuchar debates desde diferentes perspectivas

Ejemplo: /role-debate security,performance

🤖 smart-review (Propuesta Automática)

text
Usar smart-review para:
✅ Incertidumbre sobre qué rol usar
✅ Querer conocer el enfoque óptimo para la situación actual
✅ Elegir entre múltiples opciones
✅ Indecisión de principiante

Ejemplo: /smart-review

Tabla de Comparación de Roles

Categoría Seguridad

| Rol | Uso Principal | Fortalezas | Debilidades | | -------- | ------------------------------------------ | --------------------------------------------- | ----------------------------------------- | | security | Vulnerabilidades y contramedidas de ataque | Análisis de amenazas, diseño de autenticación | UX, rendimiento | | analyzer | Análisis de causa raíz | Análisis lógico, recolección de evidencia | Medidas preventivas, planificación futura |

Categoría Diseño

| Rol | Uso Principal | Fortalezas | Debilidades | | --------- | ----------------- | ----------------------------------------------- | -------------------------------------------------- | | architect | Diseño de sistema | Perspectiva a largo plazo, optimización general | Implementación detallada, soluciones a corto plazo | | reviewer | Calidad de código | Nivel de implementación, mantenibilidad | Requerimientos de negocio, UX |

Categoría Rendimiento

| Rol | Uso Principal | Fortalezas | Debilidades | | ----------- | ---------------------------------- | ---------------------------------------------- | -------------------- | | performance | Mejora de velocidad y optimización | Medición, identificación de cuellos de botella | Seguridad, UX | | qa | Aseguramiento de calidad | Pruebas, automatización | Diseño, arquitectura |

Categoría Experiencia de Usuario

| Rol | Uso Principal | Fortalezas | Debilidades | | -------- | ------------- | ------------------------ | ------------------ | | frontend | UI/UX Web | Navegador, accesibilidad | Lado servidor, BD | | mobile | UX Móvil | Táctil, soporte offline | Lado servidor, Web |

Diagrama de Flujo de Decisión Cuando No Estés Seguro

text
¿Cuál es la naturaleza del problema?
├─ Relacionado con seguridad → security
├─ Problemas de rendimiento → performance
├─ Investigación de bug/falla → analyzer
├─ Mejora de UI/UX → frontend o mobile
├─ Diseño/arquitectura → architect
├─ Calidad de código → reviewer
├─ Relacionado con pruebas → qa
└─ Complejo/compuesto → smart-review para propuesta

¿Abarca múltiples campos?
├─ Quiero análisis integrado → multi-role
├─ Discusión/trade-offs → role-debate
└─ No estoy seguro → smart-review

Preguntas Frecuentes

P: ¿Cuál es la diferencia entre los roles frontend y mobile?

text
R:
frontend: Enfocado en navegador web, HTML/CSS/JavaScript
mobile: Enfocado en aplicaciones móviles, iOS/Android nativo, React Native, etc.

Para problemas relacionados con ambos, se recomienda multi-role frontend,mobile

P: ¿Cómo elegir entre los roles security y analyzer?

text
R:
security: Prevención de ataques y amenazas, diseño de seguridad
analyzer: Análisis de causas de problemas existentes, investigación

Para investigaciones de incidentes de seguridad, usar multi-role security,analyzer

P: ¿Cuál es la diferencia entre los roles architect y performance?

text
R:
architect: Diseño a largo plazo de sistemas completos, escalabilidad
performance: Mejoras específicas de velocidad y eficiencia

Para diseño de rendimiento de sistemas a gran escala, usar multi-role architect,performance

Colaboración con Claude

bash
# Combinado con descripción de situación
/role-help
"La aplicación React carga páginas lentamente, recibiendo quejas de usuarios"

# Combinado con contenido de archivo
cat problem-description.md
/role-help
"Recomendar el rol más adecuado para este problema"

# Cuando no estés seguro entre opciones específicas
/role-help compare security,performance
"¿Qué rol es apropiado para problemas de expiración de token JWT?"

Notas

• Para problemas complejos, combinar múltiples roles es más efectivo
• Para asuntos urgentes, usar un solo rol para respuesta rápida
• Cuando no estés seguro, se recomienda usar smart-review para propuestas automáticas
• La decisión final debe ser tomada por el usuario considerando la naturaleza del problema