5 min lectura • Guide 407 of 877
Mejores Prácticas de Handoff de Proyectos
Los handoffs de proyectos son transiciones riesgosas. Buenos handoffs transfieren conocimiento completamente y mantienen momentum. Malos handoffs pierden contexto, crean gaps, y frustran a todos. Esta guía cubre prácticas efectivas de handoff.
Elementos del Handoff
| Elemento | Propósito |
|---|---|
| Documentación | Conocimiento escrito |
| Sesiones pair | Conocimiento tácito |
| Período shadow | Aprendizaje hands-on |
| Ventana de soporte | Red de seguridad |
Planificación del Handoff
TIMELINE DE HANDOFF
═══════════════════
SEMANA -2 (PREPARACIÓN):
┌─────────────────────────────────────────────────────────────┐
│ │
│ Equipo actual: │
│ ├── Auditar documentación existente │
│ ├── Identificar gaps de documentación │
│ ├── Listar conocimiento tribal │
│ ├── Preparar materiales de onboarding │
│ └── Definir checklist de handoff │
│ │
└─────────────────────────────────────────────────────────────┘
SEMANA 1-2 (TRANSFERENCIA):
┌─────────────────────────────────────────────────────────────┐
│ │
│ Sesiones de conocimiento: │
│ ├── Día 1-2: Overview de arquitectura │
│ ├── Día 3-4: Codebase walkthrough │
│ ├── Día 5-6: Deployment & operations │
│ ├── Día 7-8: Issues comunes & troubleshooting │
│ └── Día 9-10: Q&A y clarificaciones │
│ │
└─────────────────────────────────────────────────────────────┘
SEMANA 3-4 (SHADOW & TRANSICIÓN):
┌─────────────────────────────────────────────────────────────┐
│ │
│ Nuevo equipo: │
│ ├── Shadow en tareas reales │
│ ├── Hacer tareas con supervisión │
│ ├── Gradualmente tomar ownership │
│ └── Equipo anterior disponible para preguntas │
│ │
└─────────────────────────────────────────────────────────────┘
POST-HANDOFF (2-4 semanas):
┌─────────────────────────────────────────────────────────────┐
│ │
│ Soporte: │
│ ├── Canal de Slack para preguntas │
│ ├── Office hours semanales │
│ ├── Escalation para issues críticos │
│ └── Gradual phase-out del soporte │
│ │
└─────────────────────────────────────────────────────────────┘
Documentación Requerida
CHECKLIST DE DOCUMENTACIÓN
══════════════════════════
ARQUITECTURA:
┌─────────────────────────────────────────────────────────────┐
│ ☐ Diagrama de alto nivel │
│ ☐ Componentes y sus responsabilidades │
│ ☐ Flujos de datos │
│ ☐ Integraciones externas │
│ ☐ Decisiones de arquitectura (ADRs) │
└─────────────────────────────────────────────────────────────┘
CODEBASE:
┌─────────────────────────────────────────────────────────────┐
│ ☐ Estructura de directorios │
│ ☐ Convenciones de código │
│ ☐ Patrones usados │
│ ☐ Áreas complejas explicadas │
│ ☐ Deuda técnica conocida │
└─────────────────────────────────────────────────────────────┘
OPERACIONES:
┌─────────────────────────────────────────────────────────────┐
│ ☐ Setup de ambiente local │
│ ☐ Proceso de deployment │
│ ☐ Monitoreo y alertas │
│ ☐ Runbooks para incidentes │
│ ☐ Accesos necesarios │
└─────────────────────────────────────────────────────────────┘
CONOCIMIENTO TRIBAL:
┌─────────────────────────────────────────────────────────────┐
│ ☐ "Por qué" detrás de decisiones │
│ ☐ Workarounds conocidos │
│ ☐ Gotchas y trampas │
│ ☐ Contactos importantes │
│ ☐ Historial de incidentes │
└─────────────────────────────────────────────────────────────┘
Sesiones de Transferencia
ESTRUCTURA DE SESIONES
══════════════════════
SESIÓN DE ARQUITECTURA (2-3 horas):
┌─────────────────────────────────────────────────────────────┐
│ │
│ Agenda: │
│ ├── Historia del proyecto (15 min) │
│ ├── Diagrama de arquitectura (30 min) │
│ ├── Componentes principales (45 min) │
│ ├── Decisiones clave y por qué (30 min) │
│ └── Q&A (30 min) │
│ │
│ Output: Grabación, slides, diagrama actualizado │
│ │
└─────────────────────────────────────────────────────────────┘
SESIÓN DE CODEBASE (3-4 horas):
┌─────────────────────────────────────────────────────────────┐
│ │
│ Agenda: │
│ ├── Walkthrough de estructura (30 min) │
│ ├── Flujo de una request típica (45 min) │
│ ├── Áreas complejas en detalle (60 min) │
│ ├── Testing strategy (30 min) │
│ └── Hands-on: Fix un bug simple (60 min) │
│ │
│ Output: Grabación, notas en código, PR de práctica │
│ │
└─────────────────────────────────────────────────────────────┘
SESIÓN DE OPERACIONES (2 horas):
┌─────────────────────────────────────────────────────────────┐
│ │
│ Agenda: │
│ ├── Pipeline de CI/CD (30 min) │
│ ├── Proceso de deployment live (30 min) │
│ ├── Monitoreo y dashboards (20 min) │
│ ├── Incident response (20 min) │
│ └── Hands-on: Deploy a staging (20 min) │
│ │
│ Output: Accesos otorgados, runbooks revisados │
│ │
└─────────────────────────────────────────────────────────────┘
En GitScrum
TRACKING DE HANDOFF EN GITSCRUM
═══════════════════════════════
PROYECTO DE HANDOFF:
┌─────────────────────────────────────────────────────────────┐
│ │
│ Proyecto: Handoff Project Alpha → Team Beta │
│ │
│ Milestones: │
│ ├── M1: Documentación completa │
│ ├── M2: Sesiones de transferencia │
│ ├── M3: Shadow period │
│ └── M4: Ownership transferido │
│ │
└─────────────────────────────────────────────────────────────┘
TAREAS TÍPICAS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ ☐ Crear diagrama de arquitectura │
│ ☐ Documentar proceso de deployment │
│ ☐ Sesión: Architecture overview (scheduled) │
│ ☐ Sesión: Codebase walkthrough (scheduled) │
│ ☐ Otorgar accesos a nuevo equipo │
│ ☐ Shadow: New team miembro en on-call │
│ ☐ First PR by new team (reviewed by old) │
│ ☐ First deploy by new team │
│ │
└─────────────────────────────────────────────────────────────┘
LABELS:
┌─────────────────────────────────────────────────────────────┐
│ 📚 docs-needed │ Necesita documentación │
│ 🎓 training │ Sesión de entrenamiento │
│ 👥 shadow │ Actividad de shadow │
│ ✅ handoff-ready │ Listo para transferir │
└─────────────────────────────────────────────────────────────┘