100 Consejos para Construir un Agente de IA Personal: Del Prototipo en la Nube a la Producción

Un desarrollador pasó seis semanas construyendo desde cero un agente de IA personal — no un envoltorio de chatbot, sino un asistente persistente que gestiona tareas, rastrea acuerdos, lee correos electrónicos, analiza datos de negocio y detecta proactivamente elementos omitidos. El proyecto comenzó en la nube (Claude Projects con archivos de memoria compartidos, ventanas de contexto amplias, habilidades personalizadas) y luego migró a Claude Code dentro de VS Code, lo que permitió acceso a archivos locales, seguimiento con git, hooks de shell y tareas programadas sin interfaz gráfica. La migración obligó a resolver problemas que no sabían que existían. Estos 100 consejos son el resultado destilado, con el uso máximo de Claude 20x pasando de 100% desarrollo / 0% mundo real inicialmente a 20% / 80% después de seis semanas.

Fundación e Identidad (1–8)

• Escribe una Constitución, no un prompt de sistema. Un prompt de sistema lista comandos; una Constitución explica reglas. Cuando el agente encuentra un caso límite que ninguna regla cubre, razona a partir de la Constitución en lugar de adivinar. Esto separa a los agentes que se degradan con elegancia de aquellos que alucinan con confianza.
• Dale a tu agente un nombre, una voz y un rol. Ejemplo: "Siempre en primera persona. Directo. Datos antes que emociones. Sin frases de relleno. Sin resúmenes finales." Esto elimina cientos de microdecisiones por sesión y crea consistencia para la auditoría.
• Separa las reglas estrictas de las pautas de comportamiento. Reglas estrictas en una sección dedicada — nunca anuladas. Las pautas de comportamiento se adaptan. Mezclarlas hace que ambas pierdan significado.
• Define a tu principal a fondo. ¿A quién sirve el agente? ¿Qué les frustra? ¿Cómo deciden? Ejemplo: "Decide con datos, no con corazonadas. Quiere alternativas con puntuación, no una sola recomendación. Odia las respuestas vagas."
• Construye un Mapa de Capacidades y un Mapa de Componentes por separado. Mapa de Capacidades: qué puede hacer el agente (habilidades, integraciones, automatizaciones). Mapa de Componentes: cómo está construido (archivos, conexiones). Mezclarlos crea un documento inútil después del tercer mes.
• Define lo que el agente NO es. "No es un resumidor. No es una máquina de decir sí. No es un motor de búsqueda. No espera a que le pregunten." Las definiciones negativas previenen la deriva hacia una amabilidad genérica.
• Construye un modelo mental de PENSAR vs. HACER. Cuando hay incertidumbre → PENSAR (analizar, redactar, preparar). Cuando hay claridad → HACER (ejecutar, escribir, enviar). Nunca congelarse. Por defecto, actuar al nivel de menor riesgo, mostrar el resultado.
• Versiona tu archivo de identidad en git. git blame sobre la configuración ayuda a depurar regresiones de comportamiento que se rastrean hasta ediciones específicas.

Sistema de Memoria (9–18)

• Usa archivos markdown planos para la memoria — no una base de datos. Legibles, buscables con grep, rastreables con git, cargables directamente por el agente. Sin capa de infraestructura.
• Separa la memoria por dominio, no por fecha. Archivos como entidades_personas.md, entidades_empresas.md, entidades_acuerdos.md, hipotesis.md, cola_tareas.md. Un archivo = un dominio. Los volcados cronológicos se vuelven imposibles de buscar después de la segunda semana.
• Construye un archivo índice MEMORIA.md. Un único índice que liste cada archivo de memoria con una descripción de una línea. El agente carga primero el índice, luego extrae archivos específicos bajo demanda. Mantiene predecible el uso de la ventana de contexto.
• Distingue "caché" de "fuente de verdad" — explícitamente. Marca cada archivo de caché con una marca de tiempo ultima_sincronizacion:. Por ejemplo, acuerdos.md local es un caché del CRM; el CRM es la SSOT.