Documentación / El agente
Memoria, skills y reglas
Cómo darle contexto duradero al agente con memoria del proyecto, skills, prompts, hooks y reglas, y cómo aprende de sus errores.
El agente no empieza de cero en cada conversación. Recuerda lo importante del proyecto, carga procedimientos según la tarea y sigue las reglas de tu equipo.
Todo se gestiona en el panel de proyecto, pestaña Agente, con las subpestañas Skills, Prompts, Hooks, Reglas e Instalar. Arriba eliges el alcance: Platform (el agente de Yuli) o Suscripciones (Claude Code, Kiro, Codex y Antigravity).
Memoria del proyecto
Lo que el agente debe recordar: instrucciones, decisiones, convenciones y datos del proyecto.
- Guardar: dile «recuerda que…» en el chat, o agrégalo a mano.
- Ver y editar: cabecera del chat → Más acciones → Memoria del proyecto.
- Dónde vive:
.ai/memory/, versionable con el proyecto.
| Grupo | Ejemplo |
|---|---|
| Instrucciones | «Responde siempre con ejemplos en Java 17.» |
| Decisiones | «Usamos arquitectura hexagonal en el módulo de pagos.» |
| Convenciones | «Los DTO terminan en Dto y viven en api/dto.» |
| Datos del proyecto | «El perfil local usa la base orders_dev.» |
Las entradas que llegan con el repositorio aparecen como «del repositorio — sin confirmar» y no se envían al modelo hasta que las confirmas. Así un repositorio ajeno no puede darle instrucciones al agente.
Memoria del equipo
La memoria compartida del equipo vive en .ai/team.json, versionada con el proyecto. Se ve en Opciones globales → Equipo.
Skills
Una skill es un procedimiento que el agente carga solo cuando la tarea lo necesita. Yuli trae 19 incluidas:
| Área | Skills |
|---|---|
| Código | Explicar código, Implementar funcionalidad, Refactor seguro, refactor-or-evolve |
| Pruebas | Escribir pruebas unitarias, Estrategia de pruebas |
| Calidad y revisión | Revisión de código, Revisión de seguridad, Revisión de integración |
| Diagnóstico | Depurar hasta la causa raíz, Arreglar errores de compilación, gradle-java-build |
| Diseño | Análisis de requerimientos, Diseño de arquitectura, ui-ux-design |
| Datos | Explorador de base de datos |
| Documentación | document-system (documentar el sistema bajo pedido), sdlc-documentation |
| Git | Mensaje de commit |
Las skills incluidas son de Solo lectura y se actualizan con la app. Para adaptar una, usa Duplicar para personalizar.
Skills propias
Crea las tuyas en la subpestaña Skills o impórtalas con Importar skills, prompts y hooks. Yuli acepta SKILL.md, PROMPT.md, comandos de Claude Code, .prompt.md de Copilot y hooks.json.
Tus skills, prompts y hooks se guardan en tu carpeta de usuario (en Windows, %APPDATA%\.yulicode\), así te acompañan en todos tus proyectos.
Cómo se combinan
En Configuración del agente:
| Modo | Qué usa |
|---|---|
| Automática | Solo lo de Yuli. |
| Personalizada | Solo lo tuyo. |
| Recomendada + las mías (por defecto) | Ambas. Si un nombre coincide, gana el tuyo. |
Prompts
Los prompts son las instrucciones base del agente: identidad, ciclo de vida de tareas grandes, líder del equipo, sub-agente… Yuli los trae calibrados. Puedes duplicarlos y ajustarlos.
Los prompts internos están en inglés para mayor precisión y menos tokens. La respuesta sale siempre en el idioma de quien escribe.
Hooks
Un hook intercepta una acción del agente: por ejemplo, formatear lo modificado o validar una propuesta antes de aplicarla. Los scripts son Node.js, reciben el evento en JSON y un código de salida distinto de cero bloquea la acción. El motivo del bloqueo llega al agente para que ajuste su plan.
| Evento | Cuándo |
|---|---|
| Antes de usar una herramienta | Antes de cada herramienta. |
| Después de usar una herramienta | Después de cada herramienta. |
| Al terminar una propuesta | Cuando el agente termina de proponer un cambio. |
| Antes de autorizar | Antes de que apruebes. |
| Después de aplicar cambios | Cuando el cambio llegó al disco. |
Yuli incluye hooks listos: Bloquear comandos peligrosos, No leer secretos, Proteger archivos sensibles, Sin secretos en el código, Sin marcadores de conflicto y Sin archivos gigantes.
Reglas del proyecto
Las reglas son instrucciones que el agente sigue siempre en ese proyecto.
| Archivo | Alcance |
|---|---|
.agentrules, yuli.md o .cursorrules en la raíz |
Todo el proyecto. |
.agentrules en una subcarpeta |
Esa carpeta. Gana el archivo más cercano. |
.ai/rules/*.md |
Reglas del equipo. |
En la subpestaña Reglas: + Crear .agentrules, Reglas recomendadas e Importar paquete (.zip).
Reglas aprendidas
Yuli aprende de los errores repetidos. Cuando un mismo hallazgo aparece 3 veces o más en al menos 2 tareas dentro de 30 días, se convierte en una regla en .ai/rules/learned.md.
Revísalas en el Centro de Gobierno → Agentes → Aprendizaje. Puedes rechazar una candidata; solo se vuelve a proponer si su evidencia se duplica.
Para tu agente de suscripción
En el alcance Suscripciones, cada agente tiene su sección con el archivo de reglas que Yuli le entrega, su estado y «Lo que Yuli le entrega»: las reglas de la sesión y cada skill de Yuli con su costo en tokens.