¿Y si tu documentación funcionara de verdad?
Una agencia respaldada por YC descubrió cómo arreglar documentación técnica rota en semanas, no meses — dejando que la IA haga el trabajo tedioso y los humanos el estratégico.
Lo que construyeron
Manicule es una agencia pequeña que se hace cargo de la documentación técnica — los manuales de instrucciones de los productos de software — para empresas que crean herramientas para desarrolladores. Se encargan de todo: la estructura, el texto, el diseño, los controles de calidad.
Lo inteligente está en cómo dividen el trabajo. Los agentes de IA se ocupan de lo que es tedioso pero necesario — comprobar que cada enlace funciona, verificar que los ejemplos de código siguen siendo válidos, generar un primer borrador a partir de las especificaciones técnicas del producto. Luego entran los humanos para lo que requiere criterio: ¿qué historia estamos contando? ¿Para quién es esto? ¿Qué necesita entender un desarrollador confundido?
El resultado: publicaron la documentación completa de un cliente en 23 días. Después de eso, el producto respondía correctamente las preguntas de los usuarios un 30% más. No es un número menor — es la diferencia entre un cliente que se queda y uno que se va.
Por qué esto te importa
Quizá tú no haces herramientas para desarrolladores. Pero si alguna vez has mirado tu propia web, tus emails de bienvenida o tus preguntas frecuentes y has pensado esto hay que arreglarlo pero no sé por dónde empezar — ese sentimiento es universal. El modelo de Manicule funciona porque dejaron de pretender que una sola persona puede hacer todo esto, y construyeron un equipo donde la IA y las personas hacen lo que cada una sabe hacer bien.
Es un enfoque tranquilo y honesto. Y con 15.000 dólares mensuales de ingresos recurrentes con un equipo pequeño, parece que está funcionando.
Palabras que vale la pena conocer
MRR (Monthly Recurring Revenue): El dinero que un negocio cobra de forma predecible cada mes. $15K MRR significa unos 15.000 dólares entrando cada mes, de manera estable.
Especificación OpenAPI: Un documento estándar que describe exactamente cómo funciona un programa. Es como un plano técnico que la IA puede leer para generar borradores de documentación de forma automática.
Herramientas para desarrolladores: Software que otros programadores usan para construir su propio software. Como un proveedor de cocina que vende a restaurantes, no a particulares.
Y Combinator (YC): Un programa de startups muy conocido en Silicon Valley. Que una empresa sea "respaldada por YC" es una señal de que alguien examinó la idea con cuidado y apostó dinero real por ella.
Algo en lo que vale la pena pensar: ¿qué parte de la comunicación de tu negocio lleva meses rota en silencio — porque arreglarlo bien requeriría a alguien que sea a la vez escritor, estratega y técnico?
Field Notes, cada viernes
Las mejores herramientas gratuitas y open source de la semana en un correo corto, más las notas de David cuando tiene algo que contar. El correo llega en inglés.
¿Ya tienes clientes pero el crecimiento no arranca? Cuéntanos qué lo está frenando.
Empezar las cinco preguntas