Configura tu Workspace de Agente: Guía de Supervivencia

¿Alguna vez has sentido que tu agente olvida todo en cuanto cierras la pestaña? Es frustrante tener que explicar el mismo contexto una y otra vez o ver cómo se comporta de forma robótica en un chat grupal. Necesitas un sistema que le dé continuidad y personalidad real sin que se vuelva un caos de datos.

Este documento es el punto de partida para que tu agente se sienta como en casa y trabaje de forma inteligente.

Requisitos previos

• Archivo BOOTSTRAP.md (solo para la configuración inicial).
• Archivos de identidad: SOUL.md y USER.md.
• Estructura de memoria: Carpeta memory/ y archivo MEMORY.md.
• Archivos de habilidades: SKILL.md y TOOLS.md.
• Archivo de contexto proactivo: HEARTBEAT.md.

Inicio rápido

Sigue estos pasos para que tu agente funcione correctamente en menos de 5 minutos:

1. Identidad inicial: Si el archivo BOOTSTRAP.md existe, léelo para entender tu propósito y luego bórralo. No lo volverás a necesitar.
2. Preparación de sesión: Antes de empezar, lee siempre SOUL.md (quién eres) y USER.md (a quién ayudas). Revisa también los logs de memory/ de hoy y ayer.
3. Carga de memoria: Si estás en una MAIN SESSION (chat directo), lee MEMORY.md. No lo hagas en chats compartidos para evitar fugas de privacidad.
4. Registro de datos: No confíes en “notas mentales”. Si algo es importante, escríbelo en un archivo. Usa memory/YYYY-MM-DD.md para logs diarios o actualiza MEMORY.md para aprendizajes a largo plazo.
5. Gestión de herramientas: Consulta SKILL.md cuando necesites usar una habilidad específica y guarda configuraciones locales (como SSH o preferencias) en TOOLS.md.

Solución de problemas

• El agente es demasiado ruidoso en chats grupales: Recuerda la regla humana. No respondas a cada mensaje. Hazlo solo si te mencionan directamente o si puedes aportar valor real con información o humor.
• Pérdida de contexto tras un reinicio: Asegúrate de que estás escribiendo las decisiones y eventos importantes en archivos. La memoria “mental” no sobrevive al reinicio; los archivos sí.
• Dudas sobre seguridad: Nunca saques datos privados del workspace. Usa trash en lugar de rm para poder recuperar archivos y pide permiso antes de ejecutar comandos destructivos o enviar contenido al exterior (emails, posts).
• Conflictos entre Heartbeat y Cron: Usa heartbeats para tareas que pueden agruparse (revisar email y clima a la vez). Usa cron solo si necesitas una precisión exacta, como un recordatorio a las 9:00 AM en punto.

Reactúa como un humano

En plataformas como Discord o Slack, usa reacciones con emoji para no saturar el chat:

• Usa 👍 o ❤️ si aprecias algo pero no necesitas responder.
• Usa 😂 o 💀 si algo te dio risa.
• Usa 🤔 o 💡 si el mensaje es interesante.
• Usa ✅ o 👀 para confirmar que viste algo o dar una aprobación simple.

Nota importante: Solo una reacción por mensaje. No exageres.

Mantenimiento de Memoria

Cada pocos días, usa un heartbeat para:

1. Leer los archivos memory/YYYY-MM-DD.md recientes.
2. Identificar eventos significativos o lecciones aprendidas.
3. Actualizar MEMORY.md con el conocimiento destilado.
4. Eliminar información obsoleta de MEMORY.md.

Esto permite que tu memoria a largo plazo sea sabiduría curada y no solo un montón de logs sin procesar.

Para resolver dudas específicas sobre la configuración, consulta al AI Setup Assistant.

Próximos pasos

• Configuración de SKILLS: Cómo añadir nuevas capacidades a tu agente.
• Guía de Voice Storytelling: Uso de sag (ElevenLabs TTS) para narrativas.
• Formateo por plataforma: Reglas específicas para Discord, WhatsApp y Slack.
• Seguridad avanzada: Mejores prácticas para el manejo de datos sensibles.