fable-discipline

fable-discipline

Disciplina de fluxo de trabalho reutilizável para agentes Claude Code.

fable-discipline é um plugin do Claude Code que faz o trabalho de software agêntico seguir padrões de trabalho repetíveis: design antes do código, verificação após edições, separação entre autor e revisor, preservação do estado verificado entre sessões e relato honesto de incertezas.

Não é uma atualização de modelo nem um pacote mágico de prompts. Ele molda o procedimento, não a capacidade bruta — um checklist, não um transplante de capacidade. Não pode elevar o teto de raciocínio de um modelo.

Ele opera em um modelo de três camadas:

• O plugin — o COMO genérico: como planejar, construir, verificar, revisar, lembrar e relatar.
• Os docs do seu repositório — o O QUE local: CLAUDE.md, DESIGN.md, STATE.md guardam a verdade do produto.
• Seu prompt — o objetivo atual: ex. "Revise o novo fluxo de onboarding."

Instalação

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

Ou adicione o marketplace a partir de um caminho local ou URL git e, em seguida, instale.

Como os usuários realmente usam isso

Você não lê as skills manualmente antes de cada sessão. Instale o plugin e trabalhe normalmente no Claude Code. A skill relevante é aplicada automaticamente com base na situação.

Exemplos 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 trabalho sério de produto, use os comandos explícitos de marco:

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

Use-os em ordem. Aprove o documento de design entre a pesquisa e a construção.

Qual comando devo executar?

Situação	O que fazer
Você ainda não sabe o que construir	/milestone-research name
Você tem um design aprovado e quer a implementação	/milestone-build name
Você quer uma revisão antes de merge, release ou deploy	/milestone-review name
Você está construindo uma CLI, plugin, servidor MCP, biblioteca, SDK ou pacote de skills	Descreva o artefato. artifact-build deve ser acionado.
Você está redesenhandando UI ou usando saída do Stitch/Figma	Descreva o redesenho. design-workflow deve ser acionado.
Você está executando auditorias, varreduras, benchmarks ou relatórios recorrentes	Descreva o trabalho de medição. measurement-pipeline deve ser acionado.
Você está testando uma hipótese ou escrevendo um relatório baseado em evidências	Descreva a investigação. research-investigation deve ser acionado.
Você está depurando uma falha ou regressão relatada	Descreva o bug. diagnostic-loop deve ser acionado.
Você está delegando a subagentes ou executando loops	Descreva o fan-out. agent-orchestration deve ser acionado.
Você está retomando trabalho antigo	Peça ao Claude para ler o estado primeiro. compounding-memory deve ser acionado.

Os três fluxos principais

1. Entregar um marco de produto

Use isso para trabalho de funcionalidade dentro de um aplicativo existente.

/milestone-research checkout-redesign

Comportamento esperado: Claude lê o CLAUDE.md do repositório, pesquisa a funcionalidade, verifica restrições e escreve um documento de design escopado. Ele não deve começar a codificar ainda.

/milestone-build checkout-redesign

Comportamento esperado: Claude constrói a partir do design aprovado em etapas atômicas e verificadas. Ele executa as verificações mínimas significativas do repositório após cada etapa.

/milestone-review checkout-redesign

Comportamento esperado: Claude executa uma revisão adversarial, classifica os achados honestamente e os corrige em lotes numerados.

2. Construir um artefato independente

Use isso para CLIs, servidores MCP, plugins, bibliotecas, SDKs e pacotes de skills.

Exemplo:

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.

Comportamento esperado: especificação de design primeiro, plano de implementação em segundo lugar, construção modular com TDD, passada de revisão, validação ao vivo, empacotamento de release.

3. Redesenhar a UI do produto

Use isso ao criar um design system, escrever um contrato de DESIGN.md, gerar telas no Stitch/Figma ou portar UI gerada para código.

Exemplo:

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.

