YepClerk

Productividad para equipos de ingeniería

Que la guardia deje de repetir lo que ya está escrito

Runbooks, ADRs y guías de onboarding que ya tenéis, respondiendo solos en Telegram interno o en la intranet. Nada público, y lo que no sabe lo escala a la guardia en vez de improvisarlo.

Cómo funciona

  1. 1

    Subís lo que ya tenéis escrito

    Runbooks, ADRs, guías de onboarding: los subís como documentos (PDF, markdown, texto) o indexáis las páginas de vuestra intranet. No hace falta reescribir nada, solo cargar lo que ya existe.

  2. 2

    Lo desplegáis donde ya habla el equipo

    Un bot de Telegram cerrado al equipo, o un widget en la intranet. Nada público, nada expuesto fuera de la organización.

  3. 3

    Responde con lo escrito, y escala lo que no sabe

    Cada pregunta se contesta con el documento que la cubre. Si no hay ninguno, o la respuesta exige criterio, avisa a la guardia o a la persona responsable en vez de improvisar.

  4. 4

    Lo mantenéis al día vosotros

    Los documentos subidos (PDF, markdown, texto) son estáticos: si cambia un runbook, alguien tiene que volver a subirlo. Las páginas indexadas por URL sí se rastrean solas, por defecto una vez a la semana.

Dónde se nota el tiempo ganado

No es una cifra medida: es menos veces que alguien repite lo mismo porque nadie encontró el documento.

Menos interrupciones de guardia

Las preguntas que ya tienen respuesta escrita dejan de sacar a alguien de guardia de lo suyo. Las que de verdad necesitan criterio siguen llegando, pero son las únicas.

Onboarding sin monopolizar a un senior

Alguien nuevo le pregunta al bot antes de interrumpir a quien lleva tres años en el equipo. La guía de onboarding responde sola las primeras semanas.

El conocimiento no se va cuando se va una persona

Lo que estaba en la cabeza de alguien que dejó el equipo sigue escrito y accesible, siempre que estuviera documentado. No depende de que esa persona esté disponible para repetirlo.

Las decisiones no se vuelven a debatir

Un ADR que nadie encuentra se discute otra vez desde cero. Si el asistente lo tiene cargado, responde con el porqué y la discusión no se repite.

Conocimiento privado, nunca público

Los runbooks y la documentación interna no salen de la organización: se cargan como conocimiento privado del asistente, igual que en cualquier otro uso interno.

Un asistente por equipo, si hace falta

Si la documentación está separada por squad o por sistema, cada equipo puede tener su propio asistente, con su propia documentación cargada.

YepClerk
Telegram interno
Soy nuevo, empiezo guardia la semana que viene. ¿Qué tengo que saber?
Según la guía de onboarding: el primer día de guardia revisa el runbook de cada servicio crítico y confirma que tienes acceso al panel de incidentes. El ADR-009 explica por qué la guardia no tiene acceso de escritura a producción por defecto.
¿Y si durante la guardia veo algo raro que no está en ningún runbook?
Eso no está documentado, así que no te lo puedo confirmar yo. Aviso al tech lead del equipo y te escribe en cuanto pueda.
Responde con la guía de onboarding, y escala al tech lead lo que no está documentado.

Subir documentos, o indexar páginas — nada más

La única forma de cargar conocimiento es subir documentos (PDF, markdown, texto) o indexar las páginas de una web o intranet a las que el asistente pueda acceder. Son dos fuentes con comportamiento distinto: un documento subido es estático, si el equipo actualiza el runbook alguien tiene que volver a subirlo o el asistente seguirá respondiendo con la versión anterior. Una página indexada por URL, en cambio, se vuelve a rastrear sola, por defecto una vez a la semana.

Para lo que vive en documentos, mantenerlo al día sigue siendo trabajo del equipo, no automatización del asistente: el asistente conoce exactamente lo que se le cargó, en el momento en que se cargó. Si la intranet es accesible por URL, indexarla en vez de subirla como documento evita ese mantenimiento manual.

Qué pasa exactamente cuando no sabe la respuesta

Un rollback que no está en el runbook estándar, una decisión de arquitectura nueva, un acceso a producción que se sale del procedimiento documentado: nada de eso se resuelve citando un documento, porque no hay ningún documento que lo cubra. El asistente lo detecta, marca la conversación como escalada y avisa a la guardia o a la persona responsable del equipo.

A partir de ese momento deja de responder en esa conversación. No insiste con una respuesta aproximada ni rellena el hueco con algo parecido a lo que preguntaron: se aparta, y quien reciba el aviso responde desde el panel. En Telegram, por la misma conversación donde preguntó el ingeniero; en el widget de la intranet, por email, porque ese canal no admite mensajes salientes.

Responde, no ejecuta

El asistente no tiene acceso de escritura ni credenciales sobre ningún sistema de la organización: no reinicia un servicio, no hace un rollback, no toca una base de datos ni concede un acceso. Sobre vuestros sistemas, solo lee lo que se le cargó o indexó, y responde con lo que encuentra ahí. Si un runbook dice «reinicia el worker desde el panel de admin», el asistente cita ese paso — no lo ejecuta por nadie. Quien actúa sigue siendo siempre una persona. Avisar a la guardia cuando no sabe la respuesta es lo único que hace además de responder, y no cuenta como ejecutar algo: no toca ningún sistema vuestro.

Es la misma razón por la que no se le da al asistente ningún permiso de escritura en ningún otro caso de uso: una capa que solo lee y responde no puede causar un incidente nuevo por equivocarse al actuar, porque nunca actúa. El límite no es una restricción temporal, es el diseño.

Preguntas frecuentes

¿El asistente puede ejecutar un rollback o tocar producción?
No ejecuta nada sobre vuestros sistemas: no tiene credenciales ni acceso a infraestructura. Lo único que hace además de responder es avisar a una persona cuando no sabe — eso no es ejecutar una acción sobre nada vuestro.
¿Cuánto tiempo ahorra realmente?
No hay una cifra medida que se pueda prometer. Depende de cuántas preguntas repetidas tenga hoy vuestro equipo y de cuánta de esa documentación esté cargada: si la guardia responde lo mismo varias veces al mes, ahí hay margen; si casi todo lo que preguntan ya es nuevo cada vez, el margen es menor.
¿Qué pasa si no sabe la respuesta?
Lo dice y escala a la guardia o a la persona responsable, y deja de responder en esa conversación. No improvisa un runbook que no existe ni una decisión que no está tomada.
¿Quién puede usarlo?
Solo el equipo: se despliega en un Telegram cerrado o en un widget dentro de la intranet, no hay ningún canal público expuesto.
¿Cómo se mantiene actualizado si cambia un runbook?
Depende de dónde viva el runbook. Si es un documento subido (PDF, markdown, texto), es estático: alguien del equipo tiene que volver a subirlo cuando cambia. Si es una página indexada por URL, se vuelve a rastrear sola, por defecto una vez a la semana.
¿Puede haber un asistente distinto por squad?
Sí: cada asistente tiene su propia documentación cargada. El de plataforma no responde con los runbooks del equipo de pagos.

Sectores donde más se nota

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.