Cimiento
Prepara la copia de trabajo de tu app: la puerta a los specs y los arreglos.
El Cimiento no es un documento que escribes: es la copia de trabajo de tu app contra la que corre cada construcción. Lo preparas una vez por workspace apuntándolo a un repositorio git, y Fragua toma el camino correcto desde ahí.
Qué compartes para empezar
Dale al workspace una URL de repositorio y una rama. Fragua examina el repositorio y elige un camino automáticamente; tú no escoges entre ellos.
Greenfield
Un repositorio vacío recibe una app Rails nueva sobre el stack de Maquina, con un archivo inicial de instrucciones para agentes y un primer commit empujado por ti.
Brownfield
Un repositorio con código se clona tal cual. Después Fragua lo lee para redactar una Guía técnica, y una Guía de marca cuando detecta un sistema de diseño; ambas llegan listas para que las revises.
Para el panorama completo de cómo difieren los dos caminos, ve Greenfield y brownfield.
Le das un repositorio; Fragua lo examina y toma el camino correcto por su cuenta. De cualquier forma termina listo, que es lo que desbloquea los specs y los issues.
Cómo funcionan los turnos
Una app nueva empieza con un solo turno de confirmación: el agente te pide confirmar el nombre de la app y un par de opciones de configuración, y luego genera todo por su cuenta, sin más preguntas. Un repositorio existente se clona de inmediato, sin preguntas. Cuando se crea una app nueva, su master key se muestra una sola vez, así que guárdala.
Aceptar el resultado
El Cimiento termina en estado listo —no hay nada que aceptar— y eso desbloquea las superficies de Spec y de Issue. Una app nueva puede terminar de tres formas: lista; empujada pero pendiente de un push manual cuando Fragua no pudo empujar por ti; o construida pero con la verificación de arranque fallida, que deja una advertencia y un enlace a la transcripción.
Con una copia de trabajo en su lugar, puedes dar forma a tu primera función.