fable-discipline

fable-discipline

Disciplina de flujo de trabajo reutilizable para agentes de Claude Code.

fable-discipline es un plugin de Claude Code que hace que el trabajo de software agéntico siga patrones de trabajo repetibles: diseño antes de código, verificación después de ediciones, separar autor de revisor, preservar el estado verificado entre sesiones y reportar la incertidumbre con honestidad.

No es una mejora del modelo ni un paquete de prompts mágico. Da forma al procedimiento, no a la capacidad bruta: una lista de verificación, no un trasplante de capacidad. No puede elevar el techo de razonamiento de un modelo.

Funciona con un modelo de tres capas:

• El plugin — el CÓMO genérico: cómo planificar, construir, verificar, revisar, recordar y reportar.
• Los docs de tu repo — el QUÉ local: CLAUDE.md, DESIGN.md, STATE.md contienen la verdad del producto.
• Tu prompt — el objetivo actual: p. ej. "Revisa el nuevo flujo de incorporación."

Instalación

/plugin marketplace add petrkindlmann/fable-discipline
/plugin install fable-discipline@kindlmann-workflows

O añade el marketplace desde una ruta local o URL de git, y luego instala.

Cómo lo usan realmente los usuarios

No lees las skills manualmente antes de cada sesión. Instala el plugin y luego trabaja con normalidad en Claude Code. La skill relevante se aplica automáticamente según la situación.

Ejemplos de prompts:

Plan the next billing milestone.
Build the analytics dashboard redesign.
Review the v1.8 changes before I merge.
Resume where we left off and check the project state first.
Build a CLI that scans Playwright tests for flaky selectors.

Para trabajo serio de producto, usa los comandos explícitos de hitos:

/milestone-research checkout-redesign
/milestone-build checkout-redesign
/milestone-review checkout-redesign

Úsalos en orden. Aprueba el documento de diseño entre la investigación y la construcción.

¿Qué comando debería ejecutar?

Situación	Qué hacer
Aún no sabes qué construir	/milestone-research name
Tienes un diseño aprobado y quieres implementación	/milestone-build name
Quieres una revisión antes del merge, release o deploy	/milestone-review name
Estás construyendo una CLI, plugin, servidor MCP, librería, SDK o paquete de skills	Describe el artefacto. artifact-build debería activarse.
Estás rediseñando UI o usando salida de Stitch/Figma	Describe el rediseño. design-workflow debería activarse.
Estás ejecutando auditorías, escaneos, benchmarks o informes recurrentes	Describe el trabajo de medición. measurement-pipeline debería activarse.
Estás probando una hipótesis o escribiendo un informe respaldado por evidencia	Describe la investigación. research-investigation debería activarse.
Estás depurando una falla o regresión reportada	Describe el bug. diagnostic-loop debería activarse.
Estás delegando a subagentes o ejecutando bucles	Describe el fan-out. agent-orchestration debería activarse.
Estás retomando trabajo antiguo	Pide a Claude que lea el estado primero. compounding-memory debería activarse.

Los tres flujos principales

1. Entregar un hito de producto

Úsalo para trabajo de funcionalidades dentro de una app existente.

/milestone-research checkout-redesign

Comportamiento esperado: Claude lee el CLAUDE.md del repo, investiga la funcionalidad, verifica restricciones y escribe un documento de diseño acotado. No debería empezar a codificar todavía.

/milestone-build checkout-redesign

Comportamiento esperado: Claude construye a partir del diseño aprobado en pasos atómicos y verificados. Ejecuta las verificaciones más pequeñas y significativas del repo después de cada paso.

/milestone-review checkout-redesign

Comportamiento esperado: Claude ejecuta una revisión adversarial, clasifica los hallazgos con honestidad y los corrige en lotes numerados.

2. Construir un artefacto independiente

Úsalo para CLIs, servidores MCP, plugins, librerías, SDKs y paquetes de skills.

Ejemplo:

Build a new CLI that scans Playwright tests and reports flaky selectors. Start with a design spec, then a checkbox implementation plan, then build it with tests.

Comportamiento esperado: especificación de diseño primero, plan de implementación después, construcción modular con TDD, pasada de revisión, validación en vivo, empaquetado de release.

3. Rediseñar la UI del producto

Úsalo al crear un sistema de diseño, escribir un contrato de DESIGN.md, generar pantallas en Stitch/Figma o portar UI generada a código.

Ejemplo:

