Mantener las explicaciones al día — Documentación de Noea Code

Después de cambiar la intención o el código, comprueba si las explicaciones siguen siendo aplicables. Utiliza Explicar en la barra lateral para atender las explicaciones que lo necesitan en todo el proyecto, o la acción Investigación de un párrafo para comprobar un contenido concreto.

Identifica qué ha cambiado

Estado	Significado	Siguiente paso
Contenido por investigar	La redacción nueva o editada no tiene explicación propia.	Guarda e investiga. Implementa primero si el requisito aún no se cumple.
Explicación del texto anterior	El párrafo cambió, pero la nota sigue explicando la redacción anterior.	Examina las diferencias de texto e investiga de nuevo.
Puede estar desactualizado	Los archivos leídos o citados por la explicación han cambiado.	Revisa los archivos modificados y vuelve a comprobar la explicación.
No se encontraron cambios	No hay contenido pendiente de investigación ni marcado como posiblemente desactualizado.	Sigue leyendo o verificando preguntas concretas cuando lo necesites.

«Puede estar desactualizado» no significa necesariamente que una conclusión sea incorrecta: el cambio del archivo podría no estar relacionado. «No se encontraron cambios» no demuestra que las pruebas pasen ni que todas las funcionalidades estén completas.

Investiga un párrafo

Guarda el documento, pasa el cursor sobre el párrafo y elige Investigación a la izquierda. Una nota al margen existente también puede ofrecer Investigar de nuevo.

Esto actualiza únicamente la explicación del contenido seleccionado. Investigación no está disponible mientras ese contenido tenga cambios sin guardar y Noea te pide que los guardes primero.

Por ejemplo, después de cambiar el código que evita recompensas duplicadas, investiga la regla correspondiente para comprobar que su explicación describe la implementación actual.

Actualiza las explicaciones de todo el proyecto

Pulsa Explicar en la barra lateral para comprobar el contenido pendiente de investigación y las explicaciones cuyos archivos de apoyo cambiaron. Esta acción no está disponible si no hay un proyecto abierto, si el proyecto es de solo lectura o si no tiene una carpeta de implementación vinculada.

Una tarea de Explicar iniciada manualmente abre un chat con las etapas, el progreso y los resultados individuales. No puedes enviar mensajes normales en ese chat mientras se ejecuta, pero puedes utilizar otros chats del proyecto.

Cuando termine, expande los resultados para ver qué explicaciones cambiaron, cuáles siguen siendo correctas y qué comprobaciones fallaron o quedaron sin terminar. Que la tarea termine no significa que todas las comprobaciones hayan tenido éxito.

Entiende qué comprobó Explicar

Explicar compara la intención con el código y comprueba tanto las explicaciones de párrafo como las locales. Conserva el contenido correcto y actualiza lo que necesita corrección; no necesariamente reescribe todas las explicaciones.

Una explicación actualizada no significa que las pruebas se hayan vuelto a ejecutar. Para verificar un comportamiento, solicita las comprobaciones en un chat normal e investiga después el contenido pertinente. Consulta Leer explicaciones y evidencia para interpretar el alcance de la verificación.

Conoce cuándo se ejecuta Explicar automáticamente

Configuración → Proyecto actual → Automatización → Explicar automáticamente después de implementar está activado por defecto. Los principales desencadenantes son:

Acción	Explicar automático
Aceptar una propuesta que cambia la intención y aún requiere implementación.	Después de que su tarea de implementación termine normalmente.
Aceptar una propuesta que cambia la intención y que la implementación ya cumple.	Después de aceptarla.
Iniciar trabajo con Implementar en la barra lateral.	Después de que el primer turno termine normalmente.
Aceptar un plan de organización que cambia el texto de la intención.	Después de aceptarlo, independientemente del ajuste anterior.
Reorganizar solo nombres de archivos o estructura de carpetas.	No se activa.
Cambiar solo código en un chat normal, elegir Implementar directamente o que la implementación falle o se detenga.	No se activa; ejecuta Explicar manualmente.

Explicar automático se ejecuta en segundo plano sin crear un chat normal. Continúa en tu chat original y comprueba el progreso en Ejecuciones.

Revisa los registros y vuelve a ejecutar

La sección Ejecuciones de la barra lateral conserva las tareas de explicación. Expande una tarea para ver los registros de solo lectura de sus ejecuciones. Los registros siguen disponibles después de cambiar de chat o reiniciar la aplicación.

Después de un fallo o una interrupción, elige Ejecutar de nuevo. Las explicaciones existentes se conservan. Cuando termine la nueva ejecución, comprueba que se hayan atendido los elementos que antes fallaron o quedaron sin terminar.

Elige un Agente para cada operación

El Agente utilizado por Explicar depende de cómo se inicia la tarea. Consulta Agentes, modelos y uso para conocer los ajustes de operaciones del proyecto y su alcance.

Si las explicaciones no se actualizan, consulta Solución de problemas y preguntas frecuentes.