Mejores Prácticas de Equipo y Onboarding
Un resumen condensado de las 25 prácticas de equipo y onboarding más importantes para equipos de backend de Node.js - contenido portátil compartido; adáptalo a tu dominio.
//
Busca en todas las páginas de la documentación
Un resumen condensado de las 25 prácticas de equipo y onboarding más importantes para equipos de backend de Node.js - contenido portátil compartido; adáptalo a tu dominio.
Configuración de la máquina antes de los tickets: Node 24.18.0, npm ci, docker compose up, curl /health en verde el primer día - Conceptos Básicos de Onboarding.
Fija LTS explícitamente en CONTRIBUTING.md: .nvmrc, engines, Docker FROM node:24.18.0 - los nuevos empleados no actualizan Node en la primera semana.
CONTRIBUTING.md es canónico: Ruta de clonación, plantilla de entorno, reglas de rama, comandos de prueba - no pines dispersos de Slack.
Mismos scripts localmente y en CI: typecheck, lint, test - una superficie de comandos - Integración con GitHub Actions.
El proyecto final de la primera semana es obligatorio: Un segmento E2E - ruta, migración, prueba, PR fusionado - Ruta de Frontend → Node.
Recorrido por el event loop temprano: Explica el bloqueo vs. asincronía antes de las opiniones del framework - Cómo Funciona Node.js.
Asignación de compañero el primer día: Compañero asignado para el recorrido por el código y los dos primeros PRs - no "pregunta a cualquiera".
Lista de verificación de código por niveles: Nivel 1 el primer día (entrada de la aplicación, rutas, entorno), Nivel 2 antes del proyecto final (workers, migraciones).
Rastrea un segmento de solicitud juntos: HTTP → manejador → DB → respuesta - la pizarra es mejor que leer cada archivo.
Postgres/Redis local vía Docker Compose: Paridad con la topología de producción - Conceptos Básicos de Onboarding.
.env.example comprometido: Secretos de producción solo en la inyección de la plataforma.
curl de prueba en cada primer PR: Enseña los logs + el pensamiento HTTP a los nuevos empleados de frontend.
Evidencia de PR para cambios de API: Ejemplo de curl o diff de OpenAPI - "funciona en mi máquina" es insuficiente.
Rota el conductor cada 25 minutos en el emparejamiento: Emparejamiento en PRs de API.
Emparejamiento en autenticación, pagos, primera transacción: Involucramiento requerido de nivel medio+ - factor bus y cumplimiento.
Matriz de niveles sobre antigüedad: Junior vs. medio definido por competencias - Matriz de Habilidades.
Una competencia por plan de crecimiento de sprint: Cierre de brechas enfocado - no "aprender backend".
Pequeño PR fusionado para el segundo día: Corrección de documentación o adición de prueba - alfabetización de CI antes del alcance del proyecto final.
Registra la confusión de la primera semana como PRs de documentación: Los mapas de ruta del README mejoran la experiencia del próximo empleado - el onboarding es un producto.
Emparejamiento en el primer worker de BullMQ: Los workers no son "solo otro archivo" - disciplina de proceso separada.
Posponer las actualizaciones de LTS y framework la primera semana: Modo de lectura y envío; los cambios de plataforma necesitan emparejamiento del personal.
Sombra en guardia antes de la rotación en solitario: Observador en un incidente con Habilidad de Triaje de Incidentes.
Emparejamiento de lanzamiento para la primera sombra de despliegue en producción: Comando de rollback tipeado una vez con el mentor observando.
Retro de la primera semana escrito para el líder: Tres puntos - documento más claro, módulo más confuso, corrección de documento propuesta.
Frontend senior / Node junior es explícito: Doble vía en la matriz de habilidades previene expectativas incorrectas de guardia.
Capacidad de sprint completa para la tercera semana. La primera semana está orientada al aprendizaje - proyecto final, no avalancha de backlog.
Documenta el entorno de desarrollo en la nube o el host remoto de Docker. Un estado de salud verde en un entorno de staging compartido es aceptable si CONTRIBUTING.md lo indica.
Misma máquina y lista de verificación del proyecto final; ajusta la matriz de habilidades a la duración del contrato. La alfabetización de CI sigue siendo necesaria.
Tickets de producción antes de un estado de salud verde y una introducción al event loop - produce una lucha silenciosa y PRs con muchos reversiones.
Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS Activo), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.
Revisado por Chris St. John·Última actualización: 16 jul 2026