# 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 |