## Ayuda de Roles 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 # Roles recomendados para situaciones específicas /role-help compare , # 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