Conoce Noea Code

Noea Code (Noea, para abreviar) te ayuda a entender y decidir cómo se comporta tu software cuando desarrollas con IA. Escribes los requisitos, un Agente de programación modifica el código y utilizas las explicaciones de la implementación, la evidencia y los puntos de atención para comprobar si el resultado cumple tus expectativas.

Empieza con una sola regla en un proyecto existente. Un comportamiento del producto, una restricción arquitectónica o un requisito de un algoritmo pueden ser tu primera intención.

La intención representa los requisitos que quieres que el software siga cumpliendo. Siguen siendo relevantes después de terminar una funcionalidad. Cuando decides cambiar su comportamiento, cambias el texto correspondiente. No necesitas describir toda la aplicación: empieza por lo que te importa.

Conecta la intención con la implementación

Supongamos que creas una aplicación de registros diarios y escribes:

Otorgar una recompensa al usuario después de 7 días consecutivos de registros.

Esto establece la condición para una recompensa, pero deja varias decisiones abiertas: qué cuenta como un día, qué ocurre si se omite un registro y qué recompensa se entrega. El Agente tendrá que tomar esas decisiones al implementar la regla.

Noea conecta la frase con una explicación de la implementación. Puedes leer cómo cuenta los días el código, abrir las referencias al código o las pruebas que sustentan la explicación e identificar requisitos incumplidos o decisiones que merecen debatirse. Si decides que cada día debe corresponder a la fecha del calendario local del usuario, incorpora esa decisión a la intención para que el trabajo futuro la respete.

Conoce los tres tipos de contenido

Los documentos de intención son archivos Markdown. Puedes seguir sus cambios con Git o editarlos con otro editor. Noea almacena las explicaciones de la implementación por separado y las muestra en notas al margen. Algunas etiquetas de la interfaz en inglés llaman Source a los documentos de intención, que en español aparecen como Fuente; no se trata del código de la carpeta de implementación.

Sigue el flujo de trabajo habitual

1. Aclara la intención. Escríbela directamente o coméntala con el Agente y revisa la redacción propuesta.
2. Implementa y comprende. Deja trabajar al Agente; después investiga la implementación y lee la explicación, la evidencia y los puntos de atención.
3. Registra tus decisiones. Pregunta sobre un párrafo concreto, añade los requisitos que quieras conservar y continúa implementando y comprobando.

Si el código ya existe, escribe el requisito que quieres comprobar y ejecuta Explicar. Si todavía necesita implementación, utiliza un chat o la acción Implementar.

Puedes aceptar una decisión que entiendes sin convertir cada detalle de implementación en un requisito permanente. Consulta Leer explicaciones y evidencia para decidir qué debe formar parte de tu intención.

Entiende el papel de Noea y el del Agente

Noea proporciona el área de trabajo para escribir documentos, debatir decisiones, revisar cambios y leer explicaciones. El Agente lee el proyecto, utiliza herramientas y modifica código. Elige un Agente compatible y utiliza los modelos y métodos de inicio de sesión que ofrece.

En el flujo de propuestas de Noea, los cambios en tus documentos de intención requieren tu decisión. Puedes editar y aceptar una propuesta o descartarla. Los cambios de código y los comandos dependen de las capacidades y los permisos del Agente.

Las explicaciones de la implementación no sustituyen las pruebas ni el uso directo del software. Examina la evidencia de los comportamientos importantes y verifícalos cuando sea necesario.

Empieza con una pregunta pequeña y significativa

Elige algo concreto con un resultado observable: cuándo se entrega una recompensa, cómo se gestiona la falta de existencias o una restricción que debe respetar una API. Puedes seguir utilizando tu proceso de desarrollo habitual para el resto del proyecto.

A continuación, instala y prepara Noea y sigue tu primer flujo de trabajo.