El problema de la documentación desactualizada
¿Cuántas veces la documentación de un sistema quedó obsoleta a los pocos días de publicarse? Los equipos de desarrollo avanzan rápido, agregan funcionalidades, mejoran flujos... pero el blog o la documentación pública queda congelada en el tiempo.
En Hitofusion encontramos una solución elegante: un skill que pregunta automáticamente si queremos actualizar el blog cada vez que creamos o modificamos algo.
¿Qué es el Skill de Sincronización?
Es una capacidad integrada en nuestros agentes que detecta cuando se realizan cambios importantes y ofrece mantener el blog actualizado. No es automático ni invasivo: siempre pregunta, siempre muestra un preview, siempre espera confirmación.
Funciona para:
- ✨ Creación de nuevos agentes
- 🆕 Creación de nuevos skills (habilidades)
- 🔄 Modificaciones a skills existentes
- 📝 Cualquier cambio que valga la pena documentar
¿Cómo funciona?
El flujo es simple y transparente:
Se crea/modifica un skill
│
▼
┌─────────────────────────────────┐
│ "¿Querés actualizar el blog?" │
│ │
│ 1. Actualizar artículo existente│
│ 2. Crear artículo nuevo │
│ 3. No hacer nada │
└─────────────────────────────────┘
│
▼ (si elige 1 o 2)
┌─────────────────────────────────┐
│ "¿Qué querés destacar?" │
└─────────────────────────────────┘
│
▼
┌─────────────────────────────────┐
│ 📄 Preview del contenido │
│ │
│ "¿Lo publico, ajusto, o │
│ cancelamos?" │
└─────────────────────────────────┘
│
▼ (si confirma)
✅ Publicado
Paso a paso detallado
📋 Paso 1: Detección del cambio
El agente detecta que acaba de crear o modificar algo significativo: un nuevo skill, un cambio en el flujo de trabajo, una nueva regla importante.
En ese momento, ofrece la posibilidad de documentarlo. No obliga, no asume: pregunta.
🎯 Paso 2: Elegir la acción
El usuario decide:
- Actualizar existente: Agrega una sección de "Actualización" al final de un artículo ya publicado
- Crear nuevo: Genera un artículo completo desde cero
- No hacer nada: A veces un cambio es interno y no necesita documentación pública
💬 Paso 3: Contexto humano
El agente pregunta qué destacar. Esto es clave: la IA extrae la información técnica, pero el humano aporta el contexto de negocio.
"¿Qué es lo importante de este cambio para nuestros clientes?"
🔒 Paso 4: Filtrado de seguridad
Antes de mostrar el preview, el sistema filtra automáticamente:
- ❌ Credenciales y API keys
- ❌ IDs internos de base de datos
- ❌ Rutas de servidor
- ❌ Información de clientes reales
- ❌ Cualquier dato que no debería ser público
Si no debería estar en un folleto, no va en el blog.
👁️ Paso 5: Preview y confirmación
El usuario ve exactamente qué se va a publicar. Puede:
- ✅ Aprobar: Se publica tal cual
- ✏️ Ajustar: Pedir cambios y ver nuevo preview
- ❌ Cancelar: No se publica nada
- 💾 Guardar borrador: Para revisar después
✅ Paso 6: Publicación y registro
Si el usuario aprueba, el contenido se publica y queda registrado internamente qué artículo corresponde a qué agente o skill.
Esto permite que futuras actualizaciones sepan exactamente dónde agregar la información.
¿Por qué funciona así?
| Principio | Implementación |
|---|---|
| Humano en el centro | Siempre pregunta, nunca publica solo |
| Transparencia | Preview completo antes de publicar |
| Seguridad | Filtrado automático de información sensible |
| Trazabilidad | Registro de qué artículos corresponden a qué componentes |
El balance perfecto
Este skill representa nuestra filosofía: la IA potencia, el humano decide.
La inteligencia artificial se encarga de:
- Detectar cuándo hay algo nuevo que documentar
- Extraer la información relevante
- Generar contenido bien estructurado
- Filtrar datos sensibles
El humano se encarga de:
- Decidir si vale la pena publicar
- Aportar contexto de negocio
- Revisar y aprobar el contenido final
El resultado: documentación que se mantiene actualizada sin esfuerzo manual, pero con supervisión humana en cada paso.
¿Querés saber más sobre cómo construimos herramientas que combinan IA con control humano?
📧 info@hitofusion.com
🌐 www.hitofusion.com