Greenfield y brownfield
Dónde empieza de verdad una construcción, y por qué cada documento de planeación es opcional.
Fragua corre una cadena de agentes: Resumen de producto, Investigación, Plan MVP, Guía de marca, Guía técnica, y luego Cimiento, Spec y Ejecución. Se lee como una secuencia que debes completar en orden, pero casi todo es opcional. Los agentes que producen documentos existen para darle más contexto a los agentes siguientes, no para frenar tu construcción.
Solo dos cosas son realmente necesarias antes de que Fragua escriba código: un Cimiento —la copia de trabajo de tu app— y un Spec aceptado. Todo lo anterior es contexto que puedes agregar, omitir o aportar tú mismo.
El Cimiento construye la app y desbloquea los specs; un spec aceptado dispara la ejecución, que abre un pull request que tú revisas y haces merge.
Dos maneras de empezar un Cimiento
Cuando apuntas un workspace a un repositorio git, Fragua lo examina y elige el camino por su cuenta: tú no escoges entre ellos.
Greenfield
El repositorio está vacío o solo tiene un README. Fragua genera una app Rails nueva sobre el stack de Maquina, deja un archivo inicial de instrucciones para agentes con los comandos de tu proyecto y empuja el primer commit. Tú confirmas el nombre de la app antes de que corra.
Brownfield
El repositorio ya tiene código. Fragua lo clona y lo deja como está: nunca escribe un CLAUDE.md en tu repo. Después lee el código para redactar una Guía técnica y una Guía de marca a partir de lo que ya existe.
De cualquier forma terminas con lo mismo: un Cimiento listo y una rama sobre la que construyen los agentes. La interfaz de Fragua siempre la llama rama.
Los documentos de planeación son opcionales
El Resumen de producto, la Investigación, el Plan MVP, la Guía de marca y la Guía técnica son enriquecimiento, no requisitos. Un agente posterior los usa cuando existen y trabaja sin ellos cuando no. Puedes construir sin ninguno, o solo con el uno o dos que te importen.
-
Resumen de producto — qué estás construyendo, para quién y qué lo hace distinto.
-
Investigación — un análisis de competencia y mercado; se apoya en el resumen cuando existe.
-
Plan MVP — el resumen y la investigación convertidos en un primer lanzamiento concreto.
-
Guía de marca — colores, tipografía y voz; corre en cualquier momento, incluso en un workspace vacío.
-
Guía técnica — stack, modelo de datos y convenciones; en repos existentes se saca del código.
La única puerta real es el Cimiento. Una vez listo puedes dar forma a un Spec y publicar, con o sin cualquiera de los documentos de arriba.
Trae el tuyo, o deja que un agente lo escriba
No estás atado a documentos escritos por agentes. Cada documento de planeación te da dos maneras de entrar en su pantalla de creación: deja que un agente te entreviste, o pega una versión que ya tengas.
Entrevista
Describe lo que quieres y el agente te hace preguntas de seguimiento, luego escribe el documento por ti. Útil cuando partes de una idea en bruto.
Pegar
¿Ya tienes el documento —de otra herramienta, un proyecto pasado o tus propias notas? Pega el Markdown. Se salta la entrevista y entra directo a revisión, listo para aceptar.
Cómo encajan los agentes
La mayoría de los pasos son opcionales. Estas son las conexiones que importan: qué desbloquea qué, y qué solo aporta contexto.
El Resumen de producto desbloquea la Investigación y el Plan MVP.
El Cimiento desbloquea los Specs y los Issues: lo único obligatorio antes de construir.
Un Spec aceptado o un Issue aprobado inicia la Ejecución, que abre un pull request.
Tus documentos de planeación le dan contexto al agente de Spec: se usan cuando existen y se omiten cuando no.
Los agentes a detalle
Cada agente tiene su propia página: qué hace, qué compartes para empezarlo y cómo llegar al resultado.
Instala la CLI y corre tu primer agente en tu propia máquina.