Lo que escribo para no olvidar
Gestiono muchos proyectos a la vez y es difícil recordarlos todos. Por eso documento: para entender después las decisiones que tomé. Con la documentación no pierdo tiempo; tengo a mano todo lo que necesito para explicarme a mí mismo qué hice en su momento.
Qué documento en mi propia web
Esta web tiene su propia documentación, y la uso cada vez que toco algo:
- Un manual de marca con la idea del corte, el tono, el logo, el color, la tipografía y las reglas de cada componente.
- Una guía por componente, con un ejemplo que funciona, para saber qué pieza usar al construir algo nuevo.
- Un plan de mejoras con las fases del trabajo y las decisiones tomadas, cada una con su fecha.
- Un resumen de resultados con las mediciones de antes y después, de donde salió la tabla de La web que mide su velocidad.
- Instrucciones para la IA: cómo trabajar en el proyecto, en qué idiomas y paso a paso.
Escribo para cuatro lectores
Para mí. No quiero depender de mi memoria. Si necesito hacer cambios, tengo que saber sobre qué estoy parado.
Para mis colaboradores. Un negocio es negocio si puedes delegar, y solo se puede delegar lo que está escrito. En Drakkar, la agencia que dirijo, empecé justamente porque necesitaba delegar para crecer.
Para mis clientes. El proyecto es de ellos, y tienen que saber qué se hizo. Por eso les entrego documentación y tutoriales que les permiten resolver por su cuenta.
Para la IA. Es mi herramienta primordial, y tiene que tener claro qué debe hacer. Eso solo se consigue con documentación.
Lo que descarté, también
El plan de mejoras guarda cada decisión con su fecha. Me sirve para saber si en algún momento se me ocurre una idea repetida, y para recordar también lo que descarté y por qué.
La IA deja de inventar
La diferencia se nota. Cuando le entrego documentación, la IA deja de inventar y pasa a actuar: toma decisiones según mi criterio, no según el promedio de lo que ha visto. Lo noto en lo que produce.
Un ejemplo de esta web: el manual prohíbe las frases que podría firmar cualquiera, como «productos que marcan la diferencia». Con esa regla por escrito, la IA las señala y las reescribe en lugar de proponerlas. Sin el manual, son justo las que aparecen primero.
Si solo pudieras documentar dos cosas
Documenta el design system y la arquitectura del proyecto: cómo se ve y cómo está construido. Con eso, cualquiera, tú dentro de un año incluido, puede seguir sin empezar de cero.
Así nació el design system de esta web: yo pongo el criterio y lo dejo por escrito, y la documentación lo hace llegar a cada pieza.