Guías
Documentación
Trabajar con agentes

Agente de Guía técnica

Documenta el stack, el modelo de datos y las convenciones de la construcción.

El agente de Guía técnica escribe la forma técnica del producto: decisiones de stack, el modelo de datos, las convenciones y cómo encaja todo. En un código existente, Fragua también redacta esta guía por ti automáticamente a partir del código; llega lista para que la revises, la aceptes o la edites, igual que cualquier otro borrador.

Qué compartes para empezar

Describe lo que quieres que cubra la guía (hasta 1,500 caracteres) y agrega notas. No hay requisito previo; el agente se apoya en tus documentos anteriores cuando existen.

¿Ya tienes un guía técnica? No tienes que generarlo: pega el que tengas y guárdalo, y entra directo a revisión. Ve Greenfield y brownfield.

Cómo funcionan los turnos

El agente hace una ronda o dos de preguntas en la página y luego escribe la guía. Tú respondes; los demás siguen en solo lectura.

Cómo va un ciclo de turnos
Lo describes El agente pregunta Respondes Borrador Revisión Aceptar

El paso de preguntar y responder se repite hasta que el agente tiene suficiente para escribir el borrador. Después del borrador, enviar notas de revisión reabre la misma conversación.

Aceptar el resultado

La guía queda en revisión para que el workspace la acepte, y sigue siendo editable por ti o un administrador después.

Bueno saber

  • Mientras una corrida está en curso, solo la persona que la inició puede responder; los demás en el workspace la siguen en modo de solo lectura.

  • Si una corrida se atora o cambias de opinión, puedes cancelarla y luego reiniciarla o reanudarla desde donde se quedó.

  • Fragua te avisa cuando un borrador está listo o una corrida falla, así no tienes que quedarte observándola.

  • Un administrador puede deshacer una aceptación para regresar un documento a revisión.