123 lines
3.0 KiB
Markdown
123 lines
3.0 KiB
Markdown
# 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 | |