Documentación para tu yo del futuro:ROI 18x en 10 min

Cuando construyes solo, la documentación no es para otros: es documentación para tu yo del futuro, y tu yo del futuro lo ha olvidado todo. Diez minutos de notas al construir una funcionalidad me habrían ahorrado las tres horas que después pasé haciendo ingeniería inversa de mi propia base de datos. Eso es un retorno de 18x, en una sola funcionalidad.

La documentación suena al hábito más corporativo y más prescindible que un solopreneur podría adoptar. Es justo lo contrario: es el hábito que permite que una empresa de una sola persona se comporte como un equipo, porque quien escribió el código hace seis meses es, en la práctica, otra persona.

El día que olvidé mi propio esquema de base de datos

Tres meses antes había construido una funcionalidad compleja para mi plataforma de aceleradora. Diseño de base de datos con varias tablas, cuidadosamente estructurado, políticas de seguridad, todo. Me llevó seis horas diseñarla e implementarla, y estaba orgulloso.

Entonces necesité añadir un campo a esa funcionalidad. Abrí el código, miré las tablas, empecé a leer, y no tenía ni idea de por qué había tomado ciertas decisiones. ¿Por qué cuatro tablas intermedias en lugar de dos? ¿Por qué esta columna es opcional? ¿Por qué esta regla de acceso comprueba dos cosas en lugar de una?

Pasé tres horas haciendo ingeniería inversa de mi propio código. No el de otro. El mío. Sin notas sobre la funcionalidad, sin explicación del diseño, sin nada que mostrara cómo se relacionaban las piezas. Solo código y una memoria que lo había borrado todo en silencio.

En un equipo, las decisiones se discuten y el conocimiento se comparte. En solitario, solo existe una copia del "por qué", en tu cabeza, y caduca más rápido de lo que crees. Ese es el coste oculto del desarrollo en solitario, y casi nadie lo contabiliza.

Documentación para tu yo del futuro: las cuentas del punto de equilibrio

Diez minutos de documentación al construir esa funcionalidad me habrían ahorrado tres horas después. ROI de 18x, con una funcionalidad. Ahora escálalo: tengo 45 funcionalidades en producción. Si documentar de antemano ahorra unas dos horas por funcionalidad con el tiempo, son 90 horas al año: 7.200 € de mi tiempo a 80 €/hora, comprados con diez minutos por funcionalidad.

Las cuentas a lo largo de toda la vida útil son aún más desiguales. Toma una funcionalidad y diez cambios futuros:

Unas 18 horas ahorradas por funcionalidad a lo largo de su vida. En 45 funcionalidades, son 815 horas: 65.200 € de valor a 80 €/hora. Pero, siendo honestos, el dinero no es lo importante. Lo importante es lo que te permite hacer la documentación: refactorizar sin miedo porque sabes qué se va a romper, construir sobre trabajo anterior porque recuerdas tus propios diseños y depurar en minutos porque las trampas están escritas.

El libroThe Solopreneur RevolutionLuis Gonçalves sobre cómo crear un negocio de solopreneur con IA sin dejar tu empleo.Consigue el libro →

Los cuatro documentos que necesita toda funcionalidad

Tras 45 funcionalidades, me he quedado con cuatro tipos de documentos, por orden de importancia.

Documentos de por qué: el contexto de negocio. El más importante y el que más se omite. ¿Qué problema resuelve esta funcionalidad, qué impacto tiene y por qué tomaste las decisiones de diseño clave? Es el documento que impide que tu yo del futuro "optimice" una decisión que existía por una razón. Como arquitecto de tu producto, tus decisiones son el único activo que no se puede regenerar: escríbelas.

Documentos de qué: cómo funciona. Las tablas implicadas, cómo fluyen los datos por la funcionalidad, qué ocurre y en qué orden. Es el documento que responde a "¿por qué cuatro tablas intermedias?" en treinta segundos en lugar de tres horas.

Documentos de cómo: la guía de uso. Cómo manejas tú (o, algún día, una persona de soporte) la funcionalidad: dónde se configura, qué ven los usuarios, cuáles son los pasos.

Documentos de trampas: las notas de resolución de problemas. Cada trampa que te ha mordido: el ajuste que parece roto pero solo es lento, los datos que deben existir para que algo funcione, el arreglo para el error que seguro volverás a ver. Cada entrada ahorra una futura sesión de depuración.

Haz que la documentación sea automática

Aquí está la objeción honesta: no quiero gastar ni siquiera diez minutos por funcionalidad escribiendo documentación a mano. Es aburrido y es tiempo que no dedico a construir. Antes de la IA, esa objeción ganaba: la documentación costaba de dos a tres horas por funcionalidad, así que la omitía.

Con la IA, la fricción desaparece. Cada funcionalidad que construyo parte de un briefing estructurado, un PRP, que ya contiene el objetivo, las decisiones de diseño y las trampas. Cuando la funcionalidad se lanza, la IA convierte ese briefing en documentación en unos diez minutos. Completa, coherente, y nunca se salta secciones por aburrimiento.

Luego una regla mantiene vivo el hábito: si lanzo código sin documentación, no he lanzado. Mi lista de comprobación lo impone: funcionalidad, tests y documentación; las tres cosas o no se fusiona. No puedo saltarme mi propia regla, que es precisamente el objetivo.

El resultado: más de mil páginas de documentación con búsqueda, escritas sobre todo por IA, que cubren cada funcionalidad del producto. Cero momentos de "¿en qué estaba pensando?" desde entonces. Y cuando contrate a mi primer ingeniero, lo heredará todo el primer día: una ventaja de dos semanas en la incorporación que la mayoría de las empresas construidas en solitario simplemente no tienen.

12 semanasTu carrera corporativa nunca fue el planSolicita plaza en el Solopreneur Accelerator.Solicitar ahora →

Preguntas frecuentes

¿Por qué documentar un proyecto en el que solo trabajo yo?

Porque en seis meses eres, a todos los efectos prácticos, otra persona. Yo pasé tres horas haciendo ingeniería inversa de mi propia base de datos porque no documenté nada. La documentación en solitario no es burocracia: es un mensaje de tu yo del presente a tu yo del futuro, y tu yo del futuro siempre lo lee agradecido.

¿Qué debería documentar exactamente?

Cuatro cosas por funcionalidad: por qué existe y por qué tomaste las decisiones clave; qué hace técnicamente; cómo se usa; y las trampas que te han mordido. Si solo escribes una, escribe el porqué: es la única parte que el propio código nunca podrá contarte.

¿Cuánto tarda la documentación con IA?

Unos diez minutos por funcionalidad. Si construyes a partir de un briefing estructurado, la IA genera la documentación a partir de material que ya existe: es una conversión, no un proyecto de redacción. El coste de antes era de dos a tres horas por funcionalidad, por eso nadie lo hacía.

¿Cuál es el ROI de documentar como fundador en solitario?

Mis números: diez minutos de documentación frente a tres horas de reaprendizaje son 18x en un solo cambio. A lo largo de la vida de una funcionalidad son unas 18 horas ahorradas; en mis 45 funcionalidades, unas 815 horas: 65.200 € a 80 €/hora. Más la parte que no tiene precio: la confianza para cambiar tu propio código sin miedo.