Debatir y revisar cambios de intención — Documentación de Noea Code

Cuando una conversación lleva a una nueva decisión de producto, pide al Agente que la convierta en una propuesta de intención. Revisa la redacción, ajústala si hace falta y decide si quieres incorporarla a tus documentos.

Empieza con un contexto concreto

Pasa el cursor sobre un párrafo pertinente y elige Preguntar sobre esto a la izquierda. Noea inserta una referencia en el cuadro de entrada y muestra el documento junto al chat. No envía un mensaje automáticamente.

También puedes escribir @ en el cuadro de entrada para buscar documentos, párrafos o explicaciones. El contenido seleccionado aparece como una etiqueta de referencia y se proporciona al Agente con tu mensaje.

Por ejemplo:

Esta regla de recompensa no dice qué ocurre si se omite un registro diario. Explica el comportamiento actual a partir de la implementación y después debatamos si deberíamos permitir recuperar registros omitidos.

Cuando hayas decidido, pide una propuesta:

Añade «Permitir recuperar un registro omitido al mes» a esta regla. Propón el cambio de intención para que lo revise.

Decide si corregir el código o cambiar el requisito

Cuando intención e implementación no coinciden, pregunta primero si el requisito original sigue vigente. Supongamos que el documento exige una recompensa tras 7 días consecutivos, pero el código la entrega el día 6:

Tu decisión	Siguiente paso
El requisito sigue siendo 7 días.	Conserva la intención. Pide al Agente que corrija la implementación y verifique el límite.
Tras debatirlo, decides que sean 6 días.	Cambia la intención, revisa la nueva condición de activación y comprueba la implementación.

No reescribas la intención solo para adaptarla al código existente. Comprueba primero que el Agente entendió el requisito y después que el código lo cumple. Aclara los malentendidos, corrige los errores de implementación y cambia la intención únicamente cuando decidas cambiar la regla.

Para una corrección, sé explícito:

Conserva el requisito de 7 días. Corrige la recompensa anticipada, verifica que el día 6 no haya recompensa y el día 7 sí, y no cambies la intención para adaptarla al código actual.

Distingue sugerencias y propuestas

Una tarjeta de sugerencia registra algo que el Agente considera que merece añadirse a la intención. Adoptar inicia trabajo en el chat actual para convertirlo en una propuesta que la implementación existente ya cumple; no escribe directamente en tu intención. Descartar registra que no vas a adoptar la sugerencia.

Una propuesta contiene cambios concretos de documentos para que los revises. Después de que el Agente la presente, su tarjeta aparece cuando el turno actual termina, se detiene o falla. Elige Ver cambios para examinarla.

Revisa los cambios en el documento

La vista de revisión conserva la disposición del documento. Las inserciones tienen un fondo verde claro; las eliminaciones, un fondo rojo claro y texto tachado. Los reemplazos muestran el texto anterior y el nuevo, con los cambios resaltados palabra por palabra cuando corresponde.

Utiliza la barra inferior de revisión para avanzar entre cambios o selecciona un nombre de archivo para cambiar de documento. La decisión se aplica a toda la propuesta, incluidos todos sus archivos. No puedes aceptar párrafos o archivos por separado.

Puedes editar el texto insertado y la parte nueva de un reemplazo. El texto original, las eliminaciones y los párrafos no afectados no se pueden editar en este estado de revisión. Después de editar, la acción principal pasa a ser Aceptar mis cambios.

Antes de decidir, comprueba no solo qué palabras cambiaron, sino qué exigen:

¿Puedes explicar las condiciones y los términos añadidos con tus propias palabras?
¿Se ha confundido una instrucción puntual con un requisito permanente?
¿Ha debilitado el Agente una restricción sin señalarlo para adaptarla al código existente?
¿Podrás encontrar la frase adecuada la próxima vez que quieras cambiar este comportamiento?

Si algo no está claro, vuelve al chat y pide al Agente que explique o revise la propuesta.

Elige una acción

Acción	Documento de intención	Implementación
Aceptar	Escribe toda la propuesta.	Continúa si hace falta trabajo; no inicia otra ejecución si ya se cumple.
Aceptar mis cambios	Escribe toda la propuesta con tus ediciones.	Continúa según la propuesta editada.
Implementar directamente	No escribe la propuesta.	La implementa; solo está disponible para propuestas que aún requieren implementación.
Descartar	No aplica la propuesta.	No inicia su implementación.

Acepta una decisión revisada cuando quieras que guíe el desarrollo futuro. Implementar directamente no registra esta solicitud como intención.

Descartar una propuesta no deshace los cambios de código ya realizados. Por ejemplo, el Agente puede haber terminado el trabajo antes de proponer que registres el comportamiento existente.

Gestiona propuestas revisadas y documentos modificados

El Agente puede revisar una propuesta en el mismo chat. La nueva versión sustituye la revisión pendiente y la tarjeta anterior conserva un aviso de versión. Las ediciones que hiciste pero no aceptaste en la revisión anterior no se transfieren automáticamente.

Si el documento actual ya no coincide con el texto de partida de la propuesta, no se permite aceptarla. Utiliza Pedir al agente una nueva propuesta sobre la versión actual para que vuelva a leer el documento y cree cambios que se puedan aplicar.

Después de aceptar

Una propuesta que requiere implementación continúa en el chat actual. Si no termina, utiliza Continuar implementando en la tarjeta. Vuelve después al documento y comprueba la explicación; ejecuta Explicar manualmente si no se actualizó.

Para que las revisiones no se abran automáticamente, desactiva Configuración → Proyecto actual → Automatización → Abrir la revisión automáticamente y entra en la revisión desde la tarjeta de propuesta. Este ajuste controla la apertura de la revisión, no la aceptación de la propuesta.

Continúa con Mantener las explicaciones al día.