Actualización docs: sync automático y nuevos proyectos en cloud

2026-05-03 17:02:28 +02:00
parent 801c49c9fd
commit fcc1b4ee46
7 changed files with 328 additions and 7 deletions
--- a/obsidian/02-instalacion-y-setup.md
+++ b/obsidian/02-instalacion-y-setup.md
@@ -0,0 +1,123 @@
+# Obsidian — Configuración del proyecto
+
+Guía completa de la vault de Obsidian para el proyecto de migración SourceSafe → GitHub.
+
+---
+
+## Instalación
+
+Descarga desde `https://obsidian.md/download` e instala en Windows.
+
+Al abrir Obsidian selecciona **"Open folder as vault"** y apunta a:
+```
+C:\Users\juanm\Documents\GitHub\PLANIFICACION_PROYECTOS
+```
+
+---
+
+## Estructura de la vault
+
+```
+PLANIFICACION_PROYECTOS/
+├── docs/
+│   ├── decisiones/        → DEC-001, DEC-002... decisiones técnicas
+│   ├── reuniones/         → Actas con fecha YYYY-MM-DD-tema.md
+│   └── arquitectura/      → Diagramas y docs técnicas
+├── kanban/
+│   └── migracion-sourcesafe-github.md
+├── templates/
+│   ├── reunion.md         → Plantilla para actas
+│   └── decision.md        → Plantilla para decisiones
+└── README.md
+```
+
+---
+
+## Plugins a instalar
+
+En **Settings → Community Plugins → Browse:**
+
+| Plugin | Uso |
+|--------|-----|
+| **Kanban** | Tablero visual de la migración |
+| **Templater** | Plantillas para reuniones y decisiones |
+| **Git** | Sincronización automática con Gitea |
+| **Dataview** | Consultar notas como base de datos |
+| **Calendar** | Vista de reuniones por fecha |
+
+---
+
+## Configuración del plugin Git
+
+En **Settings → Community Plugins → Git:**
+
+```
+Repository URL: http://git.v-encore-lab.com/jjminguez/PLANIFICACION_PROYECTOS
+Auto-pull interval: 10 minutos
+Auto-push interval: 10 minutos
+Auto-push on file change: ✅
+Commit message: vault: {{date}} {{numFiles}} files
+```
+
+---
+
+## Configuración del plugin Templater
+
+En **Settings → Templater:**
+
+```
+Template folder: templates/
+Trigger Templater on new file creation: ✅
+```
+
+Atajos de teclado recomendados:
+- `Ctrl+Shift+R` → Nueva reunión
+- `Ctrl+Shift+D` → Nueva decisión
+
+---
+
+## Convenciones de nomenclatura
+
+```
+Reuniones:   docs/reuniones/YYYY-MM-DD-tema.md
+Decisiones:  docs/decisiones/DEC-001-titulo.md
+Arquitectura: docs/arquitectura/tema.md
+```
+
+---
+
+## Integración con OpenCode y Engram
+
+OpenCode lee automáticamente todo lo que está en `docs/` gracias a:
+```json
+"instructions": ["docs/*.md"]
+```
+
+**Flujo de trabajo:**
+
+1. Escribes una reunión o decisión en Obsidian
+2. El plugin Git la sube a Gitea automáticamente
+3. En la próxima sesión de OpenCode el agente la lee
+4. Engram guarda las decisiones técnicas que toma el agente
+5. Todo queda sincronizado en el cloud de Engram
+
+---
+
+## Sincronización con Engram
+
+Después de añadir documentos importantes a Obsidian, fuerza el sync:
+
+```powershell
+engram sync --cloud --project planificacion_proyectos
+```
+
+---
+
+## Archivos ya creados
+
+| Archivo | Descripción |
+|---------|-------------|
+| `docs/decisiones/DEC-001-migracion-sourcesafe-github.md` | Primera decisión técnica del proyecto |
+| `kanban/migracion-sourcesafe-github.md` | Tablero Kanban de la migración |
+| `templates/reunion.md` | Plantilla para actas de reuniones |
+| `templates/decision.md` | Plantilla para decisiones técnicas |