Actualización docs: sync automático y nuevos proyectos en cloud
This commit is contained in:
minguezsanzjuanjose
137
obsidian/01-configuracion-completa.md
Normal file
137
obsidian/01-configuracion-completa.md
Normal file
@@ -0,0 +1,137 @@
|
||||
# Obsidian — Configuración completa del sistema
|
||||
|
||||
Resumen de toda la configuración de Obsidian integrada con Engram, OpenCode y Gitea.
|
||||
|
||||
---
|
||||
|
||||
## Vault
|
||||
|
||||
- **Ruta local:** `C:\Users\juanm\Documents\GitHub\PLANIFICACION_PROYECTOS`
|
||||
- **Nombre:** PLANIFICACION PROYECTOS
|
||||
- **Repositorio Gitea:** `https://git.v-encore-lab.com/jjminguez/PLANIFICACION_PROYECTOS`
|
||||
|
||||
---
|
||||
|
||||
## Estructura de carpetas
|
||||
|
||||
```
|
||||
PLANIFICACION_PROYECTOS/
|
||||
├── docs/
|
||||
│ ├── arquitectura/ → Diagramas y documentación técnica
|
||||
│ ├── decisiones/ → DEC-001, DEC-002... decisiones técnicas
|
||||
│ └── reuniones/ → Actas con formato YYYY-MM-DD-tema.md
|
||||
├── ejemplos/
|
||||
├── kanban/ → Tableros Kanban del proyecto
|
||||
├── templates/
|
||||
│ ├── decision.md → Plantilla para decisiones técnicas
|
||||
│ └── reunion.md → Plantilla para actas de reuniones
|
||||
├── AGENTS.md
|
||||
├── opencode.json
|
||||
└── README.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Plugins instalados
|
||||
|
||||
| Plugin | Uso | Configuración |
|
||||
|--------|-----|---------------|
|
||||
| **Templater** | Plantillas automáticas | Template folder: `templates` |
|
||||
| **Git** | Sync automático con Gitea | Auto commit cada 10 min |
|
||||
| **Kanban** | Tablero visual de la migración | — |
|
||||
| **Dataview** | Consultar notas como BD | — |
|
||||
| **Calendar** | Vista de reuniones por fecha | — |
|
||||
|
||||
---
|
||||
|
||||
## Configuración del plugin Git
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| Auto commit-and-sync interval | `10` minutos |
|
||||
| Auto pull interval | `10` minutos |
|
||||
| Commit message | `vault: {{date}} {{numFiles}} files` |
|
||||
| Pull updates on startup | ✅ |
|
||||
|
||||
---
|
||||
|
||||
## Configuración del plugin Templater
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| Template folder location | `templates` |
|
||||
|
||||
---
|
||||
|
||||
## Cómo crear una reunión
|
||||
|
||||
1. `Ctrl+P` → `Templater: Create new note from template`
|
||||
2. Selecciona `reunion`
|
||||
3. Guarda en `docs/reuniones/YYYY-MM-DD-tema`
|
||||
4. Rellena los campos y guarda
|
||||
5. Se sube automáticamente a Gitea en 10 minutos
|
||||
6. O fuerza el push con `Ctrl+P` → `Git: Commit-and-sync`
|
||||
|
||||
---
|
||||
|
||||
## Cómo crear una decisión técnica
|
||||
|
||||
1. `Ctrl+P` → `Templater: Create new note from template`
|
||||
2. Selecciona `decision`
|
||||
3. Guarda en `docs/decisiones/DEC-XXX-titulo`
|
||||
4. Rellena el contexto, la decisión y las alternativas
|
||||
5. Sincroniza con Engram:
|
||||
|
||||
```powershell
|
||||
engram sync --cloud --project planificacion_proyectos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Flujo de trabajo completo
|
||||
|
||||
```
|
||||
Tú escribes en Obsidian
|
||||
↓
|
||||
Plugin Git sube a Gitea (cada 10 min o manual)
|
||||
↓
|
||||
OpenCode lee docs/*.md automáticamente en cada sesión
|
||||
↓
|
||||
Agente actúa con ese contexto
|
||||
↓
|
||||
Engram guarda las decisiones técnicas del agente
|
||||
↓
|
||||
Próxima sesión: el agente recuerda todo
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Forzar sync manual en cualquier momento
|
||||
|
||||
Desde Obsidian:
|
||||
```
|
||||
Ctrl+P → Git: Commit-and-sync
|
||||
```
|
||||
|
||||
Desde PowerShell:
|
||||
```powershell
|
||||
engram sync --cloud --project planificacion_proyectos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Integración con OpenCode
|
||||
|
||||
El archivo `opencode.json` tiene configurado:
|
||||
```json
|
||||
"instructions": ["docs/*.md"]
|
||||
```
|
||||
|
||||
Esto hace que OpenCode lea automáticamente todo lo que escribas en `docs/` al iniciar cada sesión.
|
||||
|
||||
---
|
||||
|
||||
## Dashboard de Engram
|
||||
|
||||
- URL: `https://engram.v-encore-lab.com/dashboard/`
|
||||
- Login: usar el `ENGRAM_CLOUD_TOKEN` configurado en Windows
|
||||
123
obsidian/02-instalacion-y-setup.md
Normal file
123
obsidian/02-instalacion-y-setup.md
Normal file
@@ -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 |
|
||||
Reference in New Issue
Block a user