illuminatedworm/terrarium-tavern

Usado apenas quando o usuário solicita explicitamente a revisão de um plano existente. Questiona decisões implícitas, adiciona verificações objetivas e comparação com protótipos conforme necessário, gera uma segunda versão do plano substituindo o original, sem iniciar a implementação.

O que é terrarium-tavern?

Esta skill, 'illuminatedworm/terrarium-tavern', é uma ferramenta especializada para revisão crítica de planos de desenvolvimento, projetada para agentes AI como Claude Code, Cursor ou Codex. Quando um plano já existe e o usuário pede explicitamente sua revisão, a skill analisa o documento preservando seus objetivos gerais, escopo e design razoável, sem refazer a elicitação de requisitos. Ela realiza três etapas principais: (1) 'Grill' (obrigatório) - identifica decisões implícitas ou omissões de alto impacto no plano, como defaults, tratamento de erros e limites de APIs, desafiando suposições com contraexemplos específicos; (2) 'Oracle' (opcional) - adiciona critérios de aceitação objetivos e verificáveis, usando fontes confiáveis, especificações e invariantes, sem confiar em autoavaliação do modelo; (3) 'Prototype' (opcional) - permite a criação de protótipos mínimos para comparação subjetiva quando a aparência ou interação são críticas, desde que autorizado. O resultado é uma segunda versão completa do plano, integrando as decisões e verificações acordadas, pronta para implementação posterior, sem que a skill prossiga para a execução.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/illuminatedworm/terrarium-tavern/tree/HEAD/.agents/skills/plan-refine

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Reveja a versão mais recente do plano, mantendo os objetivos originais, escopo e design razoável, sem refazer a elicitação de requisitos. Primeiro, consulte o projeto e a documentação, não pergunte novamente sobre o que já foi respondido; se o plano original estiver faltando, solicite-o.

1. Grill: Decisões Implícitas (Obrigatório)

Identifique decisões que o plano tomou secretamente pelo usuário ou omissões de alto impacto. Percorra o fluxo do usuário verificando valores padrão, tratamento de erros/cancelamento/repetição, restauração de estado, contratos entre módulos, migração de compatibilidade e limites de permissão. Desafie suposições com contraexemplos concretos, sem seguir uma lista de verificação mecânica.

Pergunte apenas sobre escolhas reais que alterem significativamente a experiência, arquitetura, dados, segurança ou custo; fatos verificáveis e detalhes de baixo custo e reversíveis podem ser resolvidos por conta própria. Para cada pergunta, explique a suposição/lacuna, consequência e sugestão. É permitido múltiplas rodadas com muitas perguntas por rodada, numeradas por tópico, começando pelas decisões prévias; aguarde a resposta antes de finalizar, o silêncio não é considerado concordância.

2. Oracle: Verificação Objetiva (Opcional)

Ative quando houver critérios objetivos confiáveis e com custo razoável; o usuário pode pular esta etapa. Para requisitos críticos, especifique a fonte do critério, o método de verificação e a condição de aprovação; priorize especificações, implementações de referência, exemplos confirmados pelo usuário e invariantes. Para tarefas de otimização, liste a linha de base, métricas e restrições que não podem ser degradadas. Não confunda autoavaliação do modelo ou métricas de proxy com a verdade; para partes que não podem ser verificadas automaticamente, mantenha a aceitação manual.

3. Prototype: Comparação Subjetiva (Opcional)

Ative apenas quando a aparência ou a sensação da interação afetar a solução e o texto por si só não for suficiente para decidir; o usuário pode pular esta etapa. Use referências ou protótipos mínimos com diferenças substanciais para permitir que o usuário compare e escolha, sem continuar perguntando sobre preferências abstratas. Crie protótipos isolados apenas se o modo atual permitir e o usuário tiver autorizado; caso contrário, escreva na segunda versão do plano a etapa de "comparação de protótipos → escolha do usuário → implementação relacionada" e mantenha os itens pendentes correspondentes. Sem ter mostrado ou comparado, não afirme que algo foi validado.

Convergência

Converja depois que decisões importantes forem confirmadas, delegadas explicitamente ou adiadas; também convirja se o usuário solicitar o fim. Produza uma segunda versão completa e independente do plano, integrando as decisões, etapas de implementação e os pontos de verificação/portões de protótipo aplicáveis, com uma breve lista de mudanças e suposições restantes; para itens adiados, indique quando serão decididos e o que bloqueiam. Não entregue apenas um questionário ou patches, não afirme que todos os riscos foram explorados. Após a saída, pare, não implemente nem reinicie a revisão.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas