Onboarding de Desarrolladores
Proceso estructurado para que nuevos desarrolladores se vuelvan productivos rápidamente, desde setup del entorno hasta comprensión de la arquitectura y procesos del equipo.
seed#onboarding#dx#documentation#productivity#team
¿Qué es?
El onboarding de desarrolladores es el proceso de llevar a un nuevo miembro del equipo desde «acabo de llegar» hasta «soy productivo». Un buen onboarding reduce este tiempo de semanas a días.
Componentes
- Setup del entorno: dev containers, scripts de setup
- Documentación: AGENTS.md, README, architecture decision records
- Primer PR: tarea pequeña para familiarizarse con el flujo
- Buddy system: un compañero asignado para preguntas
- Checklist: lista verificable de pasos completados
Métricas
| Métrica | Objetivo | Cómo medir |
|---|---|---|
| Tiempo hasta primer commit | < 1 día | Fecha de inicio → primer commit |
| Tiempo hasta primer PR mergeado | < 1 semana | Fecha de inicio → primer merge |
| Tiempo hasta primer deploy a producción | < 2 semanas | Fecha de inicio → primer deploy |
| Satisfacción del nuevo desarrollador | > 4/5 | Survey a los 30 días |
Automatización
pnpm install && pnpm devdebe funcionar en menos de 5 minutos- Dev containers eliminan «funciona en mi máquina»
- AGENTS.md como guía para humanos y agentes de IA
Anti-patrones
- «Pregúntale a Juan» — todo el conocimiento en una persona, no en documentación
- Setup de 3 días — si el onboarding tarda más de medio día, el entorno necesita automatización
- Documentación de onboarding desactualizada — peor que no tener, porque genera frustración y desconfianza
¿Por qué importa?
El tiempo de onboarding es una métrica directa de la salud de la plataforma de desarrollo. Si un nuevo ingeniero tarda semanas en ser productivo, el problema no es el ingeniero — es la falta de documentación, golden paths y entornos reproducibles.
Referencias
- The Manager's Path — Camille Fournier. Incluye secciones sobre onboarding efectivo.
- An Elegant Puzzle — Will Larson, 2019. Sistemas de gestión de ingeniería incluyendo onboarding.
- DX: Developer Experience — Addy Osmani, 2024. Libro sobre experiencia de desarrollador incluyendo onboarding.