YepClerk

Equipos de ingeniería

Que cualquier ingeniero encuentre el runbook sin esperar a que alguien conteste

Las interrupciones de guardia repiten la misma pregunta de siempre. La respuesta está en un ADR que nadie encuentra a las tres de la mañana.

YepClerk
Telegram interno
Se ha caído el servicio de pagos, qué hago
Según el runbook de pagos: reinicia el worker de cobros desde el panel de admin, y si en 5 minutos sigue caído, escala a la guardia. El ADR-014 explica por qué el reintento automático está desactivado para ese servicio.
Puedo hacer yo solo un rollback a producción sin avisar a nadie?
Un rollback de producción fuera del runbook estándar lo decide la guardia, no yo. Aviso a la persona de guardia y te escribe en cuanto pueda.
El runbook respondiendo, y el criterio a una persona.

Treinta interrupciones de guardia al mes, casi todas ya documentadas

Un equipo de ingeniería de 20 personas recibe, solo en la guardia, más de treinta preguntas al mes que ya tienen respuesta escrita: qué dice el runbook de tal servicio, por qué se tomó tal decisión de arquitectura, cómo se pide acceso a tal sistema.

Están en los ADRs, en el wiki de incidentes, en la guía de onboarding. Nadie los busca a medianoche — se le pregunta directamente a la guardia, porque es más rápido que encontrar el documento correcto.

Lo que empieza siendo una pregunta rápida acaba siendo una guardia interrumpida y una persona sacada de lo suyo para repetir algo que ya estaba escrito.

Conocimiento privado, no publicado

Igual que con cualquier documentación interna: esta información no es pública y no debe serlo.

Los runbooks, los ADRs y la documentación de APIs internas se cargan como conocimiento privado del asistente. Se despliega como widget en la intranet o como bot de Telegram al que solo accede el equipo de ingeniería. No hay widget abierto en la web pública ni número de WhatsApp expuesto.

Y responde solo con lo que está cargado: si un runbook no cubre el caso, no improvisa — avisa a la guardia.

Lo que no debe contestar un bot

Un rollback sin runbook, una decisión de arquitectura nueva, un acceso a producción que se sale del procedimiento estándar, un incidente que escala más allá de lo documentado. Nada de eso se resuelve citando un documento.

El asistente lo detecta, avisa a la guardia o al tech lead correspondiente y deja de responder en esa conversación: quien la atienda escribe desde el panel. Si la pregunta llegó por Telegram, la respuesta llega por el mismo Telegram; si llegó desde el widget de la intranet, llega por email, porque ese canal no admite mensajes salientes.

Un asistente por equipo, si hace falta

Si tenéis documentación separada por squad o por sistema, podéis tener un asistente por área. El de plataforma no contesta con los runbooks del equipo de pagos.

Lo que cambia

La guardia deja de repetir lo que ya está escrito, y cada ingeniero obtiene la respuesta correcta al momento — de día o a las tres de la madrugada — sin depender de que alguien esté despierto para contestar.

Lo que te preguntan cada día

Estas son las consultas que se repiten en este sector. Todas se responden con tu propia información.

¿Cuál es el runbook si falla el servicio de pagos?
¿Por qué decidimos usar Postgres y no Mongo? ¿Dónde está esa decisión documentada?
¿Cómo pido acceso a la base de datos de producción?
¿Qué hago el primer día que me toca guardia?
¿Dónde está la documentación de la API interna de facturación?
¿Cuál es el proceso para desplegar un hotfix fuera de horario?

Qué carga tu bot

Se sube tal cual lo tengas — un PDF, una página de tu web, un documento. No hay que reescribir nada.

Tu conocimiento ya existe. Falta ponerlo a conversar.

Pruébalo 7 días gratis y cancela cuando quieras. Cárgalo hoy y esta noche ya está respondiendo, agendando citas y pasándote solo lo que necesita a una persona.