---
title: "Alternativa a Obsidian para el equipo | CommitCycle"
description: "Una línea que aplicas nota a nota: si equivocarte en ella induciría a error a otra persona, se le ha quedado pequeño el vault. Qué se mueve y adónde."
url: https://commitcycle.com/es/insights/what-to-move-out-of-obsidian/
language: es
---

# Qué sacar de Obsidian, y qué dejar dentro

> Una línea que aplicas nota a nota: si equivocarte en ella induciría a error a otra persona, se le ha quedado pequeño el vault. Qué se mueve y adónde.

14 de agosto de 2026 · actualizado 18 de agosto de 2026

[Paulo L.](https://commitcycle.com/es/about/) AI Growth Hacker

Mueve las notas de las que otras personas dependen para que sean ciertas — convenciones, decisiones y sus motivos, y cualquier cosa sobre la que un agente actuaría. Deja todo lo que sea pensamiento en curso. La prueba es por nota, no por vault: si equivocarte en esta nota induciría a error a otra persona, se le ha quedado pequeña una herramienta personal.

El [post anterior](https://commitcycle.com/es/insights/obsidian-ai-agent-knowledge-base/) sostenía que un vault de Obsidian no puede ser la base de conocimiento de tus agentes de IA: es privado de una máquina, sus afirmaciones no llevan procedencia y nada marca una nota como caducada.

Con ese argumento se está de acuerdo y luego no se actúa, porque «mueve tu conocimiento» no es algo que nadie pueda empezar un martes. Este post es la mitad práctica. Qué se mueve de verdad, qué se queda, y qué aspecto tiene el reemplazo una vez está en marcha.

## La línea, aplicada nota a nota

**Si equivocarte en esta nota induciría a error a otra persona, se le ha quedado pequeño un vault personal.**

Nota a nota, no vault a vault. Esa distinción lo es todo, y es la razón de que sea un trabajo más pequeño de lo que suena. La mayor parte de un vault es pensamiento — conexiones a medio hacer, restos de reuniones, cosas que escribiste para averiguar qué pensabas. Nada de eso se mueve. Lo que se mueve es la minoría sobre la que otras personas, o un agente, actuarían.

En la práctica ha sido menos de una quinta parte de las notas en todos los casos que he visto hacerlo. El resto se queda exactamente donde está.

## ¿Qué se mueve?

**Las convenciones.** «Las migraciones las hacemos en dos pasos.» «Los handlers devuelven el error, no lo registran.» Cualquier cosa formulada como _hacemos X_ es una afirmación sobre el equipo, y una afirmación sobre el equipo pertenece a donde el equipo pueda verla y corregirla.

**Las decisiones, con sus motivos.** No sólo lo que se eligió, sino lo que se descartó y por qué. Es la categoría de mayor valor y la que más se pierde, porque el razonamiento vive en la cabeza de alguien y el vault registra sólo la conclusión. Un agente al que le entregas la conclusión sin el motivo la deshará alegremente la primera vez que la conclusión resulte incómoda.

**Cualquier cosa sobre la que un agente actuaría.** Si una nota cambiaría lo que se escribe cuando un agente la lee, es operativa, no personal. Es la categoría más nueva y aquella para la que los vaults nunca se diseñaron.

**Los límites.** _«Deliberadamente no hacemos X, y aquí está por qué.»_ Nadie los escribe y todo el mundo los redescubre por la vía cara.

## ¿Qué se queda?

Todo lo demás, y no es un premio de consolación.

Las ideas a medio formar. Las notas a las que se les permite estar equivocadas. La conexión que aún no has hecho. Las notas de lectura, los restos de reuniones, lo que escribiste a las 2 de la mañana y a las 2 de la mañana tenía sentido. Obsidian es mejor en todo eso que cualquier cosa por la que lo cambiarías, y es mejor porque no tiene revisión, ni aprobación, ni público — exactamente las propiedades que lo descalifican para la otra categoría.

Un vault que sólo contiene esto es un vault haciendo su trabajo.

## ¿Y las notas que son mitad pensamiento, mitad convención?

El caso incómodo habitual, y el que atasca a la gente, porque la línea parece limpia hasta que te encuentras con una nota real de dos mil palabras dándole vueltas a algo con una decisión de verdad enterrada al final.

**Divídela, y es más fácil de lo que parece.** El pensamiento se queda en el vault. La afirmación se mueve, sola, como una frase. Enlaza de vuelta si quieres.

Lo que no debes hacer es mover el conjunto. Una nota que es ochenta por ciento tanteo y veinte por ciento decisión, dentro del repositorio, le enseña a un agente que las convenciones de tu equipo son tentativas — y un agente que cree que una regla es tentativa negociará con ella la primera vez que la regla resulte incómoda. Dejar el conjunto en el vault tiene el fallo opuesto: el veinte por ciento que otras personas necesitan queda invisible, indistinguible de la divagación que lo rodea.

La prueba de si una nota está lista: **¿puedes extraer una frase que empiece por «hacemos» o «no hacemos»?** Si no, todavía no hay nada que mover, y la nota sigue haciendo su trabajo donde está.

## ¿Dónde deben vivir las notas que se mueven?

**En el repositorio que describen.** No en un wiki, no en una segunda herramienta: el repo, revisado en el mismo pull request que el código del que hablan.

Esa ubicación es la que hace el trabajo. Una nota en el repo se lee en el momento en que alguien cambia lo que describe, porque está en el diff. Una nota en un wiki se lee cuando alguien va a buscarla, que es el modo de fallo que estás dejando atrás.

También significa que la nota se revisa como código. Alguien la aprueba. Alguien responde por ella. Dos ingenieros no pueden sostener dos versiones contradictorias sin que una de ellas aparezca en un diff.

## ¿Qué aspecto tiene una nota ya movida?

El formato importa menos que cuatro propiedades, y cada una responde a una forma en que fallaba la versión del vault:

- **Una afirmación por nota.** _«Las migraciones las hacemos en dos pasos»_ es una nota. _«Notas sobre nuestro backend»_ es una carpeta disfrazada de nota, y nada de lo que hay dentro se puede confirmar, contradecir ni archivar por separado.
- **Dice de dónde viene.** La decisión, el incidente, el pull request. Una afirmación que no puedes rastrear es una afirmación que no puedes ponderar, y mover una afirmación irrastreable al repositorio reubica el problema en lugar de arreglarlo.
- **Dice qué se descartó.** La conclusión sin el razonamiento se deshace la primera vez que la conclusión resulta incómoda — normalmente por un agente, alegremente, en un diff que parece una simplificación.
- **En presente, y lo bastante concreta como para poder estar equivocada.** _«Cuidado con las migraciones»_ no es una nota, es un estado de ánimo. Nadie puede actuar sobre ella y nadie podrá demostrar nunca que ha caducado.

Y corta. La razón por la que las páginas de wiki no se leen es que tienen dos mil palabras cuando la afirmación es una línea, y **una nota que nadie lee es una nota que no existe** — que es el mismo desenlace que dejarla en el vault, después de más trabajo.

## ¿Qué no arregla esto?

Mover las notas al repo arregla el descubrimiento y la revisión. **No arregla la degradación**, y cualquier post que te dijera lo contrario te estaría vendiendo algo.

Una nota en un repositorio caduca exactamente igual de rápido que una nota en un vault. Lo que cambia la degradación no es la ubicación, es un disparador — algo que obligue a escribir el conocimiento mientras la persona todavía recuerda por qué, y algo que permita retirar una nota equivocada por un mecanismo y no por la memoria de alguien.

Esas son las dos propiedades que hay que buscar en lo que sea que uses, y son las dos sobre las que construye CommitCycle: el conocimiento se alimenta al cerrar una unidad de trabajo, una línea cada vez, cuando el motivo aún está fresco; y `archived` es un estado real, que es lo que permite que el corpus encoja en lugar de sólo volverse más seguro de sí mismo.

## ¿Cómo empiezo sin una migración?

No migres. Las migraciones de conocimiento fallan por la misma razón que fallan las migraciones de cualquier cosa: el esfuerzo va por delante y el beneficio queda difuso.

En su lugar: **la próxima vez que escribas una nota de la que otras personas dependerían, escríbela en el repo en lugar de en el vault.** Y luego la siguiente. El vault deja de crecer en la categoría que duele, y el corpus que importa empieza a acumularse en el sitio donde se revisa. No se mueve nada y no se pierde nada.

Para las notas cuyos lectores son agentes y no personas, el destino tiene una forma: [una skill](https://commitcycle.com/es/insights/agent-skills-guide/) es una carpeta en el repositorio que se carga cuando resulta relevante y se ignora cuando no, que es lo más parecido a una nota de vault que un agente puede usar de verdad.

Al cabo de unas semanas, lo que siga en el vault y siga siendo estructural es una lista corta, y para entonces sabrás exactamente qué notas están en ella.

## ¿Cómo sé que está funcionando?

Cuatro señales, más o menos en el orden en que aparecen:

1. **Dejas de reexplicar lo mismo en cada sesión nueva.** Esta llega primero y es la más satisfactoria de inmediato.
2. **Alguien corrige una nota durante una revisión de código.** Eso es la ubicación dando fruto: significa que la nota se leyó en el momento en que se estaba cambiando lo que describe, que es la razón entera por la que fue al repositorio.
3. **Un agente te cita una de vuelta** — propone algo y nombra la nota de la que salió, en lugar de proponer algo plausible.
4. **Alguien archiva una.** Esta es la señal de verdad, y es la que más tarda. Un corpus que sólo ha crecido se está acumulando, no manteniendo, y acabará exactamente donde estaba el vault: más seguro de sí mismo cada mes y menos exacto.

La contraseñal es el espejo de esa última. Si las notas del repositorio crecen y nunca se ha retirado ninguna, has reconstruido el vault con ceremonia extra, y la caducidad viene de camino.

## Dónde está CommitCycle de verdad

Merece decirse claramente, porque el sentido de este post es una línea que puedes aplicar con nosotros o sin nosotros: el enforcement se instala hoy como plugin, y el paquete `commitcycle` de npm instala la CLI a su lado. El board alojado es sólo por invitación mientras esto sea pequeño.

Así que coge la línea y úsala. No cuesta nada, se aplica a las herramientas que tengas, y el argumento que hay debajo está [en el post anterior](https://commitcycle.com/es/insights/obsidian-ai-agent-knowledge-base/) si quieres comprobar el razonamiento antes de fiarte de la conclusión.

## Preguntas que responde esta página

### ¿Debo dejar de usar Obsidian si mi equipo usa agentes de código en IA?

No. Obsidian es muy bueno para una persona pensando, y ese trabajo no desaparece. Lo que sale es el subconjunto del que otros lectores dependen para que sea cierto — convenciones, decisiones y sus motivos — porque esa es la parte que duele cuando caduca, y nunca fue la parte que un vault personal se construyó para sostener.

### ¿Cuál es la prueba para saber si una nota debe moverse?

Si equivocarte en esta nota induciría a error a otra persona, se le ha quedado pequeño un vault personal. Aplicada nota a nota en lugar de vault a vault, esa línea suele mover menos de lo que la gente espera.

### ¿Dónde deben vivir de verdad las notas que se mueven?

En el repositorio que describen, revisadas en el mismo pull request que el código del que hablan. Eso es lo que hace que se lean, porque el momento en que alguien cambia la cosa es el momento en que la nota sobre esa cosa la tiene delante.

### ¿Mover notas al repo no recrea el mismo problema de caducidad?

En parte, y fingir lo contrario sería deshonesto. Vivir en el repo arregla el descubrimiento y la revisión, pero no la degradación. Lo que arregla la degradación es un disparador — conocimiento escrito al cerrar una unidad de trabajo, mientras la persona todavía recuerda por qué — más la posibilidad de archivar una nota en lugar de depender de que alguien recuerde que está mal.

### ¿Qué aspecto debe tener una nota una vez movida al repositorio?

Una afirmación por nota, dicha en presente, lo bastante concreta como para poder estar equivocada, que lleve de dónde salió y qué descartó. "Las migraciones las hacemos en dos pasos, por el incidente del PR 412, y descartamos la versión automática por esta razón" es una nota. "Notas sobre nuestro backend" es una carpeta disfrazada de nota.

### ¿Qué hago con una nota que es mitad pensamiento y mitad convención?

Divídela. El pensamiento se queda en el vault y la afirmación se mueve. Mover el conjunto le enseña a un agente que tus convenciones son tentativas, y dejar el conjunto hace invisible la convención. Si no puedes extraer una frase que empiece por "hacemos" o "no hacemos", todavía no hay nada que mover.

### ¿Cómo sé si esto está funcionando de verdad?

Cuatro señales, en el orden en que aparecen: dejas de reexplicar lo mismo en cada sesión nueva, alguien corrige una nota durante una revisión de código, un agente te cita una de vuelta y — la de verdad — alguien archiva una. Un corpus que nunca ha encogido se está acumulando, no manteniendo.