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:

"instructions": ["docs/*.md"]

Flujo de trabajo:

Escribes una reunión o decisión en Obsidian
El plugin Git la sube a Gitea automáticamente
En la próxima sesión de OpenCode el agente la lee
Engram guarda las decisiones técnicas que toma el agente
Todo queda sincronizado en el cloud de Engram

Sincronización con Engram

Después de añadir documentos importantes a Obsidian, fuerza el sync:

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

3.0 KiB Raw Permalink Blame History