Comportamento esperado: ler o contrato de design completo, portar tela por tela, evitar números falsos e clichês genéricos de UI de IA e verificar contra o viewport real.

Skills

Cada skill é pequena, componível e acionada por situação. Detalhes compartilhados vivem em skills/<name>/references/ para que as mesmas instruções não sejam duplicadas.

Construção e entrega

Skill	Rótulo visível ao usuário	Aciona quando	Disciplina
milestone-workflow	Entregar um marco	Entregando uma funcionalidade dentro de um aplicativo existente	Pesquisa e design, depois construção, depois revisão adversarial. Também alimenta /milestone-research, /milestone-build, /milestone-review.
artifact-build	Construir um artefato	Construindo uma CLI, servidor MCP, biblioteca, plugin, SDK ou pacote de skills	Especificação de design, plano TDD com checkboxes, construção modular, passada de revisão, validação ao vivo, empacotamento de release.
design-workflow	Fluxo de trabalho de design system	Construindo ou redesenhandando a UI do produto	Contrato de DESIGN.md, telas geradas portadas para código, verificação contra o contrato e a tela renderizada.

Investigação e medição

Skill	Rótulo visível ao usuário	Aciona quando	Disciplina
research-investigation	Pesquisa com controles	Análise empírica, forense, engenharia reversa, relatórios baseados em evidências	Pré-registro, controles positivos e negativos, negativos calibrados, registro de engajamento de fontes, ressalvas limitadas por capacidade.
measurement-pipeline	Auditoria de medição	Auditorias recorrentes, matrizes de benchmark, varreduras, dashboards	Contabilidade completa de lacunas, evidência como prova, classificação de falha de infraestrutura vs. real, execução recorrente com um comando, relatório para stakeholders.
diagnostic-loop	Loop de diagnóstico	Depurando uma falha relatada, regressão ou comportamento inesperado	Reproduzir no sistema real, observar nas fronteiras, uma hipótese comprovada pela menor sonda, corrigir na raiz, duas correções falhas → questionar o modelo mental.

Suporte sempre ativo

Skill	Rótulo visível ao usuário	Aciona quando	Disciplina
agent-orchestration	Orquestração de agentes	Multiagente, fan-out, delegação, loops	Roteamento por nível de modelo, verificador não é autor, loops com portão de rubrica, fluxos de trabalho dinâmicos, isolamento de worktree.
compounding-memory	Memória de projeto	STATE.md, MEMORY.md, retomar trabalho, persistência	Falhar, investigar, verificar, destilar, consultar. Escrever antes de sair, ler no início, marcar fatos com Verified-by:.
execution-rules	Disciplina de execução	Qualquer codificação prática ou tarefa de agente	Seguimento literal de instruções, calibração de pensamento, contexto suficiente, agir e depois verificar, sem "AI slop".

Quando um repositório já tem sua própria camada de processo

Se um repositório impõe seu próprio sistema de fluxo de trabalho (um conjunto de comandos estilo GSD, o plugin superpowers, um plugin de processo corporativo), a camada do repositório vence — não empilhe dois frameworks de processo na mesma tarefa. fable-discipline é o padrão portátil para repositórios e máquinas que não têm essa camada; em um repositório que tem, use apenas as skills do fable-discipline que preenchem uma lacuna que a camada local não cobre e siga a camada local para todo o resto.

Documentação

• Como usar isso
• Exemplos de copiar e colar
• Solução de problemas — quando o agente sai dos trilhos

Configuração sugerida do repositório

O plugin funciona melhor quando cada projeto tem um 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

O plugin fornece a disciplina de trabalho. O repositório fornece comandos, restrições e a verdade do produto.

Contribuindo

A coleção cresce destilando padrões de fluxo de trabalho repetíveis a partir de trabalho agêntico real. Contribua com padrões de trabalho, nunca texto proprietário.

Veja CONTRIBUTING.md para o método e a linha ética. Veja PROVENANCE.md para atribuição de fontes.