gonzalezpazmonica/team-onboarding

Skill: Team Onboarding & Expertise Evaluation

Cuándo usar esta skill

Invocar cuando se incorpora un nuevo programador a un proyecto del workspace:

• El miembro es nuevo en el equipo o en el proyecto
• Se necesita acelerar su ramp-up (de 4-8 semanas a 5-10 días)
• Se quiere registrar su perfil de competencias para el algoritmo de asignación

Qué produce

Tres outputs que cubren el ciclo completo de incorporación:

1. Nota informativa RGPD — documento de transparencia para el trabajador (obligatorio antes de recoger datos)
2. Guía de onboarding personalizada — contexto, tour del codebase, checklist día a día
3. Perfil de competencias — evaluación que alimenta el campo expertise en equipo.md

Flujo completo

Nuevo miembro se incorpora al proyecto
    ↓
/team-privacy-notice {nombre}     ← PM genera nota informativa RGPD
    ↓                                (trabajador lee, firma, se archiva)
/team-onboarding {nombre}         ← Fases 1-2: contexto + tour del código
    ↓                                (mentor valida cada fase)
  [Fase 3: primera task asistida]  ← Mentor asigna task B/C, pair programming con Claude
    ↓                                (Code Review humano obligatorio)
/team-evaluate {nombre}            ← Fase 4: cuestionario interactivo de competencias
    ↓                                (autoevaluación + calibración Tech Lead)
  [Fase 5: autonomía progresiva]   ← Semanas 1-3 con supervisión decreciente

Fases 3 y 5 no son comandos — son procesos humanos guiados por el mentor.

Cuándo NO usar

• El miembro ya lleva >2 semanas productivo en el proyecto (ya está onboarded)
• Cambio de proyecto de un miembro existente (usar solo /team-evaluate para actualizar dominio)
• Becarios o personal de soporte que no escriben código (el cuestionario es para programadores)
• Si no se ha entregado la nota informativa RGPD — /team-evaluate verificará esto

Almacenamiento

Los documentos se guardan en el directorio del proyecto:

projects/{proyecto}/privacy/
├── {nombre}-nota-informativa-{fecha}.md     ← Nota RGPD firmada

projects/{proyecto}/onboarding/
├── {nombre}-guia.md                         ← Guía personalizada

projects/{proyecto}/evaluaciones/
├── {nombre}-competencias-{fecha}.yaml       ← Respuestas raw del cuestionario

El perfil final se integra directamente en projects/{proyecto}/equipo.md.

Privacidad: Los directorios privacy/, onboarding/ y evaluaciones/ están en .gitignore. Nunca se suben al repositorio público.

Plantillas

Las plantillas están en references/:

• references/onboarding-checklist.md — checklist día a día para mentor y nuevo miembro
• references/questionnaire-template.md — cuestionario completo (A: .NET, B: transversal, C: dominio)
• references/expertise-mapping.md — algoritmo de conversión respuestas → campo expertise en equipo.md
• references/privacy-notice-template.md — plantilla de nota informativa Art. 13-14 RGPD

Agente responsable

• PM/Scrum Master — orquesta el proceso completo y genera la nota informativa
• Mentor humano — valida fases 1-3, aprueba checkpoints
• business-analyst — ejecuta la calibración de competencias (Fase 4) vía /team-evaluate
• Tech Lead — co-firma la evaluación final de competencias

Métricas de éxito

| Métrica | Objetivo | Cómo se mide | |---------|----------|--------------| | Time-to-First-PR | ≤ 3 días | Timestamp del primer PR aprobado | | Calidad del primer PR | ≤ 3 rondas de review | Comentarios de code review | | Confianza autoreportada | ≥ 7/10 | Encuesta al día 5 y día 15 | | Independencia al día 10 | Puede tomar tasks sin spec | Validación del mentor | | Retención a 90 días | 100% | Seguimiento HR |

Conformidad legal

Este skill procesa datos personales (competencias laborales). Ver references/privacy-notice-template.md para el marco legal completo. Resumen:

• Base legal: Interés legítimo del empleador (Art. 6.1.f RGPD), NO consentimiento
• Minimización: Solo competencias (1-5), interés (S/N), fecha. Sin métricas de productividad individual
• Derechos: Acceso, Rectificación, Supresión, Oposición, Portabilidad (Arts. 15-21 RGPD)
• Nota informativa obligatoria antes de recoger cualquier dato