Tu primer flujo de trabajo

Este tutorial utiliza una recompensa por registros diarios para mostrar cómo escribir tu primera intención, comprobarla o implementarla y registrar una nueva decisión. Aprenderás a juzgar si un requisito se cumple utilizando el código real del proyecto y los resultados de verificación.

Necesitas Noea con un Agente en estado Listo y un proyecto local en el que quieras trabajar. Si tu proyecto no tiene una función de registros diarios, sustitúyela por otra regla igual de concreta.

Abre el proyecto de código

Elige Abrir carpeta… en el área de trabajo o Archivo → Abrir carpeta de implementación… y selecciona la carpeta que contiene tu código.

La primera vez que abres esa carpeta, Noea crea un proyecto vinculado. Si ya existe uno, lo abre directamente; si hay varios vinculados, te pide que elijas. Consulta Abrir y gestionar proyectos para conocer otras formas de abrir un proyecto.

Escribe tu primera intención

Pulsa Nueva intención en la barra lateral y llámala «Registros diarios». Noea añade la extensión .noea.md y abre el documento. Escribe:

# Registros diarios

Los usuarios pueden registrar su actividad una vez al día. Otorgar una recompensa al usuario después de 7 días consecutivos de registros.

Guarda con ⌘S en macOS o Ctrl+S en Windows / Linux. Empieza por lo que ya has decidido; todavía no necesitas enumerar todos los casos límite.

Elige investigar o implementar

Explicar comprueba el contenido de todo el proyecto cuyas explicaciones necesitan atención. La acción Investigación de un párrafo comprueba solo ese contenido. Ambas examinan la implementación y generan o actualizan explicaciones; no modifican el código.

Si los registros diarios ya existen, pulsa Explicar en la barra lateral. Para comprobar solo este párrafo, pasa el cursor sobre él y elige Investigación a la izquierda.

Si la regla aún necesita implementación, inicia un chat nuevo, escribe @ en el cuadro de entrada para seleccionar el documento de intención y envía:

Implementa la recompensa por registros diarios en este proyecto según la intención referenciada. Examina primero el código existente, sigue la estructura del proyecto y verifica tanto una racha de 7 días como la omisión de un registro.

También puedes usar el botón Implementar de la barra lateral cuando esté disponible; consulta Trabajar con un Agente en la implementación. Mientras el Agente trabaja, el chat muestra respuestas, llamadas a herramientas y cambios en archivos.

Después de implementar, pulsa Explicar si no se ha iniciado automáticamente. No todos los cambios de código en un chat normal activan una actualización de las explicaciones.

Lee una explicación de la implementación

Vuelve al documento de intención y pulsa el espacio vacío dentro del párrafo, fuera del texto, para abrir la nota al margen. Lee estas secciones:

• Implementación: cómo cuenta el código los días consecutivos y entrega recompensas.
• Evidencia: el código, la salida de comandos o el material de pruebas citado por la explicación.
• Atención: carencias, decisiones de implementación, riesgos o sugerencias que requieren tu criterio.

Por ejemplo, puedes descubrir que la implementación define los días del calendario según la zona horaria del dispositivo. Comprueba qué hace realmente el proyecto y si coincide con tus requisitos. Abre las referencias para ver hasta dónde respalda la evidencia la explicación.

Que una explicación termine no significa que las pruebas se hayan vuelto a ejecutar. Distingue el código de pruebas, los resultados históricos y la verificación realizada en esta ejecución; consulta Leer explicaciones y evidencia. Si la implementación incumple el requisito original, corrígela en lugar de reescribir la regla para adaptarla al código.

Haz una pregunta y registra una decisión

Pasa el cursor sobre el párrafo y elige Preguntar sobre esto a la izquierda. Noea inserta una referencia en el cuadro de entrada del chat. Añade tu pregunta y envía:

¿Cómo gestiona la implementación actual los viajes entre zonas horarias? ¿Registrar la actividad desde dos lugares puede afectar a la racha? Explícalo a partir del código.

Cuando entiendas el comportamiento, decide si quieres establecer una restricción para el cálculo. Si es así, envía:

Añade «Un día corresponde a la fecha del calendario de la ubicación actual del usuario» a esta intención. Propón primero el cambio de intención para que lo revise.

Cuando el Agente presente una propuesta, pulsa Ver cambios y lee el texto añadido y reemplazado. Edita la nueva redacción si hace falta y elige Aceptar mis cambios, o Aceptar si no necesitas editarla.

Si la propuesta necesita trabajo de implementación, aceptarla continúa ese trabajo en el mismo chat. Si la implementación existente ya la cumple, no hace falta otra ejecución de implementación. Comprueba después los resultados de la tarea de explicación o investiga manualmente cuando sea necesario.

Comprueba lo que has aprendido

Antes de terminar, guarda el documento y confirma que su explicación cubre la redacción actual. Intenta responder a cuatro preguntas con tus propias palabras:

1. ¿Cómo se implementa este requisito y qué evidencia respalda esa conclusión?
2. ¿Qué decisión importante tomó el Agente que no estaba especificada en la intención?
3. ¿Entiendo y acepto esa decisión? ¿Debería convertirse en una restricción permanente?
4. ¿Qué frase cambiaría la próxima vez que quiera modificar este comportamiento?

Por ejemplo, deberías poder explicar cómo se define un día, encontrar la evidencia correspondiente e identificar «7 días consecutivos» como condición para la recompensa. Si alguna respuesta no está clara, pregunta sobre el párrafo pertinente.

No necesitas registrar todas las reglas en tu primera sesión. Añade la siguiente decisión que merezca conservarse cuando la encuentres.

A continuación, lee Escribir intenciones que importan y Leer explicaciones y evidencia.