Dos personas trabajan con comunicación informal. Diez personas necesitan procesos. El reto es introducir proceso sin convertir todo en burocracia.
Documentación como escalabilidad del conocimiento
Con 2 personas, todo está en cabezas. Con 10, es desastre. Documentación permite que el conocimiento sea independiente de personas.
Eso significa: cómo se estructura el código, por qué se eligió ese tech stack, cómo se despliega, cómo se onboarded nuevo dev.
- README y setup local documentado.
- ADRs para decisiones importantes.
- Runbooks para procesos operacionales.
Code review: cuando código importa más que ego
Con dos personas, code review es informal. Con diez, necesitas proceso. El objetivo no es rechazar código, es compartir conocimiento y evitar bugs.
El criterio de una buena review: aprendes algo, autor entiende feedback, ambos se sienten respetados.
- Reviews enfocadas en lógica, no estilo.
- Linting automático elimina discusión de formato.
- El que revisa ve el código, el autor lo executa.
Decisiones documentadas: evita reuniones repetidas
Cuando una decisión arquitectónica está documentada como ADR, no vuelves a debatir lo mismo en 6 meses. Nuevo dev lee el ADR y entiende contexto.
Sin eso, cada reunión de onboarding es la misma conversación.
- ADR para cada decisión importante.
- Archivado y fácil de buscar.
- Permite aprender de decisiones pasadas.
Autonomía clara: quién decide qué
Con más gente, conflictos surgen. El antídoto es claridad: quién toma decisiones de deploy, quién cambia API, quién define roadmap.
No tiene que ser jerárquico. Puede ser: equipo de frontend toma decisiones de frontend, pero decisiones compartidas se discuten juntos.
La mejor estructura de equipo es donde cada uno sabe en qué área puede tomar decisiones sin pedir permiso.
Onboarding: nuevo dev productivo en días
Si onboarding toma semanas, pierdes productividad y el nuevo dev se siente perdido. Un onboarding bien hecho toma días: setup local, ejecuta app, hace primer PR pequeña.
Eso requiere documentación, runbooks y mentoring, pero el inverso se paga rápido.