AITM conserva una cantidad considerable de estado en local para poder funcionar de forma fiable y recordar lo que ha aprendido sobre los proyectos. Este es un mapa en lenguaje sencillo de lo que se almacena y por qué importa.
Qué datos almacena AITM
El mapa de datos
| Qué es | Dónde reside | Por qué importa |
|---|---|---|
| Base de datos por proyecto | Un archivo de base de datos dedicado para cada proyecto gestionado | Contiene los Contracts y el historial de Tasks de ese proyecto; se mantiene separada por proyecto, de modo que los datos de un proyecto nunca se mezclan con los de otro |
| Base de datos global | Una base de datos compartida para el propio AITM | Contiene los ajustes de toda la aplicación, las pistas, el registro de variables y otra configuración común a todos los proyectos |
| Registros de ejecución de Tasks | Carpetas de registros por proyecto | El registro detallado, línea a línea, de lo ocurrido mientras se ejecutaba una Task; útil para depurar una Task que se comportó de forma inesperada |
| Carpetas de datos de Tasks | Carpetas de Tasks por proyecto, una subcarpeta por número de Task | Contiene los archivos de resultado, los metadatos y las capturas de pantalla de esa Task; alimenta la vista Results & Archive |
| Worktrees | Checkouts temporales de Git, uno por Task en ejecución | La copia de trabajo aislada que los Agents de una Task editan realmente; se crea al iniciar la Task y se elimina automáticamente una vez fusionada; véase The Pipeline |
| Documentos del grafo de conocimiento | Archivos de documentación generados automáticamente | Exportaciones legibles de los Contracts y del conocimiento de dependencias descritos en Knowledge Sharing; se regeneran automáticamente tras cada fusión |
Por qué importa el estado local y persistente
Nada de esto es contabilidad accesoria: es el mecanismo que hay detrás de todo lo tratado en el resto de esta guía:
- La base de datos por proyecto es lo que permite que los Contracts, el historial de Tasks y las consultas de precedentes sobrevivan entre sesiones y entre Tasks, en lugar de reiniciarse cada vez que se cierra la aplicación.
- Las carpetas de datos de Tasks son lo que convierte el Archive en un rastro de auditoría realmente útil y no en una simple lista de títulos: cada resultado, captura de pantalla y campo de metadatos que se ve ahí se lee directamente de estas carpetas.
- Los Worktrees son el fundamento mecánico de la garantía de aislamiento descrita en The Pipeline: como cada Task obtiene un checkout del sistema de archivos realmente separado, el trabajo en curso nunca puede filtrarse por accidente a la rama principal.
- Los documentos del grafo de conocimiento son lo que transforma "la IA recordó algo por casualidad" en "el proyecto tiene un registro duradero e inspeccionable de su propio comportamiento"; véase Knowledge Sharing.
Cómo se protegen las copias de seguridad de la base de datos frente al crecimiento sin límite y la pérdida silenciosa de datos
Las copias de seguridad de la base de datos necesitan protección propia; de lo contrario, podrían llenar el disco o desaparecer discretamente justo cuando más se necesitan. AITM las mantiene bajo una política de retención escalonada y vigila su tamaño en busca de anomalías:
- Retención escalonada — en lugar de un único corte plano que elimina de golpe todas las copias de la base de datos con más de N días de antigüedad (lo que podría borrar todas las copias de una sola vez si se omitiera una ejecución diaria), AITM las va reduciendo gradualmente: conserva un puñado de las copias diarias más recientes, algunas copias más antiguas espaciadas varios días y una copia semanal todavía más antigua. El resultado es un conjunto pequeño pero bien distribuido de puntos de recuperación, sin permitir que el almacenamiento de copias crezca sin límite.
- Alertas de anomalía de tamaño — antes de que se realice cualquier poda, AITM compara el tamaño de la copia de la base de datos de hoy con el de ayer. Una caída significativa (posible pérdida de datos) o un crecimiento inesperado significativo desencadena una alerta por correo electrónico con el tamaño anterior, el tamaño actual y el porcentaje de cambio, de modo que la anomalía se conozca antes de que una copia antigua y sana se sobrescriba o se pode.
- Poda verificada de copias incrementales (delta) — las copias de recuperación incrementales con más de 3 días se podan de forma continua, pero solo después de verificar que la copia más reciente que se conserva en esa cadena está intacta. Si la verificación falla, la poda se detiene para esa base de datos y no se elimina nada más antiguo; así, una copia más reciente corrupta nunca puede provocar en cascada la eliminación de las copias antiguas, todavía buenas, que hay debajo.
Consejos
- El código del proyecto nunca se modifica fuera de un Worktree: la copia de trabajo normal permanece intacta mientras se ejecuta una Task.
- No se envía nada fuera de la máquina salvo las llamadas al proveedor de IA configurado.
- Este conocimiento local y persistente es lo que permite que AITM mejore con el tiempo en el proyecto en lugar de empezar de cero en cada Task.