github-issue-generator

name	github-issue-generator
description	Genera issues y PRs estructurados para GitHub (Epics, Modules, Tasks, PRs). Trigger: Cuando el usuario quiere crear un Epic con módulos, tasks y sus PRs.
license	Apache-2.0
metadata	{"author":"gentleman-programming","version":"1.4"}

When to Use

• Usuario quiere crear un Epic (issue madre) con múltiples módulos
• Necesita generar Modules (sub-issues) derivados del Epic
• Quiere crear Tasks individuales con detalle completo
• Necesita generar Pull Requests con el formato del proyecto
• Cuando dice: "crear Epic", "generar PR", "crear task", "cerrar ciclo"

Critical Patterns

Ciclo Completo de un Feature

Epic (Issue Madre)
  └── Module (Sub-Issue - un módulo por funcionalidad)
        └── Task (Issue individual - una por cada feature pequeña)
              └── PR (Pull Request con "Closes #ID")

Reglas de Generación

1. Epic → Modules: Cada módulo se convierte en una sub-issue
2. Module → Tasks: Cada task es un issue independiente
3. Task → PR: Cada task completada genera un PR que cierra su issue
4. Se referencian: "Closes #X" conecta PR con Issue

Formato de Rama

Epic: feat/clinic-nc-project-flows
  ├── Module: feat/clinic-nc-project-flows/auth
  │     └── Task: task/auth/login
  │           └── PR: task/auth/login → Closes #X

Input Requerido

Para generar un Epic:

Campo	Requerido	Ejemplo
Título	Sí	"Clínica NC - Desarrollo de flujos"
Rama base	Sí	"feat/clinic-nc-project-flows"
Rama destino	Sí	"dev"
Módulos	Sí	Lista: Auth, Citas, Perfil...

Para generar un Module:

Campo	Requerido	Ejemplo
Título	Sí	"Autenticación"
Epic ID	Sí	#1
Rama	Sí	"feat/clinic-nc-project-flows/auth"
Tasks	Sí	Lista: login, register...

Para generar una Task:

Campo	Requerido	Ejemplo
Título	Sí	"task/auth/login"
Rama	Sí	"task/clinic-nc-project-flows/auth/login"
Rama base	Sí	"feat/clinic-nc-project-flows/auth"

Para generar un PR:

Campo	Requerido	Ejemplo
Título	Sí	"task/auth/login: Login con email/password"
Task ID	Sí	#5
Rama	Sí	"task/clinic-nc-project-flows/auth/login"
Rama destino	Sí	"feat/clinic-nc-project-flows/auth"
Descripción	Sí	Qué cambios incluye
Validación	Sí	Cómo probar
Checklist	Sí	Items de validación

Código de Ejemplo

Generación de PR

INPUT:
- Título: task/auth/login - Login de usuarios
- Task ID: #5
- Rama: task/clinic-nc-project-flows/auth/login
- Rama destino: feat/clinic-nc-project-flows/auth
- Descripción: Crear flujo de login con email/password y validación
- Cambios: Pantalla login, handler MSW, interfaz TypeScript, Zustand store
- Validación: npm run dev, probar credenciales correctas e incorrectas

OUTPUT:
# task/auth/login: Login de usuarios

## 📌 Issue Relacionado
- Closes #5

## 📌 Descripción del PR

Crear flujo de login con email/password y validación...

## ✅ Cambios incluidos

- Pantalla de login en /src/app/(auth)/login/page.tsx
- Handler MSW en /src/mocks/handlers/auth/login.ts
- Interfaz TypeScript en /src/core/auth/interfaces/
- Zustand store para autenticación

## 🧪 ¿Cómo probar?

1. npm run dev
2. Ir a /login
3. Probar credenciales correctas → redirige al dashboard
4. Probar credenciales incorrectas → muestra error

## 🧩 Checklist de validación

- [x] Login funcional
- [x] Manejo de errores
- [x] Validación de inputs
- [x] Integración con MSW

## 🔀 Estrategia de merge

- Rama: task/clinic-nc-project-flows/auth/login
- Destino: feat/clinic-nc-project-flows/auth

---

Asignado: @davidcoachdev

Commands

No hay comandos especiales — el skill se activa cuando el usuario describe lo que necesita.

Resources

• Templates: Ver assets/ para:
  • template-epic.md - Issue madre con módulos
  • template-module.md - Sub-issue (módulo con tasks)
  • template-task.md - Task individual
  • template-pr.md - PR de task individual
  • template-pr-module.md - PR de módulo (integra tasks del módulo)
  • template-pr-final.md - PR final que cierra el Epic
• Ejemplos: Los ejemplos en la conversación del usuario son la referencia definitiva