¿Qué hace fr-goal?
Un punto de contacto del operador desde el objetivo hasta el PR revisado: lluvia de ideas → una sola ronda de preguntas y respuestas agrupadas → especificación → revisión → fr-plan → revisión → implementación TDD → revisión → un único PR. Cada revisión corrige todo lo que encuentra; la instrucción de autonomía del operador reemplaza cada pausa de aprobación de superpoderes con una pasada de revisión y corrección. Cuando está bloqueado: detente, di qué está bloqueado y qué intentaste, y pregunta — una suposición incorrecta enviada en un PR cuesta más que una ejecución en pausa.
Anunciar al inicio: "Estoy usando fr-goal para ejecutar este objetivo de forma autónoma."
Qué permanece interactivo
| Momento | Por qué |
|---|---|
| La ronda agrupada de preguntas y respuestas (una vez, en la lluvia de ideas) | Las decisiones de diseño son propiedad del operador — sin respuesta = detenerse, nunca usar el valor por defecto |
| Ubicación del repositorio multiproyecto | Pregunta de acceso — solo si el sistema de archivos no puede responderla |
| Fases manuales | Secretos, operaciones de UI, despliegues son solo humanos — ver política de ubicación |
| Fusión del PR | El agente nunca se auto-fusiona |
| Plan de pruebas posterior a la fusión | Prueba el despliegue real; necesita el entorno del operador |
1. Lluvia de ideas con preguntas y respuestas agrupadas — en aislamiento
Invoca fr-brainstorming (ejecuta fr isolation up primero; sin perfil de devcontainer → pausa para la entrevista fr-init). El aislamiento precede a TODO — exploración, mediciones, operaciones de clúster incluidas; un operador "empezar con X" cambia el primer elemento de trabajo, nunca la primera acción. Explora, recopila TODAS las decisiones propiedad del operador, haz todas en una sola llamada AskUserQuestion (máximo 4 preguntas, recomendado primero). Incluye una pregunta del Plan de pruebas posterior a la fusión SOLO cuando el entregable se despliega (servicio/bot/infra), nunca código puro. Agrupa las rezagadas. Puerta dura: una llamada sin respuesta es una señal de parada — termina el turno reafirmando las preguntas abiertas y espera; nunca sustituyas los valores por defecto por una respuesta real.
2. Especificación — luego revísala
Escribe docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md, luego revísala comparándola con las respuestas de preguntas y respuestas Y la realidad del código base (¿los archivos/ayudantes/servicios que nombra existen?). Corrige cada hallazgo. Plan de pruebas elegido → la especificación lleva una sección ## Plan de pruebas con los pasos posteriores a la fusión.
3. Verificación multiproyecto
Para una especificación entre repositorios (forma owner/repo:path), esta sesión es dueña del plan y PR de UN repositorio. Para cada otro repositorio: localiza su copia de trabajo tú mismo (directorios hermanos, raíces habituales); pregunta por una ruta/clon solo si no se encuentra — agrúpalo en las preguntas y respuestas. Despacha un agente por repositorio (isolation: "worktree") con la referencia de la especificación y este pipeline desde el paso 4. Un plan, un PR por repositorio.
4. Plan — fr-plan, luego revísalo
Invoca fr-plan, saltando la aprobación sección por sección (la especificación codifica el diseño). Mantén el plan v2 como carpeta, con pasos con forma TDD. Revisión: fr plan self-review debe pasar y las fases deben leerse contra la especificación (todas cubiertas). Corrige, implementa.
5. Fases manuales — retrasadas por defecto
La puerta de pureza agéntica de fr-plan recoge el trabajo manual en fases [manual] dedicadas. fr-goal añade política de ubicación (una fase manual a mitad del plan detiene la ejecución):
- Retrasadas por defecto: TODO el trabajo manual en la ÚLTIMA fase, sin fase agéntica que dependa de ella. El PR lo entrega deliberadamente no implementado, marcado para el operador, quien lo implementa y lo empuja al mismo PR (
fr plan edit --complete-phase N --note). - Adelantadas solo cuando el trabajo agéntico depende genuinamente de ellas. Termina el plan + revisión, abre un PR de especificación + plan (las instrucciones manuales SON el entregable), pausa; reanuda SOLO con la señal del operador.
- Multiproyecto: modela dependencias entre repositorios —
depends_ones solo dentro del plan, por lo que el orden reside en la especificación y la secuencia de PR (un secreto en un repositorio puede bloquear las fases de otro).
6. Implementación — fr-execute modo local, TDD, sin subagentes
El espacio de trabajo de aislamiento del paso 1 es la copia de trabajo — cada comando a través de fr isolation exec. Ejecuta las fases mediante fr-execute en modo LOCAL (plan-dir + fase), NO despachado (la especificación/plan no están en main, fr apply --yes lo rechaza). Implementa en línea, no mediante subagentes (el contexto necesita las preguntas y respuestas + el historial de la especificación). TDD por paso; marca pasos / completa fases mediante fr plan edit. Nunca una fase manual.
La capa de implementación empuja la rama SOLAMENTE — nunca abre el PR (en línea, o un constructor delegado multiproyecto). Abrirlo aquí reordena la entrega (8) antes de la revisión (7), permitiendo que el operador fusione antes de que existan correcciones — quedan huérfanos en una rama fusionada (#320, 3×). El orquestador abre un PR borrador para visibilidad — no fusionable hasta el paso 8, su insignia "Borrador" significa "no fusionar aún".
7. Revisión en hitos — corrige todo lo que se encuentre
Después de cada hito (fase completada, o implementación completa para planes pequeños), invoca superpowers:requesting-code-review sobre la especificación + plan + código. Corrige cada hallazgo inmediatamente, con pruebas; uno factualmente incorrecto recibe razonamiento refutatorio (superpowers:receiving-code-review), nunca una eliminación silenciosa. Mantén una lista de hallazgos.
8. Entrega — un PR por repositorio, todos los artefactos a bordo
Verifica primero (superpowers:verification-before-completion): salida completa del conjunto de pruebas, autoevaluación aprobada, pasos marcados. El PR se vuelve fusionable SOLO ahora (después de las correcciones del paso 7): gh pr ready en el borrador — nunca digas "listo para fusionar" antes de esto. Cuerpo del PR: resumen + rutas de especificación/plan; hallazgos de la revisión y sus correcciones (más cualquier hallazgo refutado); la fase manual retrasada marcada como "no implementada — el operador empuja a este PR"; el Plan de pruebas textual, etiquetado como "posterior a la fusión — operador". Detente; el operador fusiona.
9. Cierre posterior a la fusión
Cuando el operador informe la fusión: primero verifica que la corrección llegó a main — ejecuta fr isolation verify-merge --branch <b> (seguro para squash/rebase/fusión; salida 1 = no verificado). No verificado → DETENTE y recupera (cherry-pick / nuevo PR). Luego ejecuta el Plan de pruebas si está presente (el agente ejecuta comprobaciones, el operador confirma lo que no puede alcanzar), confirma las fases completadas (fr status), fr archive <plan-dir>, haz commit mediante un PR de mantenimiento, fr isolation down.