Por qué documentamos todo en Obsidian siendo tres personas

Somos tres personas llevando más de diez proyectos a la vez. Hecha la cuenta, a cada uno nos tocan varios proyectos abiertos en paralelo, cada uno con sus decisiones, sus configuraciones y sus particularidades. Si todo eso viviera solo en la cabeza de quien lo lleva, bastaría una semana de vacaciones o un cambio de foco para que el resto del equipo se encontrara con preguntas sin respuesta.

Por eso en Taiko todo lo importante está escrito: las decisiones de cada proyecto, las configuraciones de infraestructura, los procedimientos, lo que hemos ido aprendiendo. Y vive en un único sitio, Obsidian. Este artículo no va de la herramienta, que es casi lo de menos, sino de por qué un equipo pequeño no puede permitirse prescindir de esto y de qué hace falta para que funcione.

La memoria de un equipo pequeño es frágil

En una empresa grande, el conocimiento está repartido y hay redundancia: si alguien falta, otra persona sabe lo mismo o lo averiguará preguntando a un tercero. En un equipo de tres, la redundancia es un lujo. Lo que sabe una persona de un proyecto es, en la práctica, lo único que se sabe de ese proyecto. Y eso la convierte en un cuello de botella: todo lo que pase por ahí espera a que esa persona esté disponible.

El problema se ve sobre todo en los momentos incómodos: una incidencia que llega cuando quien conoce el sistema no está, una duda sobre por qué algo se configuró de una manera determinada, un proyecto que alguien retoma tras meses sin tocarlo. Sin nada escrito, la respuesta es reconstruir de memoria, o llamar a quien sabe y esperar. Con algo escrito, la respuesta está a una búsqueda de distancia.

Qué es Obsidian y por qué nos sirve

Obsidian es una aplicación para tomar notas que trabaja sobre una carpeta de archivos de texto en formato Markdown (esa carpeta es lo que se llama un vault). Cada nota es un archivo normal, legible con cualquier editor, y las notas se enlazan entre sí. Esa sencillez es una ventaja práctica: no dependemos de un formato cerrado, y lo escrito es fácil de buscar, de enlazar y de leer por otros programas.

Esto último es lo que nos importa. Una carpeta de texto plano se puede leer también desde fuera de Obsidian, y ahí entra la IA. Usamos conectores MCP (el estándar que explicamos en MCP, el puente entre la inteligencia artificial y tus herramientas) para que un modelo pueda leer y escribir en el vault. Así, un briefing diario o el resumen del estado de un proyecto se nutren de lo que ya está escrito, en lugar de que alguien tenga que reunirlo de nuevo cada vez. Contamos cómo se monta ese briefing en de Obsidian a Slack pasando por FileMaker.

El hábito importa más que la herramienta

Lo que hace útil la documentación no es Obsidian ni ninguna otra herramienta, es el hábito. Y el hábito que nos ha funcionado es sencillo: documentamos en el momento, no “cuando haya tiempo”. Ese momento en el que habrá tiempo no llega. Lo que no se escribe cuando se decide o se configura se olvida, o se reconstruye mal semanas después.

Escribir en el momento tiene otra ventaja: la nota recoge el contexto cuando todavía está fresco. No solo qué se hizo, sino por qué se descartó la otra opción. Ese porqué es lo primero que se pierde y lo que más se echa en falta cuando alguien, incluso uno mismo, vuelve a mirar el asunto tiempo después.

Y lo conectamos. Una nota aislada sirve poco; las notas enlazadas entre sí (la decisión de un proyecto, la configuración que la sostiene, el procedimiento que se deriva) forman un mapa por el que se puede navegar. Esa conexión es lo que permite que, al buscar una cosa, aparezca lo relacionado con ella.

Efecto secundario: documentar obliga a pensar

Hay un beneficio que no esperábamos cuando empezamos. Cuando tienes que explicar por escrito por qué tomaste una decisión, a veces descubres que no era la correcta. Una decisión que parecía sólida en la cabeza se debilita al ponerla en palabras: aparece el supuesto que no habías comprobado, la alternativa que no habías considerado, el detalle que no cuadra.

No siempre ocurre, pero ocurre las veces suficientes como para que escribir sea también una forma de revisar. Para un equipo pequeño, donde no hay un comité ni una segunda opinión sistemática, es una especie de control barato: la nota hace de segundo par de ojos.

No es burocracia

Es fácil que “documentar todo” suene a burocracia, a rellenar plantillas que nadie lee. No es lo que buscamos. La documentación que no se consulta es un coste sin retorno, y la única forma de que se consulte es que sea útil: fácil de escribir en el momento, fácil de encontrar después, y suficientemente cercana al trabajo diario como para que consultarla sea más rápido que preguntar.

Para nosotros es lo que nos permite ser pequeños y movernos rápido sin perder el hilo. Puedes ver más sobre cómo organizamos el trabajo en cómo trabajamos.

Dónde vive el conocimiento de tu equipo

Si diriges un equipo pequeño, la pregunta que te dejamos es la que nos hacemos nosotros: ¿dónde vive el conocimiento de tu equipo, en una herramienta o en la cabeza de alguien? Si la respuesta es la segunda, no hace falta montar nada sofisticado para empezar. Basta con elegir un sitio y acordar que lo importante se escribe allí, cuando ocurre. Si quieres comentar cómo lo plantearías en tu empresa, puedes escribirnos a través de contacto.