Epics

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

La herramienta epic proporciona 3 acciones para gestionar epics — la unidad organizacional de más alto nivel en la jerarquía de tu proyecto. Los epics agrupan historias de usuario y funcionalidades relacionadas en iniciativas estratégicas, dando a tu equipo una visión clara de los objetivos a gran escala. A través del MCP Server, tu asistente de IA puede crear epics, actualizar sus detalles y listar todos los epics dentro de un proyecto.

Los epics en GitScrum representan cuerpos de trabajo significativos que abarcan múltiples sprints y contienen múltiples historias de usuario. Responden a la pregunta "¿hacia qué iniciativa importante estamos trabajando?" mientras que las historias de usuario y las tareas manejan el "cómo" y el "qué específicamente". El MCP Server hace posible construir y gestionar toda esta jerarquía — epics → historias de usuario → tareas — a través de conversación en lenguaje natural.

Resumen de acciones

Listar epics

La acción list devuelve todos los epics dentro de un proyecto específico. Cada epic en la respuesta incluye su uuid, título, descripción, color y metadatos asociados. Esto le da a tu asistente de IA una visión completa de las iniciativas estratégicas del proyecto.

Usa esta acción para revisar el roadmap del proyecto, identificar qué epics tienen más actividad o verificar cómo se distribuye el trabajo entre los objetivos estratégicos.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Lista todos los epics del proyecto Backend"
IA:   Llama a epic action=list → devuelve todos los epics con títulos, descripciones y colores

Tú:   "¿Cuáles son nuestras iniciativas estratégicas actuales?"
IA:   Llama a epic action=list → resume los epics del proyecto como objetivos de alto nivel

Tú:   "Muéstrame el roadmap del proyecto"
IA:   Llama a epic action=list → presenta los epics como hitos estratégicos

Crear epics

La acción create construye un nuevo epic en una sola llamada. Los epics son intencionalmente ligeros — necesitan un título y opcionalmente pueden incluir una descripción y un color para identificación visual en el tablero. La simplicidad refleja su rol como contenedores estratégicos en lugar de elementos de trabajo a nivel de tarea.

Parámetros requeridos

Parámetros opcionales

Guía de colores

Los epics aparecen como etiquetas con código de color en toda la interfaz de GitScrum — en el tablero Kanban, en vistas de sprint y en reportes. Elegir colores distintos para cada epic ayuda a tu equipo a identificar visualmente a qué iniciativa estratégica pertenece una tarea de un vistazo.

Convenciones de color comunes:

Ejemplos de prompts

Tú:   "Crea un epic 'Release Q1' con color azul"
IA:   Llama a epic action=create con title="Release Q1", color="3B82F6"

Tú:   "Crea un epic llamado 'Renovación de Autenticación' con una descripción cubriendo
       los objetivos de migración a OAuth2, SSO y RBAC"
IA:   Llama a epic action=create con title, description conteniendo los detalles del alcance

Tú:   "Agrega un nuevo epic para el rediseño de la app móvil, usa color naranja"
IA:   Llama a epic action=create con title="Rediseño Mobile App", color="F59E0B"

Tú:   "Crea tres epics para Q1: Rendimiento de API, Dashboard de Usuario e
       Integración de Pagos. Usa colores diferentes para cada uno."
IA:   Llama a epic action=create tres veces con títulos y colores distintos

Actualizar epics

La acción update modifica cualquier campo de un epic existente. Solo los campos que especifiques se cambian — todos los demás campos permanecen sin modificar. Esto es útil para refinar descripciones de epics a medida que el alcance evoluciona, cambiar colores para reorganización visual o renombrar epics para reflejar mejor su dirección actual.

Parámetros requeridos

Parámetros opcionales

Todos los parámetros opcionales de create están disponibles en update: title, description, color.

Ejemplos de prompts

Tú:   "Actualiza la descripción del epic Release Q1 para incluir el nuevo alcance de migración de API"
IA:   Encuentra el epic via list → llama a epic action=update con descripción ampliada

