Documentaciónde SCRUMY

Todo lo que necesitas saber para comenzar a usar SCRUMY y aprovechar al máximo sus capacidades.

Guías de Inicio Rápido

Comienza a usar SCRUMY en minutos

🚀

Primeros Pasos

Configura tu cuenta y conecta con Jira en menos de 5 minutos.

Leer guía →

🤖

Comandos de IA

Aprende a comunicarte efectivamente con tu agente Scrum.

Ver comandos →

🔧

Configuración Avanzada

Personaliza SCRUMY para tu flujo de trabajo específico.

Configurar →

Documentación Completa

Explora todas las funcionalidades de SCRUMY

🔗 Integraciones

Configuración de Jira
Integración con Confluence (Próximamente)
Notificaciones en Slack (Próximamente)
Webhooks personalizados (Próximamente)

¿Cómo configuro un proyecto?

Guía completa para configurar tu proyecto en SCRUMY

📋Datos Necesarios

Para configurar un proyecto en SCRUMY, necesitas los siguientes datos de tu instancia de Jira:

•URL de Jira: La dirección base de tu instancia de Jira (ej: https://tu-empresa.atlassian.net)
•Email de Jira: Tu dirección de correo electrónico asociada a tu cuenta de Jira
•Token de API: Un token de autenticación generado desde tu cuenta de Jira. Ver cómo obtenerlo →
•Clave del Proyecto: El identificador único de tu proyecto en Jira (ej: SCRUM, PROJ, DEV)
•Nombre y Descripción: Información descriptiva del proyecto para identificación

🔐¿Cómo obtengo el Token de API de Jira?

Sigue estos pasos para generar tu token de API:

Inicia sesión en tu cuenta de Atlassian (la misma que usas para Jira)
Ve a Account Settings (Configuración de cuenta) haciendo clic en tu avatar en la esquina superior derecha
En el menú lateral, selecciona Security (Seguridad)
Desplázate hasta la sección API tokens
Haz clic en "Create API token" (Crear token de API)
Dale un nombre descriptivo (ej: "SCRUMY - Proyecto X")
Haz clic en "Create" y copia el token inmediatamente (solo se muestra una vez)
Pega el token en el campo correspondiente al configurar tu proyecto en SCRUMY

⚠️ Importante: Guarda el token de forma segura. Si lo pierdes, deberás generar uno nuevo. El token es confidencial y no debe compartirse.

🔍¿Qué representa cada dato?

URL de Jira

Es la dirección base donde está alojada tu instancia de Jira. SCRUMY la utiliza para realizar todas las llamadas a la API de Jira y gestionar tus proyectos, issues, épicas y transiciones.

Email de Jira

Identifica tu cuenta de usuario en Jira. Debe ser el mismo email que utilizas para iniciar sesión en tu instancia de Jira.

Token de API

Es una credencial de seguridad que permite a SCRUMY autenticarse en Jira sin usar tu contraseña. Se genera desde la configuración de seguridad de tu cuenta de Atlassian y debe mantenerse confidencial.

Clave del Proyecto

Es el identificador único de tu proyecto en Jira (también conocido como "Project Key"). Aparece como prefijo en todos los issues del proyecto (ej: SCRUM-10, PROJ-25). Esta clave permite a SCRUMY identificar y trabajar con el proyecto correcto en Jira.

⚠️Limitación: Jira en VPN Corporativa

Si tu instancia de Jira está alojada en una VPN corporativa o red privada:

•Acceso restringido: SCRUMY necesita acceso directo a la URL de Jira. Si está detrás de una VPN, el servidor de SCRUMY no podrá conectarse a menos que también tenga acceso a esa VPN.
•Solución temporal: Actualmente, SCRUMY solo puede conectarse a instancias de Jira accesibles públicamente o a través de la red donde está desplegado el servidor.
•Recomendación: Si tu Jira está en una VPN corporativa, considera usar Jira Cloud (atlassian.net) o configurar un túnel/proxy que permita el acceso desde SCRUMY.

🔑¿Qué es la Clave del Proyecto?

La clave del proyecto (Project Key) es un identificador único y corto que Jira asigna a cada proyecto. Es fundamental para que SCRUMY funcione correctamente porque:

•Se usa como prefijo en todos los issues del proyecto (ej: si tu clave es "SCRUM", tus issues serán SCRUM-1, SCRUM-2, etc.)
•Permite a SCRUMY identificar y filtrar issues específicos de tu proyecto
•Es necesaria para crear nuevos issues, épicas y realizar búsquedas en Jira
•Puedes encontrarla en la configuración de tu proyecto en Jira o en la URL de cualquier issue del proyecto

👥¿Por qué es importante definir la asignación?

La configuración de asignación de usuarios es crucial para el funcionamiento eficiente de SCRUMY:

•Asignación automática: Cuando creas issues o stories, SCRUMY puede asignarlos automáticamente a usuarios específicos si defines un asignado por defecto
•Validación de usuarios: Al sincronizar usuarios desde Jira, SCRUMY obtiene la lista de usuarios válidos del proyecto, evitando errores al asignar issues a usuarios inexistentes
•Sin asignación por defecto: Si no defines un asignado por defecto, los issues se crearán sin asignar, lo que puede requerir asignación manual posterior
•Recomendación: Sincroniza los usuarios de tu proyecto y define un asignado por defecto para agilizar la creación de issues

📊¿Por qué sincronizar épicas y qué son?

¿Qué son las épicas?

Las épicas son contenedores de alto nivel en Jira que agrupan múltiples user stories o tareas relacionadas. Representan grandes iniciativas o funcionalidades que requieren múltiples sprints para completarse.

Ejemplo: Una épica "Sistema de Pagos" puede contener stories como "Procesar tarjeta de crédito", "Validar pago", "Generar recibo", etc.

¿Por qué sincronizarlas?

•Vincular stories automáticamente: Al crear una user story, SCRUMY puede vincularla automáticamente a una épica si defines una épica por defecto
•Organización del trabajo: Las épicas ayudan a organizar y agrupar el trabajo relacionado, facilitando la planificación y el seguimiento
•Contexto para la IA: SCRUMY puede usar las épicas disponibles para sugerir o validar la asignación de nuevas stories
•Recomendación: Sincroniza las épicas después de crear el proyecto y define una épica por defecto para nuevas stories

🔄¿Por qué sincronizar transiciones y qué son?

¿Qué son las transiciones?

Las transiciones son los cambios de estado que puede tener un issue en Jira. Cada proyecto tiene un flujo de trabajo (workflow) que define qué transiciones son posibles entre estados.

Ejemplos comunes: "To Do" → "In Progress" → "Done", o "Backlog" → "Sprint" → "In Progress" → "Testing" → "Done"

¿Por qué sincronizarlas?

•Cambiar estados automáticamente: SCRUMY puede mover issues entre estados usando los nombres correctos de las transiciones de tu proyecto
•Evitar errores: Cada proyecto puede tener transiciones personalizadas. Sincronizar asegura que SCRUMY use los nombres exactos de tus transiciones
•Automatización del flujo: Al crear issues, puedes especificar un estado inicial y SCRUMY aplicará la transición correcta
•Recomendación: Sincroniza las transiciones después de crear el proyecto para habilitar la gestión automática de estados

¿Cómo puedo incorporar datos de mis repositorios?

Integra tus repositorios de código con SCRUMY para un contexto completo

🔓Repositorios Públicos (Limitación Actual)

Importante: Actualmente, SCRUMY solo puede indexar y trabajar con repositorios públicos de GitHub.

•Repositorios públicos: Solo puedes agregar repositorios que sean accesibles públicamente en GitHub (sin autenticación requerida)
•Repositorios privados: Actualmente no están soportados. Si intentas agregar un repositorio privado, la indexación fallará
•Futuro: El soporte para repositorios privados está planificado para futuras versiones, lo que requerirá autenticación con tokens de GitHub

🔄Actualización Constante Requerida

Los repositorios de código cambian constantemente. Para que SCRUMY tenga el contexto más actualizado, es importante:

•Re-indexar periódicamente: Cuando agregas nuevas funcionalidades, archivos o cambios significativos al código, debes re-indexar el repositorio en SCRUMY
•Indexación inicial: Al agregar un repositorio, SCRUMY lo indexa automáticamente, creando un mapa de todos los archivos, su estructura y contenido relevante
•Frecuencia recomendada: Re-indexa después de cambios importantes en la arquitectura, nuevas funcionalidades principales, o al menos una vez por sprint
•Proceso de actualización: Puedes actualizar el índice de un repositorio desde la configuración del proyecto, lo que volverá a analizar el código y actualizará la información disponible para SCRUMY

🚀¿Cómo ayuda en el flujo de trabajo de SCRUMY?

Incorporar repositorios de código en SCRUMY proporciona contexto valioso que mejora significativamente las capacidades del asistente:

•Contexto técnico: SCRUMY puede entender la estructura de tu código, tecnologías utilizadas, y patrones de implementación, lo que le permite crear user stories más precisas y técnicas
•Estimaciones más precisas: Al conocer el código existente, SCRUMY puede hacer estimaciones de story points más informadas basadas en la complejidad real del código
•Referencias a código: Al crear issues o stories, SCRUMY puede referenciar archivos específicos, funciones, o componentes relacionados en el código
•Detección de dependencias: SCRUMY puede identificar dependencias entre tareas basándose en la estructura del código y las relaciones entre componentes
•Análisis de impacto: Al proponer cambios, SCRUMY puede analizar qué partes del código se verían afectadas
•Búsqueda inteligente: Puedes preguntar a SCRUMY sobre archivos específicos, funciones, o patrones en tu código, y te ayudará a encontrarlos y entenderlos
•Mejora continua: Con el contexto del código, SCRUMY puede sugerir mejoras, identificar código duplicado, o proponer refactorizaciones

💡 Tip: Mientras más repositorios agregues y más actualizados estén, mejor será el contexto que SCRUMY tendrá para ayudarte en la gestión de tu proyecto.

Ejemplos de Comandos

Aprende a comunicarte con tu agente Scrum

# Crear un Epic

"Crea un epic llamado 'Sistema de Pagos'

para el proyecto SCRUM con descripción

'Implementar pasarela de pagos'

y etiquetas 'payments, priority'"

# Crear User Story

"Crea una story 'Como usuario quiero

pagar con tarjeta de crédito'

bajo el epic SCRUM-10,

asigna 5 story points

y ponla en el sprint 7"

# Generar Reporte

"Dame el resumen del sprint 7

con métricas de progreso

y tareas pendientes"

# Actualizar Estado

"Mueve la tarea SCRUM-15

a 'In Progress' y

asígnala a juan@empresa.com"

Recursos Adicionales

Herramientas y recursos para maximizar tu experiencia

📹

Videos Tutoriales

Aprende con videos paso a paso

Ver videos →

💬

Comunidad

Conecta con otros usuarios

Unirse →

📋

Plantillas

Plantillas listas para usar

Descargar →

🎓

Certificación

Certifícate como experto

Comenzar →

¿Necesitas ayuda adicional?

Nuestro equipo de soporte está aquí para ayudarte. Contacta con nosotros o explora nuestra base de conocimientos.

Centro de Soporte Contactar Soporte