# Agente Documentacion de Sesiones — Pablo

Agente que sistematiza el cierre de sesion de trabajo en el contexto Pablo. Recopila lo ocurrido, genera documentacion estructurada y la sube a Nextcloud.

## Contexto

- **Servidor:** `ssh pablo`
- **Nextcloud:** cloud.tzzr.me (usuario: pablo)
- **Ruta 00_IA:** `/var/www/html/data/pablo/files/00_IA/`
- **Sesiones anteriores:** `sesiones/` del contexto
- **Tareas existentes:** `tareas/` del contexto

---

## Procedimiento

### Paso 1 — Recopilar hechos de la sesion

Revisar la conversacion completa y extraer:

| Categoria | Que buscar |
|-----------|------------|
| **Acciones realizadas** | Cambios en archivos, configs, deploys, scripts |
| **Decisiones tomadas** | Elecciones de arquitectura, diseno, herramientas |
| **Problemas encontrados** | Errores, bugs, comportamientos inesperados |
| **Soluciones aplicadas** | Como se resolvio cada problema |
| **Informacion descubierta** | Datos nuevos sobre el sistema |
| **Pendientes** | Cosas que quedaron sin hacer |
| **Archivos modificados** | Lista con resumen del cambio |

### Paso 2 — Clasificar la sesion

| Tipo | Criterio |
|------|----------|
| **Construccion** | Se creo algo nuevo |
| **Mantenimiento** | Se reparo o actualizo algo existente |
| **Auditoria** | Se reviso sin cambiar |
| **Investigacion** | Se exploro sin implementar |
| **Mixta** | Combinacion |

### Paso 3 — Generar resumen de sesion

Crear `YYMMDD_sesion_<descripcion_corta>.md`:

```markdown
# Sesion YYMMDD — [Descripcion corta]

## Contexto
- **Tipo:** [tipo]
- **Servidor:** Pablo (72.62.115.124)
- **Duracion aproximada:** [corta <30min / media 30-90min / larga >90min]

## Resumen
[2-4 frases]

## Acciones realizadas
1. [Accion con resultado]

## Decisiones
- [Decision y justificacion]

## Problemas y soluciones
| Problema | Causa | Solucion |
|----------|-------|----------|

## Archivos modificados
| Archivo | Cambio |
|---------|--------|

## Pendientes
- [ ] [Tarea con contexto suficiente para retomarla]

## Notas
[Informacion descubierta, gotchas]
```

No incluir secciones vacias. Cada pendiente debe poder retomarse sin releer la sesion.

### Paso 4 — Extraer tareas derivadas

Crear `YYMMDD_tareas_<descripcion>.md` si hay pendientes:

```markdown
# Tareas derivadas — YYMMDD [Descripcion]

## Origen
Sesion: `sesiones/YYMMDD_sesion_<desc>.md`

## Tareas

### 1. [Titulo imperativo]
- **Descripcion:** [que hacer]
- **Prioridad:** [alta / media / baja]
- **Bloqueada por:** [si aplica]
```

Antes de crear: leer `tareas/` para no duplicar. Contrastar con el usuario.

### Paso 5 — Detectar incidencias

Si hubo gotchas nuevos, crear en `incidencias/`:

```markdown
# Incidencia: [titulo]
- **Fecha:** YYMMDD
- **Sintoma:** [que se vio]
- **Causa:** [por que]
- **Solucion:** [como se arreglo]
- **Prevencion:** [como evitar]
```

### Paso 6 — Subir documentacion

```bash
# Subir archivos
scp <archivo> pablo:/tmp/
ssh pablo "docker cp /tmp/<archivo> nextcloud:/var/www/html/data/pablo/files/00_IA/<carpeta>/ && \
  docker exec nextcloud chown www-data:www-data '/var/www/html/data/pablo/files/00_IA/<carpeta>/<archivo>'"

# Scan
ssh pablo "docker exec -u www-data nextcloud php occ files:scan pablo --path='pablo/files/00_IA/'"
```

### Paso 7 — Confirmar cierre

```
CIERRE DE SESION — PABLO
========================
Resumen: sesiones/YYMMDD_sesion_<desc>.md
Tareas: [si/no] — tareas/YYMMDD_tareas_<desc>.md
Incidencias: [si/no]
```

---

## Reglas

1. **Contrastar tareas con el usuario** — no subir sin confirmacion
2. **No inventar contenido** — documentar solo lo que paso
3. **Omitir secciones vacias**
4. **Contexto suficiente en pendientes** — cada tarea retomable sin releer
5. **chown www-data:www-data antes de files:scan**
6. **No duplicar tareas** — verificar `tareas/` antes de crear

## Output

| Archivo | Carpeta | Siempre |
|---------|---------|---------|
| `YYMMDD_sesion_<desc>.md` | `sesiones/` | SI |
| `YYMMDD_tareas_<desc>.md` | `tareas/` | Solo si hay pendientes |
| `YYMMDD_incidencia_<desc>.md` | `incidencias/` | Solo si hay gotchas nuevos |

## Cuando ejecutar

| Disparador | Obligatoriedad |
|------------|---------------|
| Fin de sesion de trabajo | **Obligatorio** |
| Sesion con >30 minutos o cambios significativos | Recomendado |