juanmackie/juanskills

El Bucle Fable

Esta skill orquesta el método fable-method: primero lee su SKILL.md; sus reglas gobiernan cada etapa. Se instala junto a esta skill (en el directorio skills/fable-method/ de este plugin, o ~/.claude/skills/fable-method/ para instalaciones manuales). El método dice QUÉ verificar; este bucle dice QUIÉN hace el trabajo: qué se ejecuta en el hilo principal, qué se distribuye a subagentes, y qué se ataca antes de la entrega.

Puerta primero.

Tareas triviales según la puerta de trivialidad del método: simplemente hazlo, verifica con la única comprobación obvia, informa en dos oraciones. Sin etapas, sin subagentes. Todo lo demás ejecuta las cuatro etapas siguientes en orden.

Etapa 1 - PLAN (el primer tope)

1. Aplica los Pasos 0-3 del método: clasifica la solicitud, define el criterio de éxito con una verificación nombrada, declara los supuestos críticos.
2. Distribución de evidencia. Genera los recolectores de evidencia como subagentes paralelos en UN solo mensaje, nunca secuencialmente:
   • preguntas sobre el código: un agente Explorador por área distinta ("cómo funciona X", "de qué depende Y")
   • preguntas sobre librerías o datos: un agente investigador que obtiene documentación actual o busca en la web
   • cada subagente devuelve hallazgos destilados con citas, nunca volcados de archivos sin procesar
   • Un lote más un lote de seguimiento es el presupuesto; un tercero necesita una razón explícita
3. Produce el artefacto del plan con esta forma:
   • clasificación
   • definición de éxito más su verificación
   • evidencia encontrada (citada)
   • UN enfoque recomendado (alternativas descartadas en una línea cada una)
   • el alcance (los archivos o superficies exactos que el trabajo tocará)
   • riesgos y supuestos
   • y la lista de verificación de ejecución
4. Puerta de decisión.
   • Con forma de tarea y reversible: pasa a la Etapa 2 sin preguntar
   • Con forma de plan primero (alcance ambiguo, acciones irreversibles o hacia afuera, o el usuario pidió un plan): presenta el artefacto del plan y DETENTE para aprobación

Etapa 2 - EJECUTAR

1. Trabaja la lista de verificación en el hilo principal (usa la herramienta todo si el arnés la tiene; marca los elementos completados a medida que se terminan). Decidir y editar se queda en el hilo principal; solo buscar y verificar se distribuye.
2. Cada edición sigue el Paso 4 del método: puerta de intención antes de cambios de comportamiento, puerta de repaso antes del primer uso de cualquier cosa no abierta, cambio correcto más pequeño, ediciones precisas, nunca destruir sin mirar.
3. Elementos mecánicos independientes (el mismo cambio en muchos archivos, generación de archivos aislados) pueden distribuirse a subagentes paralelos, en un solo mensaje, con aislamiento de árbol de trabajo si pudieran tocar los mismos archivos.
4. Una sorpresa a mitad de ejecución se redirige según la regla 7 del Paso 2 del método: dilo, luego actualiza el plan o vuelve a la Etapa 1. Nunca fuerces el plan a través de una sorpresa.
5. La ignorancia a mitad de un elemento es una pausa, no una suposición: en el momento en que una edición requeriría un hecho de la memoria (una firma, una clave, una cifra), detén ese elemento, distribuye un subagente de investigación según la puerta de repaso del método, y reanuda cuando regrese.
6. Los elementos de la lista de verificación orientados hacia afuera obedecen la puerta de autorización del método: sin autorización del usuario citada, no hay acción; el elemento se convierte en un próximo paso propuesto en el informe.
7. Puntos de control de presupuesto de turnos. Limita las iteraciones largas a ≤50 turnos de agente; en cada límite, escribe un artefacto de punto de control (qué se completó, rutas de evidencia, la siguiente acción exacta) y reanuda desde allí. La verificación final nunca debe ser el paso que el límite de turnos mate; verifica dentro del presupuesto o márcalo explícitamente como pendiente.

Etapa 3 - VERIFICAR (adversarialmente)

1. Ejecuta la verificación nombrada tú mismo, ambas mitades: el criterio de éxito observado (ejecutado, renderizado, contado), y el sistema circundante aún saludable (build, tests, lint para el área tocada).

2. Para cambios consecuentes, genera atacantes. 1-3 subagentes paralelos, cada uno indicado a REFUTAR el trabajo desde una perspectiva distinta, por ejemplo:

   • "Lee este diff y demuestra que el cambio es incorrecto o incompleto"
   • "Ejercita el comportamiento modificado en tiempo de ejecución y encuentra una entrada que lo rompa"
   • "Verifica esta afirmación contra la especificación/documentación y encuentra una contradicción"
   • "Compara el conjunto completo de cambios contra el alcance declarado en el plan y demuestra que algo fuera de él cambió"

   Perspectivas distintas superan a revisores idénticos.

3. Un hallazgo que sobrevive a tu propia verificación regresa a la Etapa 2 como trabajo nuevo. Límite fijo según el método: 3 ciclos fallidos de corrección-verificación sobre el mismo problema, o cualquier bloqueador fuera de tu control, significa detenerse y devolver el resultado junto con tu hipótesis.

Etapa 4 - AUDITAR E INFORMAR (el segundo tope)

1. Autoevaluación según el modo de auditoría del método fable: para cada paso del método, seguido, omitido o falsificado. Corrige lo que una pasada pueda corregir (generalmente una afirmación no verificada: verifícala ahora o recalifícala como advertencia).
2. Entrega según el Paso 6 del método: resultado en la primera oración, evidencia de verificación mostrada, advertencias honestas, seguimientos solo si surgieron del trabajo. Sin nombres de etapa ni números de paso en el informe; las líneas INTENT y AUTH son los únicos artefactos del método que un informe puede contener.

Cuándo NO usar este bucle

• Tareas triviales (la puerta las maneja)
• Preguntas puras sin trabajo de varios pasos: el método fable simple cubre la forma
• Dentro de una fase GSD ya orquestada: GSD es dueño de las etapas allí; aplica las reglas del método fable dentro de ellas en lugar de anidar bucles

Economía del modelo

El bucle es agnóstico al modelo. Los subagentes de evidencia y ataque son amigables con modelos económicos; mantén el hilo principal (decisión, edición) en el modelo más potente disponible, y da a los atacantes un mayor esfuerzo que a los recolectores cuando exista una opción.

Uso

/fable-loop <tarea>   Ejecuta el bucle orquestado completo