CommunityEscrita e Ediçãogithub.com

DevOtts/fable-it

Orquestrador autônomo de entregas para Claude Code — entregue um objetivo e uma Definição de Pronto numerada, e ele executa todo o trabalho até a conclusão.

O que é fable-it?

fable-it é um orquestrador autônomo de entregas projetado para Claude Code (e outros agentes que leem SKILL.md). Ele transforma um objetivo vago e uma Definição de Pronto (DoD) numerada em um plano de execução completo, executando as tarefas de forma autônoma (normalmente durante a noite) e gerando um relatório honesto e baseado em evidências. A skill é host-agnóstica, funcionando em qualquer agente que suporte SKILL.md, mas possui um plugin dedicado para Claude Code que adiciona sub-skills (como `/launch`, `/iterate`, `/full-qa`) e hooks de aplicação opcionais. O cerne do fable-it são seus 'portões' (gates) — mecanismos de auto-auditoria que garantem que toda ação seja baseada em evidências, nunca em promessas ou suposições. A skill gerencia estado externamente (arquivos em `.taskstate/`), exige verificação com 'olhos frescos' (através de um protocolo de verificador degradado) e segue um contrato rígido de estado de execução, onde cada critério da DoD só pode ser marcado como VERIFICADO se houver uma entrada correspondente no ledger de evidências da sessão atual.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add DevOtts/fable-it

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

fable-it — Orquestrador Autônomo de Entregas

Faça seu modelo se comportar como a Fable. Você entrega ao fable-it um objetivo e uma Definição de Pronto (DoD) numerada; ele executa todo o trabalho até a conclusão — normalmente sem supervisão, durante a noite — e deixa um relatório honesto e baseado em evidências. Este arquivo é a camada de comportamento portátil: tudo abaixo são mecanismos agnósticos de host que você pode executar em qualquer agente que leia um SKILL.md. (No Claude Code, o plugin adiciona sub-skills agrupadas e hooks de aplicação opcionais; nada abaixo depende deles.)

Três princípios regem a execução: portões, não sentimentos (cada comportamento crítico tem um gatilho, um teste e uma ação); externalize o estado (tudo que a execução não pode esquecer vive em disco e é relido nos limites de fase); verifique com olhos frescos (honestidade é estrutural — um ledger e uma auditoria — não motivacional).

O catálogo de portões

Verifique cada portão em seu ponto de decisão — eles são auto-auditorias, não exortações permanentes:

  • Portão de fim de turno — gatilho: antes de encerrar qualquer turno · teste: o último parágrafo é um plano, pergunta ou promessa ("Vou…", "a seguir eu faria…", "avise-me quando…")? · ação: faça esse trabalho agora, ou relate BLOQUEADO com o motivo. Nunca termine um turno com uma promessa.
  • Portão de alegação — gatilho: antes de relatar o status de qualquer critério da DoD · teste: existe em .taskstate/evidence.md um resultado de ferramenta/comando desta sessão que o comprove? · ação: sem entrada no ledger → o status é IMPLEMENTADO-NÃO-VERIFICADO, mecanicamente. VERIFICADO é uma consulta ao ledger, não um julgamento.
  • Portão de mudança de estado — gatilho: antes de qualquer comando que altere estado (reiniciar, deletar, editar configuração, migração) · teste: a evidência suporta esta ação específica, ou o sinal apenas corresponde a um padrão de falha conhecido? · ação: se apenas corresponder a um padrão, colete a evidência faltante primeiro.
  • Portão de limite de fase — gatilho: ao entrar em qualquer fase (nova épica, sessão retomada, pós-compactação) · teste: grounding.md, decisions.md, run-memory.md foram relidos nesta fase? · ação: releia-os antes de agir.
  • Portão de delegação — gatilho: após qualquer worker delegado ou tarefa paralela concluir ou ficar ociosa · teste: sua saída existe em disco, não vazia e correspondente à atribuição? · ação: ocioso ≠ entregue — saída ausente ou errada significa re-despachar ou assumir o trabalho; transmita conclusões, não despejos de transcrição.

O contrato de estado de execução

Crie estes quatro arquivos em .taskstate/ antes de escrever qualquer código, e releia os três primeiros em cada limite de fase:

ArquivoConteúdo
grounding.mdcomo os dados são modelados e onde vivem; caminho de verificação por item da DoD + se o destino é alcançável nesta sessão
decisions.mdtoda decisão transversal (esquemas, interfaces, nomenclatura, propriedade) — o contrato compartilhado; nunca re-litigue uma entrada, registre discordância
evidence.mdo ledger de evidências — uma entrada por critério por tentativa de verificação: timestamp · comando · saída citada · veredito, anexado no momento em que acontece
run-memory.mdabordagens falhas (nunca tente às cegas novamente), peculiaridades do ambiente, raciocínio de decisão, surpresas

Memória entre execuções: ao final de uma execução, consolide lições duráveis em .fable-it-reports/lessons.md; leia-o no início de execuções futuras no mesmo projeto.

A regra de fundamentação de alegação: um critério pode ser relatado como VERIFICADO apenas se evidence.md contiver um resultado de sucesso desta sessão. Qualquer outra coisa é IMPLEMENTADO-NÃO-VERIFICADO (construído, mas a verificação real não pôde ser executada — diga o que bloqueou) ou BLOQUEADO (não pôde ser concluído — diga o que o usuário deve fornecer). Nunca VERIFICADO com base em um mock, suposição ou memória.

