Referencia rápida de los términos utilizados en toda esta guía, junto con respuestas a preguntas frecuentes.
Glosario y preguntas frecuentes
Glosario
| Término | Definición |
|---|---|
| Agent | El "trabajador" de IA que ejecuta un paso de la Pipeline, configurado con un proveedor y un modelo concretos. Véase Settings. |
| Archive | El registro con capacidad de búsqueda de cada Task completada, con todo el detalle del resultado. Una Task archivada puede devolverse a la cola con Restore. Véase Reading Results & Archive. |
| Auto-merge | La opción de Task autoMergeDev, que fusiona automáticamente en dev una Task terminada y probada. Véase Creating a Task. |
| Branch / Worktree | La rama de Git aislada y la carpeta de trabajo separada que se crean para cada Task, de modo que no pueda afectar a otro trabajo. Véase The Pipeline. |
| Brainstorm | El panel para la exploración abierta y la planificación con la IA, sin editar código. Véase Brainstorm. |
| Chat | El panel de conversación por proyecto para preguntas y debates rápidos con conocimiento de los Contracts. Véase Chat. |
| Contract | Una ficha de datos guardada que describe cómo se comporta una parte concreta del proyecto, mantenida sincronizada de forma automática. Véase Knowledge Sharing. |
| Dashboard | La vista principal del espacio de trabajo de AITM, con las pestañas de proyecto, las tarjetas y la cola de Tasks. |
| Dev Panel (AITM Dev Panel) | Una barra de herramientas JS inyectable (aitm-dev-panel.js) servida por el servidor de AITM que superpone los elementos de interfaz etiquetados, muestra un contador de eventos en vivo y un inspector, e informa a AITM de las interacciones con el DOM para que pueda construir y mantener el mapa de elementos DOM del proyecto. Véase DOM map + Dev Panel. |
| Rama dev | La rama predeterminada / de integración en la que se fusiona cada Task de la Pipeline. Véase Merging, Post-Merge Fixes & Scope Gate. |
| DOM Explorer | El registro de los elementos de interfaz reales de un proyecto y de qué desencadena qué, para proyectos con frontend. Véase Variable Explorer & IntelliSense. |
| E2E (End-to-End) | Pruebas automáticas que ejercitan la aplicación real en ejecución en un navegador, como lo haría una persona usuaria. Véase Testing. |
| Hint | Una regla breve y reutilizable que la IA aplica automáticamente en Tasks futuras, sin necesidad de repetirla. Véase Knowledge Sharing. |
| Rama de integración (defaultBranch) | El ajuste por proyecto que indica en qué rama se fusionan las Tasks del proyecto (por defecto dev); editable en los ajustes del proyecto con una comprobación "Verify remote". Véase Merging, Post-Merge Fixes & Scope Gate. |
| Knowledge Graph | El mapa interconectado de las variables, los Contracts, los elementos de interfaz y la documentación de un proyecto. Véase Knowledge Sharing. |
| Slot de licencia | Un slot de proyecto: la licencia indica cuántos proyectos puede gestionar AITM. No limita cuántas Tasks se ejecutan a la vez; eso corresponde al ajuste independiente de Pipeline Max concurrently running tasks. Véase Licensing & Project Slots. |
| Lite mode | Una opción de Task que omite el paso de planificación Architect cuando el modelo de programación es lo bastante potente. Véase Creating a Task. |
| Rama main | La rama estable de versiones, actualizada únicamente mediante una fusión dev → main en el momento de la versión. Véase Merging, Post-Merge Fixes & Scope Gate. |
| Merge Queue | El mecanismo que serializa las fusiones en dev de una en una e intenta la resolución automática de conflictos. Véase The Pipeline. |
| Pipeline | La secuencia automática de 12 pasos (branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit) que convierte el prompt de una Task en un cambio terminado, que después la Merge queue fusiona en dev. Véase The Pipeline. |
| Priority | Una indicación de posición en la cola para una Task: low, medium o high. Véase Creating a Task. |
| Proyecto | Una base de código que AITM ha incorporado y para la que puede crear Tasks. Véase Overview & Getting Started. |
| Proveedor | El servicio de IA subyacente (Claude, Gemini, OpenAI, DeepSeek, NVIDIA, Ollama) que ejecuta un paso de la Pipeline. Véase Settings. |
| Estado (de la Task) | El estado actual de una Task: pending, running, awaiting_input, waiting, finished, failed, stopped, conflict o archived. awaiting_input significa que la IA espera una respuesta o aprobación; waiting significa que la Task espera correcciones de bugs encontrados por las pruebas E2E. Véase Creating a Task. |
| Task | Una unidad individual de trabajo asignado que recorre la Pipeline. Véase Creating a Task. |
| Turno | Aproximadamente un paso en el que un Agent de IA piensa o actúa (p. ej. leer o editar un archivo). Véase Settings. |
| Veredicto | El resultado pass/fail (o más detallado) de un paso de pruebas, en especial los veredictos E2E. Véase Reading Results & Archive. |
| Watchdog | El proceso en segundo plano que detecta pasos de la Pipeline estancados y los reanuda automáticamente. Véase The Pipeline. |
Preguntas frecuentes
¿Qué ocurre si una Task falla?
La Pipeline se detiene en el paso que falla y el estado de la Task pasa a failed, con el motivo registrado. Normalmente se puede reanudar desde ese paso (o desde uno anterior) una vez comprendido qué salió mal; véase Reading Results & Archive.
¿Se pueden ejecutar varias Tasks a la vez?
Sí, en proyectos distintos. Dentro de un mismo proyecto, las Tasks se ejecutan de una en una para evitar que dos Tasks se disputen la misma rama; los proyectos distintos se ejecutan totalmente en paralelo.
¿AITM hace push alguna vez por su cuenta a un remoto o a una rama de producción?
No. La fusión automática solo fusiona en la rama dev local. Hacer push a cualquier otro sitio es siempre una acción deliberada y separada que se realiza personalmente.
¿Qué ocurre si la IA se atasca a mitad de una Task?
El Watchdog detecta un paso estancado y reanuda automáticamente la Pipeline, hasta un número limitado de intentos. Si aun así no consigue recuperarse, la Task se marca como failed conservando el motivo, para poder decidir qué hacer a continuación. Véase The Pipeline.
¿Dónde se almacenan los datos?
En local, en una combinación de bases de datos por proyecto, carpetas de Tasks y documentación generada automáticamente. Véase What Data AITM Stores para el mapa completo.
¿Hay que escribir prompts perfectos?
No, pero los prompts más específicos necesitan menos ciclos de corrección. Véanse los consejos para redactar prompts en Creating a Task.
¿Cuál es la diferencia entre Chat, Brainstorm y una Task?
Chat y Brainstorm sirven para debatir y planificar; nunca tocan el código. Una Task es lo único que realmente cambia el código, y siempre recorre la Pipeline completa con revisión y pruebas. Véanse Chat y Brainstorm.
¿Qué significa el aviso "License blocked (session-mismatch)"?
El servidor de licencias detectó la misma clave enviando heartbeats desde dos lugares a la vez: una segunda instancia de AITM, una máquina virtual clonada o una copia de seguridad restaurada ejecutándose junto al original. Mientras no se resuelva, la cola no admite Tasks. Debe detenerse la instancia duplicada y después hacer clic en Retry en el aviso (o en Refresh from server en Settings → License). Si se tiene la certeza de que solo existe una instancia, el bloqueo es un falso positivo y puede desbloquearse desde el mismo aviso. Véase Licensing & Project Slots.
¿Por qué el encabezado muestra un botón "Restart" después de que una Task se fusiona?
AITM fusionó un cambio en su propio código y, en el modo manual predeterminado, espera a que la persona usuaria lo indique antes de reiniciar, para no interrumpir una cola en ejecución. Se deja terminar las Tasks en ejecución y después se hace clic en Restart en el menú del encabezado. Para servidores desatendidos, se establece Settings → Git & Storage → Server restart after self-merge en auto.
¿Por qué hay Tasks atascadas en pending aunque no se está ejecutando nada?
O bien el límite de concurrencia es 0, o bien está activo el aviso de licencia, o bien la protección de recursos retiene las Tasks porque la RAM/CPU está por debajo del umbral de porcentaje libre. Conviene revisar la barra de estado (RAM/CPU), el aviso de licencia y Settings → Pipeline → Max concurrently running tasks. La pestaña Queued de la barra Monitor muestra por qué espera cada trabajo.