Create a DESIGN.md contract for the analytics dashboard, then port the generated Stitch screen into real components. Verify the implementation against both the screen and the contract.

Comportamiento esperado: leer el contrato de diseño completo, portar pantalla por pantalla, evitar números falsos y clichés genéricos de UI de IA, y verificar contra el viewport real.

Skills

Cada skill es pequeña, componible y activada por situación. El detalle compartido vive en skills/<name>/references/ para que las mismas instrucciones no se dupliquen.

Construcción y entrega

Skill	Etiqueta visible para el usuario	Se activa cuando	Disciplina
milestone-workflow	Entregar un hito	Entregar una funcionalidad dentro de una app existente	Investigación y diseño, luego construcción, luego revisión adversarial. También impulsa /milestone-research, /milestone-build, /milestone-review.
artifact-build	Construir un artefacto	Construir una CLI, servidor MCP, librería, plugin, SDK o paquete de skills	Especificación de diseño, plan TDD con casillas, construcción modular, pasada de revisión, validación en vivo, empaquetado de release.
design-workflow	Flujo de trabajo de sistema de diseño	Construir o rediseñar la UI del producto	Contrato de DESIGN.md, pantallas generadas portadas a código, verificación contra el contrato y la pantalla renderizada.

Investigación y medición

Skill	Etiqueta visible para el usuario	Se activa cuando	Disciplina
research-investigation	Investigación con controles	Análisis empírico, forense, ingeniería inversa, informes respaldados por evidencia	Pre-registro, controles positivos y negativos, negativos calibrados, registro de compromiso con fuentes, advertencias limitadas por capacidad.
measurement-pipeline	Auditoría de medición	Auditorías recurrentes, matrices de benchmark, escaneos, dashboards	Contabilidad completa de brechas, evidencia como prueba, clasificación de fallas de infraestructura vs. reales, ejecución recurrente con un comando, informe para stakeholders.
diagnostic-loop	Bucle de diagnóstico	Depurar una falla reportada, regresión o comportamiento inesperado	Reproducir en el sistema real, observar en los límites, una hipótesis probada por la sonda más pequeña, corregir en la raíz, dos correcciones fallidas → cuestionar el modelo mental.

Soporte siempre activo

Skill	Etiqueta visible para el usuario	Se activa cuando	Disciplina
agent-orchestration	Orquestación de agentes	Multi-agente, fan-out, delegación, bucles	Enrutamiento por nivel de modelo, el verificador no es el autor, bucles gobernados por rúbrica, flujos de trabajo dinámicos, aislamiento de worktree.
compounding-memory	Memoria del proyecto	STATE.md, MEMORY.md, retomar trabajo, persistencia	Fallar, investigar, verificar, destilar, consultar. Escribir antes de irse, leer al inicio, etiquetar hechos con Verified-by:.
execution-rules	Disciplina de ejecución	Cualquier tarea práctica de codificación o de agente	Seguimiento literal de instrucciones, calibración del pensamiento, contexto suficiente, actuar y luego verificar, sin basura de IA.

Cuando un repo ya tiene su propia capa de proceso

Si un repo impone su propio sistema de flujo de trabajo (un conjunto de comandos estilo GSD, el plugin superpowers, un plugin de proceso de empresa), la capa del repo gana: no apiles dos marcos de proceso sobre la misma tarea. fable-discipline es el predeterminado portable para repos y máquinas que no tienen esa capa; en un repo que sí la tiene, usa solo las skills de fable-discipline que llenen un vacío que la capa local no cubre, y sigue la capa local para todo lo demás.

Documentación

• Cómo usar esto
• Ejemplos de copiar y pegar
• Solución de problemas — cuando el agente se sale de los rieles

Configuración sugerida del repo

El plugin funciona mejor cuando cada proyecto tiene un CLAUDE.md claro:

# CLAUDE.md

## Verify commands
- npm run lint
- npm run typecheck
- npm test

## Deploy model
Describe what deploys on push, what requires approval, and what must not be touched casually.

## Project-specific rules
List the product's moat, data honesty rules, commit style, and file locations.

## State files
- .planning/STATE.md
- .planning/ROADMAP.md

El plugin proporciona la disciplina de trabajo. El repo proporciona comandos, restricciones y la verdad del producto.

Contribuciones

La colección crece destilando patrones de trabajo repetibles a partir de trabajo agéntico real. Contribuye patrones de trabajo, nunca texto propietario.

Consulta CONTRIBUTING.md para el método y la línea ética. Consulta PROVENANCE.md para la atribución de fuentes.