Creando Guías de Onboarding para Nuevos Miembros del Equipo

Comenzar un nuevo trabajo es abrumador. Los nuevos miembros del equipo enfrentan codebases desconocidos, procesos desconocidos y caras sin nombre. Las guías de onboarding estructuradas reducen la ansiedad, aceleran la productividad y mejoran la retención al dar a los nuevos contratados un camino claro hacia el éxito.

Objetivos del Onboarding

Estructura del Onboarding

Los Primeros 90 Días

JORNADA DE ONBOARDING 90 DÍAS
═════════════════════════════

SEMANA 1: ORIENTACIÓN
├── Día 1: Admin, acceso, setup
├── Día 2-3: Walkthrough del codebase
├── Día 4-5: Primera contribución
└── Checkpoint: 1:1 con Manager

SEMANA 2-4: APRENDIZAJE
├── Procesos del equipo deep-dive
├── Tomar tareas reales (pequeñas)
├── Hacer shadow a miembros del equipo
├── Aprender contexto de dominio
└── Checkpoint: Feedback del Buddy

MES 2: CONTRIBUYENDO
├── Trabajo independiente
├── Unirse a rotación on-call (shadow)
├── Participar en reviews
├── Asistir a todos los rituales del equipo
└── Checkpoint: 1:1 con Manager

MES 3: INTEGRÁNDOSE
├── Liderar features pequeños
├── Mentorizar a miembros nuevos
├── Contribuir a mejoras
├── Tomar turnos on-call
└── Checkpoint: Onboarding completo

Guía de Semana 1

Plan Día por Día

GUÍA DETALLADA SEMANA 1
═══════════════════════

DÍA 1: FUNDACIÓN
─────────────────────────────────────
□ Completar onboarding HR
□ Obtener laptop, credenciales
□ Acceso otorgado:
  ├── Email, Slack, Calendario
  ├── GitHub, GitScrum
  ├── VPN, Consolas Cloud
  └── Wiki de documentación
□ Conocer a tu buddy
□ Publicar intro en #team-channel
□ Configurar entorno de desarrollo
□ Verificar: Puede clonar y construir

DÍA 2: ORIENTACIÓN
─────────────────────────────────────
□ 1:1 con manager (30 min)
  ├── Contexto del equipo
  ├── Expectativas
  └── Preguntas
□ Walkthrough del codebase con buddy
  ├── Overview de arquitectura
  ├── Directorios clave
  └── Cómo se conectan las cosas
□ Leer documentación del equipo
□ Continuar setup del entorno

DÍA 3: EXPLORACIÓN
─────────────────────────────────────
□ Standup del equipo (observar)
□ Deep-dive: Un componente del sistema
□ Configurar entorno de debugging
□ Encontrar y arreglar un typo (¡primer PR!)
□ Revisar: Definition of Done

DÍA 4: CONTRIBUYENDO
─────────────────────────────────────
□ Elegir primera tarea (etiquetada "good-first-issue")
□ Entender requerimientos
□ Comenzar implementación
□ Hacer preguntas temprano
□ Hacer shadow de un code review

DÍA 5: DESPACHANDO
─────────────────────────────────────
□ Completar primera tarea
□ Enviar PR
□ Pasar por proceso de review
□ ¡Mergear primera contribución! 🎉
□ Checkpoint Semana 1 con buddy

Tarea de Onboarding en GitScrum

TAREA DE ONBOARDING GITSCRUM
════════════════════════════

TAREA: [ONBOARD] @nuevo-contratado Semana 1

DESCRIPCIÓN:
¡Bienvenido! Esta tarea rastrea tu primera semana.
Marca los ítems cuando los completes.
Pregunta a @buddy si te atascas.

CHECKLIST:

