Plantilla de Guía de Onboarding

Resumen

Una guía de onboarding acelera la productividad de nuevos miembros del equipo al proveer un camino claro desde el día uno hasta la primera contribución significativa. Reduce la carga sobre miembros existentes y asegura consistencia.

Cuándo Usar

• Un nuevo desarrollador se une al equipo
• Quieres reducir preguntas repetitivas de “cómo hago…”
• Necesitas documentar conocimiento tribal
• Tu equipo está creciendo rápidamente

Plantilla

# Guía de Onboarding

¡Bienvenido al equipo! Esta guía te ayudará a ponerte en marcha.

## Día 1: Cuentas y Accesos

- [ ] Cuenta de email y Slack/Teams creada
- [ ] Acceso a repositorio Git otorgado
- [ ] Acceso a plataforma CI/CD configurado
- [ ] Credenciales de ambiente de desarrollo recibidas
- [ ] Invitaciones de calendario enviadas para standups y rituales del equipo

## Día 1-2: Configuración del Entorno

### Herramientas Requeridas
| Herramienta | Versión | Propósito | Link de Instalación |
|-------------|---------|-----------|---------------------|
| Node.js | 20.x | Runtime | [nodejs.org](https://nodejs.org) |
| Docker | Última | Contenedores | [docker.com](https://docker.com) |
| Git | 2.40+ | Control de versiones | [git-scm.com](https://git-scm.com) |

### Setup del Repositorio
```bash
git clone git@github.com:org/repo.git
cd repo
npm install
npm run dev

Verificación: http://localhost:4321 debería mostrar la aplicación.

Día 2-3: Visión General del Código

Arquitectura

[Diagrama de alto nivel o descripción de componentes del sistema]

Directorios Clave

Directorio	Propósito
/src/components	Componentes UI reutilizables
/src/pages	Definiciones de rutas
/src/lib	Utilidades y schemas compartidos
/tests	Suites de tests

Convenciones

• Nomenclatura de branches: feature/descripcion, bugfix/descripcion
• Mensajes de commit: Conventional Commits
• Estilo de código: Aplicado por ESLint y Prettier

Día 3-5: Primeras Contribuciones

Good First Issues

Busca issues con labels:

• good first issue
• help wanted
• documentation

Primeras Tareas

Día	Tarea	Objetivo
3	Corregir un typo o actualizar docs	Aprender el flujo de PR
4	Escribir un test unitario	Entender estándares de testing
5	Elegir un bug pequeño	Flujo completo de contribución

Semana 2+: Profundización

• Asistir a sesión de overview de arquitectura
• Leer ADRs en /docs/adr/
• Observar una rotación de on-call (solo observación)
• Pair programming con un compañero

Recursos

• Wiki del Equipo
• Documentación de API
• Runbooks
• Architecture Decision Records

¿Preguntas?

Tu compañero de onboarding es: [Nombre] Slack: @username | Email: name@company.com

## Secciones Clave

| Sección | Propósito |
|---------|-----------|
| **Cuentas y Accesos** | Eliminar bloqueos el día uno |
| **Configuración del Entorno** | Ambiente de desarrollo estandarizado |
| **Visión General del Código** | Contexto arquitectónico |
| **Primeras Contribuciones** | Camino claro al primer PR |
| **Recursos** | Dónde encontrar más info |

## Buenas Prácticas

- **Hazlo accionable**: Cada item debe ser un checkbox o comando
- **Asigna un buddy**: Los nuevos necesitan un punto de contacto humano
- **Manténlo actualizado**: Revisa y actualiza trimestralmente
- **Empieza simple**: El día 1 no debe ser abrumador

## Errores Comunes

- **Instrucciones desactualizadas**: Links rotos o procesos cambiados
- **Credenciales faltantes**: Solicitudes de acceso que toman días
- **Sin sistema de buddy**: Nuevo aislado sin ayuda