Self-Improving Agent (With Self-Reflection)

• Corriges frecuentemente los mismos errores del agente y quieres que esas correcciones se mantengan entre sesiones.
• Trabajas en proyectos o dominios recurrentes (código, escritura, comunicaciones) donde el estilo y las preferencias consistentes son importantes.
• Quieres un agente que audite su propio resultado después de tareas de varios pasos y registre automáticamente las lecciones aprendidas.
• El conocimiento debería acumularse con el tiempo — prefieres construir un perfil de preferencias dinámico en lugar de volver a explicar el contexto en cada sesión.

• Solo necesitas memoria para una única sesión o una tarea puntual — esta habilidad está diseñada para un aprendizaje persistente a largo plazo.
• Necesitas que el agente aprenda a partir de la observación pasiva o el silencio; esta habilidad solo registra correcciones explícitas y preferencias declaradas.
• Te encuentras en un entorno donde escribir archivos locales en ~/self-improving/ no está permitido o no es posible.

La memoria se divide en tres niveles: memory.md (HOT, ≤100 líneas, siempre cargado), archivos por proyecto y por dominio (WARM, cargados según coincidencia de contexto), y un archivo histórico (COLD, cargado mediante consulta explícita). Esto mantiene el conocimiento más relevante en el contexto sin superar los límites establecidos.

Los patrones utilizados 3 veces en 7 días se promueven automáticamente al almacenamiento EN CALIENTE. Los patrones sin uso decaen a TIBIO después de 30 días y se archivan en FRÍO después de 90 días. Nada se elimina sin confirmación explícita del usuario.

Después de completar tareas de múltiples pasos, recibir retroalimentación o corregir errores, el agente hace una pausa para evaluar: ¿el resultado cumplió con la intención?, ¿qué podría mejorar? y ¿se trata de un patrón repetible? Las lecciones se registran en un formato estructurado y se promueven siguiendo las mismas reglas que las correcciones del usuario.

El agente reconoce señales de corrección ("No, eso está mal", "Ya te lo dije antes…", "Deja de hacer X") y señales de preferencia ("Me gusta cuando…", "Siempre haz X") y las enruta automáticamente al nivel de memoria correcto. Las instrucciones de uso único o específicas del contexto se ignoran intencionalmente.

Los patrones específicos de proyectos se almacenan en projects/{name}.md, las preferencias globales en HOT, y los patrones de dominio (código, escritura) en domains/. Cuando los patrones entran en conflicto, la regla más específica y más reciente tiene prioridad — con una consulta al usuario si persiste la ambigüedad.

Cada acción procedente de la memoria cita su archivo y línea (por ejemplo, "Usando X (de projects/foo.md:12)"). Un resumen semanal de patrones aprendidos, degradados y archivados está disponible bajo demanda. La habilidad nunca almacena credenciales, datos de salud ni información de terceros, y nunca lee archivos fuera de ~/self-improving/.

Un desarrollador corrige las elecciones de formato o arquitectura del agente una vez. El agente registra la corrección en corrections.md, y tras la tercera recurrencia la promueve a domains/code.md. Las sesiones futuras aplican la regla automáticamente sin necesidad de recordatorios.

Para un proyecto de varias semanas, el agente almacena convenciones, decisiones de nomenclatura y preferencias de flujo de trabajo en projects/{name}.md. Cada sesión carga ese archivo de nivel intermedio cuando se menciona el proyecto, manteniendo al agente alineado de forma consistente con las reglas del proyecto.

Después de generar una funcionalidad de múltiples archivos o un documento extenso, el agente reflexiona sobre si el espaciado, la estructura o el tono podrían haber sido mejores, registra una lección aprendida y la aplica la próxima vez que se active una tarea similar, sin que el usuario tenga que señalar el mismo problema dos veces.

Un usuario indica "Prefiero respuestas concisas sin preámbulos." El agente registra esto como una preferencia HOT global y la cita en cada respuesta, asegurando que el estilo se mantenga en todas las conversaciones futuras sin necesidad de volver a indicar la preferencia.