--- type: DC asset_id: DC-EL-GuiaObsidian-IntelliBanks-Equipo-v01 version: v01 status: Activo owner: Victor Heredia sherpa_owner: Jay ratificador: Victor Heredia intellbank: IB-EL-EmpowerLabs fecha_creacion: 2026-06-25 fecha_ultima_actualizacion: 2026-06-25 proposito: Guía oficial para que el equipo EmpowerLabs trabaje en Obsidian apuntando a la carpeta sincronizada de IntelliBanks, con la app subiendo todo a la nube del equipo. --- # Guía del Equipo — Trabajar en Obsidian sobre IntelliBanks **Para:** Equipo EmpowerLabs **Owner:** Victor Heredia · **Sherpa:** Jay **Fecha:** 2026-06-25 --- ## 1. Qué cambió y por qué Antes trabajábamos en un vault local aislado y los cambios **no** llegaban solos a la nube. Ahora: - **La carpeta de trabajo oficial es `Documents/IntelliBanks/`.** - La **app IntelliBanks** vigila esa carpeta y la **sincroniza con la nube del equipo** automáticamente. - Trabajamos en **Obsidian apuntando a esa misma carpeta**, así que: *guardas en Obsidian → la app lo detecta → sube a la nube*. Un solo flujo, sin pasos manuales. > Regla de oro: **todo lo que trabajes vive en `Documents/IntelliBanks/`.** Nada queda solo en un chat ni en carpetas sueltas. --- ## 2. Requisitos previos - Tener instalada y con sesión iniciada la **app IntelliBanks**. - Tener **Obsidian** instalado. - Haber hecho respaldo de tu vault anterior (no lo borres hasta validar). --- ## 3. Apuntar Obsidian a la carpeta de IntelliBanks 1. Abre **Obsidian**. 2. Abajo a la izquierda, clic en el **nombre del vault actual** → **"Manage vaults…"**. 3. Clic en **"Open folder as vault"**. 4. Navega a **`Documents/IntelliBanks`** y ábrela. 5. Cuando pregunte, elige **"Trust author and enable plugins"** (es tu propia carpeta). --- ## 4. Esconder los archivos gemelos (`_ext.md`) La app genera una versión normalizada de cada binario (ej. `X.html` → `X_html.md`). Para que no ensucien tu grafo y búsqueda: 1. **Settings (⌘ + ,) → Files and links → Excluded files → Add.** 2. Pega esta regex (una sola entrada cubre todos): ``` /_(html|docx|pdf|pptx|xlsx)\.md$/ ``` --- ## 5. Reglas de operación (importante) 1. **Deja la app IntelliBanks abierta** mientras trabajas — es la que sube tus cambios. Si la cierras, no sincroniza. 2. **Evita editar el mismo archivo que otra persona al mismo tiempo.** Es nube compartida; la co-edición simultánea puede generar conflictos. Coordínense por archivo. 3. **Naming + ubicación BMF antes de guardar:** `TIPO-ENTIDAD-Proyecto-Nombre-vNN`, dentro de su `IB-*` correcto. Nada en raíz ni en carpetas ad-hoc. 4. **Los dashboards HTML ábrelos desde el escritorio (Finder), no desde la app.** Dentro de la app la navegación entre tableros aún no funciona (ver pendiente abajo); desde el desktop sí. 5. **No toques los archivos ocultos de la app** (`.intellibanks_*`). Son su base de sincronización. --- ## 6. Validar que funciona (hazlo una vez) 1. En Obsidian (ya en el vault IntelliBanks), edita o crea una nota de prueba y guarda. 2. Mira el panel **"Sincronización en vivo"** de la app: debe decir **"✅ Actualización subida con éxito"** (o "Creado en la nube con éxito"). 3. Verifica que tus enlaces `[[ ]]` resuelvan y que **no** veas los gemelos en el grafo. Si ves la subida exitosa, ya estás operando en el flujo correcto. ✅ --- ## 7. Qué NO hacer - No sigas trabajando en el vault viejo: queda solo como respaldo. - No borres ni edites los archivos `.intellibanks_sync_*`. - No muevas/renombres carpetas `IB-*` sin avisar (rompe rutas y sincronización). --- ## 8. Pendientes conocidos (en proceso con Alex) - **Navegación entre dashboards dentro de la app:** da 404 porque la app sirve por ID interno, no por ruta. Workaround: abrir los HTML desde el desktop. (RFI: `IB-XX-Maestro/RFI-XX-IntelliBanks-NavInternaDashboards-v01.md`.) - **Carpeta `.obsidian/`:** confirmar que la app la ignore para no subir config personal a la nube del equipo. --- *Dudas o algo que no sincroniza: avisar a Victor / Jay. Owner: Victor Heredia · Sherpa: Jay.*