## Día 1 - Setup
- [ ] Completar papeles de HR
- [ ] Recibir laptop y credenciales
- [ ] Unirse a canales Slack (#team, #engineering, #random)
- [ ] Clonar repositorios
- [ ] Completar setup local
- [ ] Verificar que build funciona

## Día 2 - Orientación  
- [ ] 1:1 con manager
- [ ] Tour del codebase con buddy
- [ ] Leer handbook del equipo
- [ ] Conocer miembros del equipo

## Día 3 - Aprendizaje
- [ ] Asistir a standup
- [ ] Leer docs de arquitectura
- [ ] Configurar IDE
- [ ] Encontrar un arreglo simple

## Día 4-5 - Contribuyendo
- [ ] Elegir primera tarea
- [ ] Enviar primer PR
- [ ] Completar review
- [ ] ¡Merge! 🎉

## Semana 1 Completa
- [ ] Checkpoint con buddy
- [ ] Actualizar este doc con mejoras

ASIGNADO: @nuevo-contratado
BUDDY: @buddy
FECHA LÍMITE: Viernes de Semana 1

Sistema de Buddy

Responsabilidades del Buddy

GUÍA DEL BUDDY DE ONBOARDING
═════════════════════════════

TU ROL:
├── Guiar, no enseñar
├── Responder preguntas
├── Conectar con personas correctas
├── Dar feedback
└── Estar disponible

ANTES DE QUE EMPIECEN:
□ Revisar docs de onboarding
□ Bloquear tiempo para Día 1
□ Preparar mensaje de bienvenida
□ Identificar primeras tareas

SEMANA 1:
□ Día 1: Bienvenida, ayuda con setup (2-3 horas)
□ Día 2: Tour del codebase (1-2 horas)
□ Diario: Check-in (15 min)
□ Día 5: Checkpoint Semana 1 (30 min)

CONTINUO:
□ 1:1 semanal (30 min)
□ Disponible para preguntas
□ Abogar por sus necesidades
□ Celebrar victorias

HANDOFF (después del Mes 1):
□ Reducir check-ins formales
□ Transición a relación de pares
□ Permanecer disponible
□ Recopilar feedback sobre onboarding

Templates de Check-in

PREGUNTAS DE CHECK-IN
═════════════════════

CHECK-IN SEMANA 1:
├── ¿Cómo te sientes?
├── ¿Qué ha sido confuso?
├── ¿Qué necesitas?
├── ¿Algún problema de acceso?
└── ¿Preguntas sobre algo?

CHECK-IN MES 1:
├── ¿Qué está yendo bien?
├── ¿Qué es desafiante?
├── ¿Obteniendo suficiente contexto?
├── ¿Dinámica del equipo OK?
├── ¿Algún bloqueador?
└── ¿Qué ayudaría?

CHECK-IN MES 3:
├── ¿Te sientes productivo?
├── ¿Entendiendo el dominio?
├── ¿Parte del equipo?
├── ¿Alineación de metas de carrera?
├── ¿Mejoras de proceso para sugerir?
└── ¿Listo para ayudar a onboardear otros?

Recursos de Aprendizaje

Ruta de Aprendizaje Curada

ESTRUCTURA DE RUTA DE APRENDIZAJE
═════════════════════════════════

FASE 1: FUNDACIONES (Semana 1-2)
├── Entorno de desarrollo
├── Workflow de Git
├── Guía de estilo de código
├── Proceso de PR
└── Básicos de testing

FASE 2: SISTEMAS (Semana 2-4)
├── Overview de arquitectura
├── Interacciones de servicios
├── Schema de base de datos
├── Patrones de API
└── Estructura frontend

FASE 3: DOMINIO (Mes 1-2)
├── Contexto de negocio
├── Personas de usuario
├── Roadmap de producto
├── Landscape competitivo
└── Métricas de éxito

FASE 4: OPERACIONES (Mes 2-3)
├── Proceso de deployment
├── Monitoreo y alertas
├── Respuesta a incidentes
├── Procedimientos on-call
└── Escalación de soporte

Biblioteca de Recursos

RECURSOS DE ONBOARDING
══════════════════════

DOCUMENTACIÓN:
├── Handbook del equipo: [link]
├── Docs de arquitectura: [link]
├── Documentación de API: [link]
├── Runbook: [link]
└── Glosario: [link]

VIDEOS:
├── Demo del producto: [link]
├── Walkthrough de arquitectura: [link]
├── Proceso de deploy: [link]
└── Reviews de incidentes pasados: [link]

PERSONAS PARA CONOCER:
├── Product Manager: @pm
├── Diseñador: @designer
├── DevOps: @devops
├── Lead de Soporte: @support
└── Otros equipos: Programar coffee chats

EXTERNO:
├── Contexto de la industria: [artículos]
├── Deep-dives de tecnología: [cursos]
└── Mejores prácticas: [libros]

Rastreando Progreso

Dashboard de Onboarding

DASHBOARD DE ONBOARDING
═══════════════════════

NUEVOS CONTRATADOS ACTUALES:
┌─────────────────────────────────────────────────────────┐
│  Nombre     │ Fecha Inicio│ Semana│ Progreso │ Buddy   │
├─────────────────────────────────────────────────────────┤
│  @alex      │ Mar 11      │   2   │ ███░░ 40%│ @sarah  │
│  @jamie     │ Mar 4       │   3   │ ████░ 60%│ @mike   │
│  @taylor    │ Feb 18      │   5   │ █████ 85%│ @lisa   │
└─────────────────────────────────────────────────────────┘

Mejores Prácticas

Para Guías de Onboarding

1. Comenzar con Day 1 — Tener todo listo antes de que lleguen
2. Asignar buddy — Soporte dedicado
3. Checkpoints claros — Verificar progreso regularmente
4. Primeras victorias — PR temprano construye confianza
5. Documentación actualizada — Mantener guías frescas

Anti-Patrones

ERRORES DE ONBOARDING:
✗ Sin documentación de setup
✗ Sin buddy asignado
✗ Sink or swim (nadar o hundirse)
✗ Demasiada información de golpe
✗ Sin checkpoints
✗ Guías desactualizadas
✗ Sin primeras tareas claras
✗ Aislamiento de nuevos contratados

Soluciones Relacionadas

• Onboarding ágil para nuevos miembros del equipo
• Creando documentación de onboarding integral
• Creando onboarding efectivo para nuevos desarrolladores