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é esDónde residePor qué importa
Base de datos por proyectoUn archivo de base de datos dedicado para cada proyecto gestionadoContiene 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 globalUna base de datos compartida para el propio AITMContiene 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 TasksCarpetas de registros por proyectoEl 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 TasksCarpetas de Tasks por proyecto, una subcarpeta por número de TaskContiene los archivos de resultado, los metadatos y las capturas de pantalla de esa Task; alimenta la vista Results & Archive
WorktreesCheckouts temporales de Git, uno por Task en ejecuciónLa 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 conocimientoArchivos de documentación generados automáticamenteExportaciones 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.