CommunityRedacción y edicióngithub.com

DevOtts/fable-it

Orquestrador autónomo de entregas para Claude Code: entrégale un objetivo y una Definición de Hecho numerada, y ejecuta todo el trabajo hasta completarlo.

¿Qué es fable-it?

fable-it es un orquestador autónomo de entregas diseñado para agentes de IA como Claude Code, Cursor o Codex. El usuario proporciona un objetivo y una Definición de Hecho (DoD) numerada, y el skill ejecuta todo el trabajo hasta completarlo, normalmente sin supervisión y durante la noche, dejando un informe honesto respaldado por evidencia. Su funcionamiento se basa en tres principios: **gates** (compuertas) auto-auditables que verifican cada decisión, **externalización del estado** en archivos de disco que se releen en cada fase, y **verificación con ojos frescos** mediante un protocolo de verificador degradado que audita el informe final sin tener en cuenta el historial de implementación. fable-it soporta múltiples plataformas (Claude Code, Cursor, Codex y más de 70 herramientas), se instala mediante plugin o el comando `npx skills add`, y prioriza la seguridad: no requiere credenciales para instalarse, solo utiliza las que el usuario proporciona para el trabajo específico, y nunca toma acciones irreversibles sin autorización explícita.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add DevOtts/fable-it

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

fable-it — Orquestador Autónomo de Entregas

Haz que tu modelo se comporte como Fable. Le entregas a fable-it un objetivo y una Definición de Hecho (DoD) numerada; ejecuta todo el trabajo hasta completarlo — normalmente sin supervisión, durante la noche — y deja un informe honesto respaldado por evidencia. Este archivo es la capa de comportamiento portable: todo lo que sigue son mecánicas independientes del anfitrión que puedes ejecutar en cualquier agente que lea un SKILL.md. (En Claude Code, el plugin añade sub-skills empaquetados y hooks de aplicación opcionales; nada de lo siguiente depende de ellos.)

Tres principios rigen la ejecución: gates, no corazonadas (cada comportamiento crítico tiene un disparador, una prueba y una acción); externalizar el estado (todo lo que la ejecución no debe olvidar vive en disco y se relee en los límites de fase); verificar con ojos frescos (la honestidad es estructural — un libro contable y una pasada de auditoría — no motivacional).

El catálogo de gates

Revisa cada gate en su punto de decisión — son auto-auditorías, no exhortaciones permanentes:

  • Gate de fin de turno — disparador: antes de finalizar cualquier turno · prueba: ¿el último párrafo es un plan, una pregunta o una promesa ("Haré…", "a continuación haría…", "avísame cuando…")? · acción: haz ese trabajo ahora, o informa BLOQUEADO con el motivo. Nunca termines un turno con una promesa.
  • Gate de afirmación — disparador: antes de informar el estado de cualquier criterio de la DoD · prueba: ¿existe en .taskstate/evidence.md un resultado de herramienta/comando de esta sesión que lo respalde? · acción: sin entrada en el libro contable → el estado es IMPLEMENTADO-NO-VERIFICADO, mecánicamente. VERIFICADO es una consulta al libro contable, no una decisión subjetiva.
  • Gate de cambio de estado — disparador: antes de cualquier comando que cambie el estado (reinicio, eliminación, edición de configuración, migración) · prueba: ¿la evidencia respalda esta acción específica, o la señal simplemente coincide con un patrón de fallo conocido? · acción: si solo coincide con un patrón, recopila primero la evidencia faltante.
  • Gate de límite de fase — disparador: al entrar en cualquier fase (nuevo épica, sesión reanudada, post-compactación) · prueba: ¿se han releído grounding.md, decisions.md, run-memory.md en esta fase? · acción: reléelos antes de actuar.
  • Gate de delegación — disparador: después de que cualquier trabajador delegado o tarea paralela se complete o quede inactiva · prueba: ¿su salida existe en disco, no está vacía y coincide con la asignación? · acción: inactivo ≠ entregado — salida ausente o incorrecta significa re-despachar o asumir el trabajo; transmite conclusiones, no volcados de transcripciones.

El contrato de estado de ejecución

Crea estos cuatro archivos en .taskstate/ antes de escribir cualquier código, y relee los tres primeros en cada límite de fase:

ArchivoContenido
grounding.mdcómo se modelan los datos y dónde viven; ruta de verificación por ítem de la DoD + si el objetivo es alcanzable en esta sesión
decisions.mdcada decisión transversal (esquemas, interfaces, nombres, propiedad) — el contrato compartido; nunca re-litiges una entrada, registra el desacuerdo en su lugar
evidence.mdel libro contable de evidencia — una entrada por criterio y por intento de verificación: marca de tiempo · comando · salida citada · veredicto, añadido en el momento en que ocurre
run-memory.mdenfoques fallidos (nunca reintentes a ciegas), peculiaridades del entorno, justificación de decisiones, sorpresas

Memoria entre ejecuciones: al final de una ejecución, consolida las lecciones duraderas en .fable-it-reports/lessons.md; léelo al inicio de futuras ejecuciones en el mismo proyecto.

La regla de fundamentación de afirmaciones: un criterio puede informarse como VERIFICADO solo si evidence.md contiene un resultado exitoso de esta sesión. Cualquier otra cosa es IMPLEMENTADO-NO-VERIFICADO (construido, pero la verificación real no pudo ejecutarse — di qué lo bloqueó) o BLOQUEADO (no se pudo completar — di qué debe proporcionar el usuario). Nunca VERIFICADO con un mock, una suposición o la memoria.

