Communitygithub.com

fr-goal

Suite de plugins Claude Code: planificación envolvente, aislamiento devcontainer+worktree, autonomía de objetivo a PR y despacho de fases a runners VibeKanban

¿Qué es fr-goal?

fr-goal es un potente plugin para Claude Code que automatiza el ciclo completo desde una idea hasta un Pull Request revisado, minimizando las pausas de aprobación. Primero, realiza una tormenta de ideas con preguntas agrupadas en una sola interacción, donde el operador toma todas las decisiones de diseño (nunca se asume un valor por defecto). Luego genera un documento de especificación, un plan de implementación con pasos TDD y fases manuales colocadas al final por defecto para no bloquear el flujo automático. La implementación se ejecuta en un entorno aislado (devcontainer/worktree) sin subagentes, manteniendo el contexto de las preguntas y el historial. Tras cada hito, se invoca una revisión de código que corrige todos los hallazgos inmediatamente. Finalmente, se crea un único PR por repositorio (nunca auto-fusionado), se verifica que la corrección llegó a main y se ejecuta el plan de pruebas posterior a la fusión.

Compatible con✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add derio-net/super-fr

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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

MomentoPor 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 multiproyectoPregunta de acceso — solo si el sistema de archivos no puede responderla
Fases manualesSecretos, operaciones de UI, despliegues son solo humanos — ver política de ubicación
Fusión del PREl agente nunca se auto-fusiona
Plan de pruebas posterior a la fusiónPrueba 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_on es 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.

Skills relacionados