Lo que ve el agente
Cómo los hooks de ciclo de vida aportan contexto antes de las ediciones, durante los prompts y al final de las tareas.
Los agentes de código trabajan mejor cuando reciben las restricciones relevantes en lugar de todo el historial del repositorio sin filtrar. Mios usa hooks de ciclo de vida para dar memoria acotada en los momentos clave de una sesión.
Resumen de los hooks de ciclo de vida
Cuando ejecutas el instalador automático, este registra hooks concretos que se ejecutan junto a Claude Code o Codex:
Session start --> Prompt submit --> Pre-tool use (Edit) --> Stop (End of task)
(Workspace) (Task dossier) (Decisions check) (Propose choices)
1. Al enviar el prompt (UserPromptSubmit)
Cuando envías un prompt a tu agente, el hook prompt-context se ejecuta antes de que el modelo genere su plan.
El hook examina el prompt, consulta a Mios las decisiones de arquitectura relacionadas e inyecta un dosier de tarea conciso. El agente recibe:
- Las decisiones centrales del proyecto relevantes para el prompt.
- Los requisitos técnicos y restricciones vigentes.
- Enlaces a las discusiones de origen pertinentes.
Así el modelo evita proponer patrones que el equipo ha rechazado explícitamente.
2. Contexto antes de las ediciones (PreToolUse)
Cuando un agente intenta editar o escribir archivos con herramientas como Edit, Write, MultiEdit o Bash, el hook pre-edit intercepta la acción:
- Resuelve las rutas de los archivos de destino al proyecto que corresponde.
- Comprueba si la edición propuesta entra en conflicto con las decisiones adoptadas del proyecto.
- Si detecta un conflicto, devuelve una indicación al agente antes de que el archivo se modifique en disco.
Además, el hook mcp-guard verifica los límites del proyecto si el agente cambia de directorio durante una sesión, y evita filtraciones accidentales entre bases de código distintas.
3. Propuestas al final de la tarea (Stop)
Cuando un agente termina su trabajo y se detiene la ejecución, el hook stop hace un análisis final:
- Examina el git diff y las acciones realizadas durante la sesión.
- Si el agente tomó nuevas decisiones de arquitectura o estableció una convención nueva, el hook las formatea como decisiones propuestas.
- Las propuestas se envían directamente a la cola de revisión de Mios («Pendiente de ti») en https://app.mios-ai.com.
Un compañero puede entonces revisar, editar o adoptar esas propuestas, y así conservar para futuras sesiones la memoria del trabajo del agente.