Por qué construyo el software que explico

Grabo software desde 2019. Más de 800 videos, para más de 200 marcas, en inglés y en español. Durante casi todo ese tiempo estuve estrictamente del lado de afuera del producto: leía la documentación, abría la aplicación, buscaba la parte que confundiría a alguien en su primer día, y la explicaba.

Ese trabajo es una educación rara. Ves a doscientos equipos intentar el mismo puñado de problemas y después de un rato reconoces la forma de una buena decisión antes de poder decir por qué es buena.

Explicar es una forma de leer

Para grabar un tutorial tengo que llegar al producto como llega alguien nuevo: cuenta recién creada, sin datos, sin contexto. Luego escribo un guion. El guion es la parte que nadie ve y es donde ocurre casi todo el trabajo.

Un guion obliga a elegir una palabra por concepto y sostenerla nueve minutos. Si el producto le dice espacio de trabajo en la página de inicio, proyecto en la interfaz y entorno en la documentación, el guion se rompe antes que el video. Escribir la explicación es la auditoría más barata que existe de la claridad de un producto, y casi nadie la hace desde adentro porque desde adentro las tres palabras se entienden igual.

Lo que no se ve desde afuera

Ahí estaba mi límite.

Yo podía decir que una pantalla de permisos confunde. No podía decir si confunde porque el modelo de abajo está mal o porque las etiquetas están mal. Son dos problemas distintos, con arreglos distintos y con costos casi opuestos. Desde afuera se ven idénticos.

Empecé a escribir código por eso. No fue un plan de carrera ni una ambición de producto. Me faltaba información para hacer bien el trabajo que ya tenía.

Dejé de leer páginas de marketing

Cuando ya implementaste un receptor de webhooks, la frase "sincronización en tiempo real" deja de ser una afirmación y se vuelve una pregunta sobre garantías de entrega. ¿Reintenta? ¿Cuántas veces? ¿Qué pasa con los eventos que fallan mientras el servidor del cliente está caído?

La documentación de la API responde eso. La página de inicio no. Hoy abro primero la documentación y la página de precios, y la de marketing casi nunca. No es un gesto de desprecio: es que ya sé cuál de las tres contiene el dato que necesito para explicar sin equivocarme.

FlowCapture es el caso más corto

Grabar software todos los días son los mismos tres problemas: recorrer una página larga sin los saltos de la rueda del mouse, hacer zoom en el clic que de verdad importa, y mantener la burbuja de la cámara donde no tape la interfaz. Cada grabadora que probé hacía bien una de esas tres cosas.

Escribí una. FlowCapture es una extensión de Chrome que corre completa en el dispositivo, sobre MediaRecorder, WebCodecs y un compositor en canvas. Está publicada en la Chrome Web Store bajo Veeme Media, la agencia que fundé en 2013, y hoy tiene 4.8 de 5 en 19 calificaciones. Es la herramienta que necesitaba hace 800 videos.

Lo que me enseñó no tuvo que ver con video. Fue que procesar en el dispositivo es una función y no una limitación. Cuando dejé de subir el material a un servidor, la exportación se volvió más rápida, la explicación de privacidad cupo en una sola frase y no hubo factura de infraestructura que justificar. Yo daba por hecho que lo local era el compromiso. Era el producto.

A esa conclusión no llegas reseñando el software de alguien más. Llegas enviando algo y viendo cuáles de tus supuestos sobreviven al contacto con usuarios.

StackPulse me enseñó a desconfiar de mis propios números

StackPulse es lo otro que sí salió: una aplicación de barra de menú para macOS que lee uso y gasto de proveedores de IA, de código abierto bajo licencia MIT.

Ahí cometí un error que vale más que muchos aciertos. Identificaba cada modelo por coincidencia de texto dentro del nombre. Cuando salió una versión nueva, esa comparación tomó la tarifa equivocada en silencio y sobreestimó mi gasto por casi el triple. No hubo error visible, no hubo pantalla roja. Solo un número tranquilo y falso durante semanas.

Desde entonces, cuando grabo un panel de métricas, mi primera pregunta ya no es dónde está el botón. Es de dónde sale cada número. Un número en pantalla es una afirmación, y alguien tiene que poder verificarla. Esa pregunta se la debo a mi propio código, no a los doscientos productos que expliqué antes.

El ciclo, dicho sin adorno

Explico software porque lo construyo. Lo construyo porque opero negocios que lo necesitan.

Las dos direcciones cargan peso. El trabajo de explicar me dice qué construir: FlowCapture existe porque 800 grabaciones definieron sus requisitos mejor de lo que lo haría cualquier lluvia de ideas. El trabajo de construir hace que la explicación sea precisa, porque estoy describiendo mecanismos que implementé y no funciones sobre las que leí.

Publicar cambia la conversación

Hay una diferencia grande entre una herramienta que uso y una herramienta que alguien más instala, y no está en el código.

En este sitio hay nueve proyectos. Siete tienen una liga pública que puedes abrir hoy. Dos siguen marcados como prototipo. La etiqueta no la pongo yo a criterio: se asigna consultando la liga, y si no hay liga que responda, dice prototipo aunque el proyecto lleve meses funcionando en mi máquina.

Esa regla es incómoda a propósito. La primera vez que la apliqué me obligó a bajar de categoría cosas que ya estaba describiendo en voz alta como si estuvieran publicadas. Es más fácil sostener una regla que revisar cada frase.

Lo que no esperaba es cuánto cambia el producto después de publicar. Mientras la herramienta es mía, cada supuesto raro tiene una explicación que vive en mi cabeza. En cuanto la instala alguien más, la explicación tiene que estar en la interfaz o no existe. Publicar cinco extensiones en la Chrome Web Store me enseñó más sobre primeros usos que las 800 grabaciones, porque en el video yo controlo el orden y en una tienda no.

El costo sigue siendo el mismo de siempre: construir hace más lento el video. Una semana escribiendo un analizador de precios es una semana sin grabar. Acepté ese intercambio porque la alternativa, explicar software indefinidamente desde afuera y equivocarme con soltura, es peor de una forma que la audiencia acabaría notando.