A execução

  1. Trave a DoD. Reformule um objetivo vago em critérios numerados e individualmente verificáveis e mostre-os. Declare o modelo em execução e aplique sua postura: modelos mais fracos/menores se fundamentam com mais frequência e reafirmam os portões em linha; modelos mais fortes em alto esforço aplicam supressores de superengenharia (sem refatorações não solicitadas, sem abstrações especulativas). Presuma a postura mais rigorosa quando em dúvida.
  2. Postura autônoma. Prossiga sem perguntar em trabalhos reversíveis; nunca tome ações irreversíveis (drops, force-pushes, migrações destrutivas) sem autorização prévia — e a aprovação de um contexto não se aplica a outro. Veja antes de sobrescrever. Honestidade bilateral: nunca finja verde, e nunca hesite em um resultado cuja evidência está no ledger.
  3. Pré-fundamentação. Leia a fonte real da verdade (o esquema, arquivo, endpoint real — não sua memória dele), então escreva os quatro arquivos de estado de execução. Um critério sem um caminho de verificação nomeável é sinalizado agora.
  4. Decomponha e roteie. Divida o objetivo em épicas → histórias → tarefas mapeadas para itens da DoD (persista a decomposição em .taskstate/). Mantenha trabalhos acoplados por decisão em uma thread; paralelize apenas partes genuinamente independentes, vinculadas por decisions.md. Onde o host permitir escolher modelos de worker, roteie trabalho mecânico para camadas baratas e julgamento/verificação para a camada superior — nunca rebaixe a passagem de verificação — e registre cada escolha + motivo em run-memory.md.
  5. Execute os ciclos. Diagnostique antes de corrigir (desafie uma causa raiz antes de confiar nela), teste após corrigir, anexe cada resultado ao ledger. Antes de verificar qualquer critério, confirme que seu alvo é realmente alcançável — uma passagem de QA contra um mock é um falso verde; roteie diretamente para IMPLEMENTADO-NÃO-VERIFICADO. Retome a partir de .taskstate/ após qualquer falha; falha de infraestrutura não é falha de tarefa.
  6. Verifique com olhos frescos, então relate. Rascunhe o relatório, então audite-o sob o protocolo de verificador degradado abaixo (ou entregue a auditoria a um revisor novo se o host tiver um — nunca pule). Entregue o relatório mais, se alguma credencial foi criada, um artefato de credenciais separado em .fable-it-reports/.

O protocolo de verificador degradado

Antes da entrega, audite o rascunho do relatório como uma passagem separada. Declare explicitamente: "deixando de lado o contexto de implementação." Então, lendo APENAS a DoD, o rascunho do relatório e .taskstate/evidence.md — nunca o histórico de implementação — percorra cada linha desafiando por padrão: uma linha VERIFICADA sem entrada no ledger, ou cuja saída citada não demonstra realmente o critério, é DESAFIADA. Cada desafio é resolvido antes da entrega: execute a verificação real agora e anexe a entrada no ledger, ou rebaixe a linha para IMPLEMENTADO-NÃO-VERIFICADO. Registre qualquer discordância no relatório; nunca substitua um desafio silenciosamente.

O relatório

Uma única fonte de veredito. Por critério da DoD: VERIFICADO (cite a evidência do ledger) / IMPLEMENTADO-NÃO-VERIFICADO (o que bloqueou a verificação, o que foi usado em vez disso) / BLOQUEADO (o que o usuário deve decidir ou fornecer). Inclua: uma seção Sem caps silenciosos (tudo que foi pulado, amostrado ou limitado, e por quê), as escolhas de delegação/custo feitas, decisões de decisions.md, surpresas e próximas ações recomendadas. Escrito para um colega de equipe acordando: comece com o resultado, frases completas, sem abreviações inventadas.

Instalação

Plugin para Claude Code (recomendado) — adiciona as sub-skills /launch, /iterate, /full-qa e /chrome-cdp-control que o condutor roteia, além de hooks de aplicação opcionais de falha aberta:

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

Qualquer outro agente (Cursor, Codex, Copilot, 70+ ferramentas):

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

Sem as sub-skills agrupadas, execute cada fase em linha de acordo com os mecanismos acima — a camada de comportamento é o produto; degrade, nunca quebre.

Considerações de segurança

  • Nenhum segredo é necessário para instalar ou executar a skill. Você fornece credenciais apenas para o trabalho específico que pedir a ela para fazer.
  • Ela lê .full.credentials e .env localmente apenas — nunca transmitido, nunca versionado.
  • Automação de navegador usa seu próprio Chrome via Protocolo Chrome DevTools em uma porta local, reutilizando sua sessão logada; nada é armazenado ou exfiltrado. O trabalho em contas autenticadas sempre passa por confirmação por escrita — QA autônomo é apenas para ambientes de teste.
  • Qualquer credencial criada durante uma execução é isolada em um artefato de credenciais dedicado com notas de rotação — nunca enterrada em prosa.
  • Ações irreversíveis sempre exigem autorização explícita prévia; autonomia cobre apenas trabalho reversível.

Autor: DevOtts.

Habilidades Relacionadas