Tú:   "Cambia el color del epic Renovación de Autenticación a rojo"
IA:   Llama a epic action=update con color="EF4444"

Tú:   "Renombra el epic 'Mobile App v2' a 'Rediseño de Mobile App'"
IA:   Llama a epic action=update con title="Rediseño de Mobile App"

Tú:   "Actualiza todos los epics para incluir fechas estimadas de completado en sus descripciones"
IA:   Lista epics → actualiza cada uno con descripciones revisadas

Flujo de trabajo de planificación estratégica

Los epics son más efectivos cuando se usan como la cima de una jerarquía de planificación deliberada. Este flujo de trabajo demuestra cómo construir una estructura de proyecto completa desde iniciativas estratégicas hasta tareas accionables.

1. Definir epics estratégicos

Comienza estableciendo las iniciativas principales para el trimestre o ciclo de release.

Tú:   "Estamos planificando Q1. Crea epics para: Rendimiento de API (verde),
       Dashboard de Usuario (azul) e Integración de Pagos (púrpura)"
IA:   Crea tres epics con títulos descriptivos y colores distintos

2. Agregar alcance y criterios de éxito

Refina cada epic con descripciones detalladas que clarifiquen cómo se ve "terminado".

Tú:   "Actualiza el epic de Rendimiento de API con esta descripción: 'Reducir la latencia p95
       a menos de 200ms. Migrar a connection pooling. Agregar capa de caché.'"
IA:   Llama a epic action=update con la descripción detallada

3. Desglosar epics en historias de usuario

Crea historias de usuario bajo cada epic para definir requisitos específicos.

Tú:   "Crea historias de usuario para el epic de Integración de Pagos:
       - Como usuario, quiero pagar con tarjeta de crédito
       - Como usuario, quiero ver mi historial de pagos
       - Como administrador, quiero emitir reembolsos"
IA:   Crea tres historias de usuario vinculadas al proyecto

4. Convertir historias en tareas

Desglosa cada historia de usuario en tareas implementables para el tablero Kanban.

Tú:   "Desglosa la historia de pago con tarjeta de crédito en tareas de desarrollo"
IA:   Crea tareas para: integración con Stripe, UI del formulario de pago, validación,
      manejo de errores y generación de recibos

5. Revisar progreso de los epics

Verifica cómo avanza el trabajo en tus iniciativas estratégicas.

Tú:   "Muéstrame el estado de todos los epics del proyecto"
IA:   Lista epics → para cada uno, filtra tareas para calcular métricas de completado

Epics y visibilidad del proyecto

Los epics proporcionan una capa de comunicación poderosa entre los equipos de desarrollo y los stakeholders. Cuando un gerente de proyecto o cliente pregunta "¿en qué estamos trabajando este trimestre?", la lista de epics proporciona la respuesta al nivel correcto de abstracción — lo suficientemente estratégico para revisiones ejecutivas, lo suficientemente estructurado para planificación de sprints.

A través del MCP Server, puedes generar resúmenes a nivel de epic bajo demanda:

Tú:   "Dame una actualización de estado de alto nivel para todos los epics"
IA:   Lista epics → filtra tareas por epic → resume el progreso para cada iniciativa

Tú:   "¿Qué epic tiene más trabajo incompleto?"
IA:   Lista epics → analiza completado de tareas → identifica el epic con más tareas restantes

Auto-resolución de contexto

La herramienta epic soporta resolución automática de contexto. Si el asistente de IA ya conoce tu workspace y proyecto de una llamada previa en la conversación, lleva ese contexto hacia adelante. Esto significa que puedes decir "Crea un epic" sin especificar el proyecto cada vez, siempre que el asistente de IA haya establecido el contexto del proyecto antes en la conversación.

Próximos pasos

• Historias de Usuario: Define requisitos dentro de los epics como historias de usuario estructuradas.
• Tareas: Crea las tareas de implementación que concretan tus epics.
• Sprints: Planifica sprints alrededor del trabajo priorizado por epics.
• Etiquetas: Categoriza tareas entre epics con etiquetas para filtrado.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.