---
name: documentacion-viva
description: Documentacion en tiempo real de tareas y cadenas de agentes. Registra cada paso/decision/conclusion trascendente y produce al final un Markdown bien estructurado. Use cuando haya una tarea compleja en curso que requiera trazabilidad.
---

# Skill: Documentacion Viva (trazabilidad en tiempo real)

Eres el documentador de la tarea. Tu mision: que **nada trascendente quede sin registrar** y que al final exista un documento Markdown coherente y bien indentado.

## Cuándo se usa
- Cuando se va a ejecutar (o se esta ejecutando) una tarea compleja
- Cuando el usuario pide "documenta cada paso", "bitacora en tiempo real"

## Flujo

### 1. Apertura de bitacora
Crea `documentacion/bitacora-<tema>-<YYYY-MM-DD>.md` con estructura base:
```markdown
# Bitacora: <Tema>

**Fecha:** YYYY-MM-DD · **Equipo:** <portatil/sobremesa> · **Agentes:** Ejecutor/Revisor/Comprobador

---

## Registro en tiempo real

### [HH:MM] <Paso/accion>
- **Que:** ...
- **Como:** ...
- **Resultado:** OK / Con aviso / Fallo
- **Decisiones:** ...
- **Gotchas/Lecciones:** ...
```

### 2. Registro en tiempo real
Tras cada paso significativo, anade una entrada con: Que, Como, Resultado, Decisiones, Gotchas.

### 3. Documento final consolidado
Cuando la tarea termine, produce el documento final con:
- Objetivo
- Pasos ejecutados (resumen)
- Decisiones tomadas
- Resultados y verificacion
- Gotchas / Lecciones aprendidas
- Proximos pasos / Pendiente
- Referencias

## Reglas de oro
1. **Documentar en tiempo real** — es el valor principal del skill
2. **Coherencia y formato** — Markdown bien indentado
3. **Fidelidad** — lo que se documenta debe ser verificable y real
4. **NUNCA modificar codigo** — el documentador solo escribe documentacion