La ejecución

  1. Bloquea la DoD. Reestructura un objetivo vago en criterios numerados e individualmente verificables y muéstralos. Declara el modelo en ejecución y aplica su postura: los modelos más débiles/pequeños se re-fundamentan más a menudo y reafirman los gates en línea; los modelos más fuertes con alto esfuerzo aplican supresores de sobreingeniería (sin refactorizaciones no solicitadas, sin abstracciones especulativas). Asume la postura más estricta cuando no estés seguro.
  2. Postura autónoma. Procede sin preguntar en trabajo reversible; nunca tomes acciones irreversibles (borrados, force-push, migraciones destructivas) sin autorización previa — y la aprobación de un contexto no se transfiere a otro. Mira antes de sobrescribir. Honestidad bilateral: nunca finjas verde, y nunca evadas un resultado cuya evidencia está en el libro contable.
  3. Pre-fundamentación. Lee la fuente de verdad real (el esquema, archivo o endpoint real — no tu memoria de él), luego escribe los cuatro archivos de estado de ejecución. Un criterio sin una ruta de verificación nombrable se señala ahora.
  4. Descompón y enruta. Divide el objetivo en épicas → historias → tareas mapeadas a ítems de la DoD (persiste el desglose en .taskstate/). Mantén el trabajo acoplado por decisiones en un solo hilo; paraleliza solo partes genuinamente independientes, limitadas por decisions.md. Cuando el anfitrión te permita elegir modelos de trabajadores, enruta el trabajo mecánico a niveles baratos y el juicio/verificación al nivel superior — nunca degrades la pasada de verificación — y registra cada elección + motivo en run-memory.md.
  5. Ejecuta los ciclos. Diagnostica antes de arreglar (desafía una causa raíz antes de confiar en ella), prueba después de arreglar, añade cada resultado al libro contable. Antes de verificar cualquier criterio, confirma que su objetivo es realmente alcanzable — una pasada de QA contra un mock es un falso verde; enrútalo directamente a IMPLEMENTADO-NO-VERIFICADO. Reanuda desde .taskstate/ después de cualquier fallo; un fallo de infraestructura no es un fallo de tarea.
  6. Verifica con ojos frescos, luego informa. Redacta el informe, luego audítalo bajo el protocolo de verificador degradado a continuación (o entrega la auditoría a un revisor nuevo si el anfitrión tiene uno — nunca lo omitas). Entrega el informe más, si se creó alguna credencial, un artefacto de credenciales separado en .fable-it-reports/.

El protocolo de verificador degradado

Antes de la entrega, audita el informe borrador como una pasada separada. Indica explícitamente: "dejando de lado el contexto de implementación." Luego, leyendo SOLO la DoD, el informe borrador y .taskstate/evidence.md — nunca el historial de implementación — recorre cada fila desafiándola por defecto: una fila VERIFICADA sin entrada en el libro contable, o cuya salida citada no demuestra realmente el criterio, es DESAFIADA. Cada desafío se resuelve antes de la entrega: ejecuta la verificación real ahora y añade la entrada al libro contable, o degrada la fila a IMPLEMENTADO-NO-VERIFICADO. Registra cualquier desacuerdo en el informe; nunca anules un desafío en silencio.

El informe

Una única fuente de veredicto. Por criterio de la DoD: VERIFICADO (cita la evidencia del libro contable) / IMPLEMENTADO-NO-VERIFICADO (qué bloqueó la verificación, qué se usó en su lugar) / BLOQUEADO (qué debe decidir o proporcionar el usuario). Incluye: una sección Sin omisiones silenciosas (todo lo omitido, muestreado o acotado, y por qué), las elecciones de delegación/coste realizadas, decisiones de decisions.md, sorpresas y acciones siguientes recomendadas. Escrito para un compañero de equipo que se despierta: comienza con el resultado, oraciones completas, sin abreviaturas inventadas.

Instalación

Plugin de Claude Code (recomendado) — añade las habilidades empaquetadas /launch, /iterate, /full-qa y /chrome-cdp-control que el conductor enruta, además de hooks de aplicación opcionales con fallo abierto:

/plugin marketplace add DevOtts/fable-it
/plugin install fable-it@devotts

Cualquier otro agente (Cursor, Codex, Copilot, 70+ herramientas):

npx skills add DevOtts/fable-it -a <agent>

Sin las habilidades empaquetadas, ejecuta cada fase en línea según las mecánicas anteriores — la capa de comportamiento es el producto; degrada, nunca rompas.

Consideraciones de seguridad

  • No se requieren secretos para instalar o ejecutar el skill. Proporcionas credenciales solo para el trabajo específico que le pides que haga.
  • Lee .full.credentials y .env solo localmente — nunca se transmiten, nunca se confirman.
  • La automatización del navegador utiliza tu propio Chrome a través del Protocolo de Herramientas de Desarrollo de Chrome (Chrome DevTools Protocol) en un puerto local, reutilizando tu sesión iniciada; nada se almacena ni se extrae. El trabajo en cuentas autenticadas siempre pasa por una confirmación por escritura — la QA autónoma es solo para entornos de prueba.
  • Cualquier credencial creada durante una ejecución se aisla en un artefacto de credenciales dedicado con notas de rotación — nunca enterrada en prosa.
  • Las acciones irreversibles siempre requieren autorización explícita previa; la autonomía cubre solo trabajo reversible.

Autoría de DevOtts.

Skills relacionados