gonzalezpazmonica/executive-reporting

Skill: executive-reporting

Generación de informes ejecutivos multi-proyecto para dirección: PowerPoint y Word con formato corporativo.

Prerequisito: Leer .claude/skills/azure-devops-queries/SKILL.md y .claude/skills/sprint-management/SKILL.md

Constantes de esta skill

OUTPUT_DIR="./output/executive"
CORPORATE_COLOR_PRIMARY="#0078D4"     # Azul corporativo
CORPORATE_COLOR_SECONDARY="#F3F3F3"   # Gris claro
CORPORATE_FONT="Calibri"              # Fuente corporativa

# Umbrales de semáforo
VELOCITY_GREEN_THRESHOLD=0.90         # ≥ 90% → verde
VELOCITY_YELLOW_THRESHOLD=0.70        # 70-89% → amarillo; < 70% → rojo
BLOCKED_ITEMS_RED_THRESHOLD=2         # ≥ 2 bloqueos → rojo

---

Flujo 1 — Recopilar Datos Multi-Proyecto

Para cada proyecto activo:

1. Leer configuración del proyecto
2. Obtener sprint actual (az boards iteration)
3. Obtener work items con WIQL (azure-devops-queries)
4. Guardar en /tmp/{proyecto}-items.json

---

Flujo 2 — Calcular Semáforo de Estado

Detalle: @references/traffic-light-logic.md

Entradas: SP completados, SP planificados, días restantes, velocity media, bloqueos activos

Lógica:

• 🔴 Rojo: bloqueos ≥ 2 O ratio_velocity < 0.70
• 🟡 Amarillo: bloqueos ≥ 1 O ratio_velocity < 0.90 O riesgo_tiempo > 0.6
• 🟢 Verde: en buen camino

---

Flujo 3 — Generar PowerPoint Ejecutivo

node scripts/report-generator.js \
  --type executive --format pptx \
  --proyectos "proyecto-alpha,proyecto-beta" \
  --output "$OUTPUT_DIR/$(date +%Y%m%d)-executive-report.pptx"

Detalle: @references/pptx-structure.md

Diapositivas: Portada | Resumen | Por proyecto | KPIs | Hitos | Decisiones | Próximos pasos

---

Flujo 4 — Generar Word Ejecutivo

node scripts/report-generator.js \
  --type executive --format docx \
  --proyectos "proyecto-alpha,proyecto-beta" \
  --output "$OUTPUT_DIR/$(date +%Y%m%d)-executive-report.docx"

Estructura: Resumen | Por proyecto | Consolidadas | Plan próxima semana

---

Flujo 5 — Enviar por Email (Graph API)

TOKEN=$(obtener_graph_token)
ATTACHMENT=$(base64 < "$OUTPUT_DIR/$FILENAME")
curl -s -X POST "https://graph.microsoft.com/v1.0/users/$REMITENTE_EMAIL/sendMail" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"message\": {...}}"

⚠️ Confirmar destinatarios con el usuario antes de enviar.

---

Plantilla Visual

Detalle: @references/visual-template.md

• Portada: Azul corporativo (#0078D4), blanco, logo
• Diapositivas: Blanco, barra superior azul
• Semáforos: Verde (#00B050) / Amarillo (#FFC000) / Rojo (#FF0000)
• Tablas: Cabecera azul oscuro, filas alternas

---

Referencias

• references/traffic-light-logic.md — Lógica semáforos
• references/pptx-structure.md — Estructura PowerPoint
• references/visual-template.md — Esquema colores
• Sprint management: ../sprint-management/SKILL.md
• Comando: /report-executive