Reemplazar un README de 2,400 líneas con doce guías.
Un staff engineer en una plataforma B2B de observabilidad grabó el setup del entorno de desarrollo una sola vez. El tiempo al primer PR de los nuevos ingresos cayó de tres semanas a una.
01
El doc de inducción del ingeniero era un README de 2,400 líneas. Era exhaustivo y poco confiable. Algunas secciones referenciaban un sistema de build que ya había sido reemplazado. Otras suponían una versión de SO que ningún laptop de la empresa seguía corriendo. La frase "esto debería funcionar solo" aparecía diecisiete veces.
Cada ingeniero nuevo chocaba con las mismas fallas: extensión faltante de Postgres, la versión equivocada de Node, el certificado SSL que había que regenerar, las cuatro variables de entorno que nadie había documentado. Cada falla se volvía un DM de Slack a un ingeniero senior. Para el segundo mes de una ola de contratación, los seniors ocupaban media semana en inducción.
La solución que todos proponían era "reescribir el README". Tres ingenieros lo habían intentado el año previo. Cada reescritura aguantaba dos semanas y luego envejecía. El README se pudría porque nadie era dueño. El costo se repartía entre cada ingeniero senior que respondía los mismos DMs.
02
El setup se grabó desde cero en un laptop limpio, con Capture corriendo. Cada paso y cada falla quedó narrado. El entregable fue una guía de veintitrés pasos con capturas del setup actual real.
La guía reemplazó al README. Los nuevos ingresos la abrían en su día uno y avanzaban con ella. Los seis modos de falla conocidos tuvieron sus propias guías cortas de troubleshooting, enlazadas desde la principal.
Cuando un paso cambia (una herramienta sube de versión, una variable de entorno nueva), solo ese paso se vuelve a grabar. Dos minutos de trabajo, no una reescritura del README. Los DMs a ingenieros senior por inducción bajaron de seis por nuevo ingreso en su semana uno a alrededor de uno. Ese uno suele ser una pregunta que merece respuesta.
03
- 01Hacer el setup en vivo.
Laptop limpio, Capture corriendo. Narra cada paso, incluidas las fallas.
- 02Tratar las fallas como ciudadanas de primera.
Cada modo de falla conocido recibe su propia guía corta de troubleshooting.
- 03Enlazado desde un solo lugar.
El wiki de ingeniería tiene una sola entrada: "Empieza aquí".
- 04Mantener paso a paso.
Vuelve a grabar el paso afectado cuando una herramienta cambia. No la guía completa.
- 05Medir tiempo al primer PR.
El éxito de la inducción se mide por el tiempo al primer PR shippeado.
04
El tiempo al primer PR cayó de tres semanas a una. Los ingenieros senior recuperaron su semana uno. El volumen de DMs por inducción bajó cerca de 80%.
El patrón se extendió. El runbook de la guardia recibió el mismo tratamiento. El proceso de revisión de PR quedó grabado. El flujo de despliegue quedó grabado. El wiki de ingeniería ahora son doce guías, no 2,400 líneas de README casi siempre obsoleto.
Graba un flujo de trabajo.
Extensión de Chrome gratuita. No requiere registro.
Customer Success retiró el Zoom de inducción.
Llamadas de 45 minutos se volvieron guías de 12 minutos. El territorio creció 80% sin sumar gente.
Operaciones reconstruyó la biblioteca de SOPs antes de la auditoría.
Veintiún procesos, grabados por sus dueños. SOC 2 cerró dos semanas antes.
TI bajó los tickets de Tier 1 en un tercio.
Veinte preguntas repetidas, veinte guías, ocho semanas. Los lunes recuperaron sus tardes.