Ferramentas de Ciclo de Vida de Specs (Stream B)
O Stream B contém todas as ferramentas que gerenciam o ciclo de vida completo das specs — desde a primeira pergunta de esclarecimento até a entrega de uma spec pronta para produção a um agente de IA.
Referência Rápida
| Ferramenta | Descrição | Disponibilidade |
|---|---|---|
facilitate | Ponto de entrada sem conhecimento prévio — descreva o que deseja construir | Incluída |
clarify_requirements | Esclareça requisitos de forma interativa antes de criar uma spec | Incluída |
elicit_requirements | Elicitação avançada e interativa de requisitos | Incluída |
create_spec | Crie uma spec SDD completa a partir de uma descrição | Incluída |
list_specs | Liste todas as specs de um projeto, filtre por status | Incluída |
update_status | Mova uma spec pelas etapas do seu ciclo de vida | Incluída |
summarize_spec | Gere um resumo curto e legível de uma spec | Incluída |
spec_history | Visualize o histórico de alterações de uma spec | Incluída |
reconcile_spec | Atualize uma spec para corresponder ao que foi realmente construído | Incluída |
branch_spec | Crie um branch de spec para experimentação | Incluída |
merge_spec_branch | Mescle um branch experimental de spec de volta à spec principal | Incluída |
version_spec | Crie um snapshot versionado de uma spec | Incluída |
spec_diff | Compare duas versões de spec e mostre as diferenças | Incluída |
export_spec | Exporte uma spec para um formato externo (spec-kit) | Incluída |
check_readiness | Verifique se uma spec tem detalhes suficientes para iniciar a implementação | Incluída |
challenge_spec | Teste uma spec sob pressão simulando falhas e casos extremos | Incluída |
red_team | Revisão adversarial — argumenta contra a spec a partir dos princípios básicos | Incluída |
detect_contradictions | Detecte contradições e inconsistências dentro ou entre specs | Incluída |
manage_scope | Gerencie e controle o escopo para evitar scope creep | Incluída |
package_handoff | Empacote uma spec e suas dependências para handoff a agente ou equipe | Incluída |
decompose_spec | Decomponha automaticamente uma spec em tarefas independentes para agentes | Incluída |
analyze_spec_dependencies | Analise grafo de dependências: caminho crítico, deps circulares, ondas | Incluída |
generate_checklist | Gere um checklist de implementação a partir de uma spec | Incluída |
check_spec_accuracy | Valide uma spec contra a implementação real da base de código | Incluída |
spec_coverage | Gere um relatório de cobertura mostrando specs vs. implementação | Incluída |
spec_usage_report | Relatório mostrando quais specs os agentes estão usando ativamente | Incluída |
semantic_search | Pesquise specs e conhecimento do projeto por significado | Incluída |
list_templates | Navegue pelo catálogo de templates de spec integrados e personalizados | Incluída |
apply_template | Crie arquivos de spec a partir de um template | Incluída |
capture_idea | Capture uma ideia leve sem criar uma spec completa | Incluída |
list_backlog | Liste todas as ideias capturadas no backlog do projeto | Incluída |
promote_idea | Promova uma ideia do backlog para uma spec completa | Incluída |
discard_idea | Marque uma ideia do backlog como descartada | Incluída |
session_checkpoint | Salve um checkpoint de sessão com o contexto atual | Incluída |
planu_status | Obtenha um snapshot compacto do estado atual do projeto | Incluída |
log_lesson | Registre uma lição aprendida de uma spec ou experiência de projeto | Incluída |
list_lessons | Liste as lições aprendidas de um projeto | Incluída |
delete_spec | Exclua uma ou mais specs de um projeto | Incluída |
delete_project | Exclua todos os dados de um projeto | Incluída |
delete_pattern | Exclua um ou mais padrões aprendidos | Incluída |
delete_decision | Exclua uma ou mais decisões/ADRs | Incluída |
manage_trash | Gerencie a lixeira: listar, restaurar ou purgar | Incluída |
generate_spec_dashboard | Regenere o dashboard planu/index.html | Incluída |
Fluxo Principal
facilitate
Ponto de entrada sem conhecimento prévio — descreva o que deseja construir e o Planu determina os próximos passos.
Quando usar: Quando você não sabe por onde começar. Apenas descreva sua ideia ou objetivo em linguagem natural e facilitate determinará se deve esclarecer requisitos, criar uma spec ou sugerir a próxima ação.
Prompt: "I want to add Stripe payments to my app"
Prompt: "Help me plan a multi-tenant permission system"TIP
facilitate é o melhor ponto de partida para novos usuários. Ele elimina a necessidade de conhecer nomes de ferramentas — basta descrever o que você quer construir.
clarify_requirements
Gere perguntas de esclarecimento direcionadas antes de criar uma spec.
Quando usar: Antes de create_spec quando os requisitos são ambíguos, vieram de uma conversa verbal rápida ou envolvem múltiplos sistemas.
O que produz: Uma lista priorizada de perguntas cobrindo limites de escopo, casos extremos, requisitos não funcionais, tratamento de erros e dependências externas.
Prompt: "Use planu to clarify requirements for adding Stripe payments to project proj_abc123"TIP
Executar clarify_requirements primeiro resulta em critérios de aceitação significativamente mais completos e menos revisões de spec. É um investimento de 30 segundos que economiza horas.
elicit_requirements Pro
Elicitação avançada e interativa de requisitos — um modo de entrevista estruturada que vai além do clarify_requirements.
Quando usar: Para funcionalidades complexas, migrações de plataforma ou integrações envolvendo múltiplos stakeholders. A ferramenta guia a conversa com perguntas de acompanhamento baseadas nas suas respostas, em vez de apresentar uma lista plana.
Prompt: "Elicit requirements for the new reporting module in project proj_abc123"create_spec
Crie uma spec SDD completa com seções geradas automaticamente.
O que gera:
| Seção | Descrição |
|---|---|
| User Story | Quem, o quê, por quê no formato padrão |
| Critérios de Aceitação | Critérios testáveis e sem ambiguidade numerados para rastreabilidade |
| Checklist DoR | Portões de Definição de Pronto |
| Dicas de Schema de Banco de Dados | Tabelas, colunas, relações, índices |
| Contratos de UI | Contratos de componentes, fluxo de dados, gerenciamento de estado |
| Dicas de ADR | Architecture Decision Records |
| PLAN.md | Plano de execução RED/GREEN/VERIFY passo a passo |
Extras de IA nativa (quando arquitetura de IA é detectada):
- Orçamentos de latência e cadeias de fallback
- Critérios de versionamento de prompts
- Requisitos de observabilidade de LLM
Extras de frontend (quando configuração de performance é detectada):
- Critérios de Core Web Vitals
- Requisitos de hidratação SSR
- Definições de limites MFE
Prompt: "Create a spec for adding Google OAuth authentication to my project proj_abc123"list_specs
Liste todas as specs de um projeto, opcionalmente filtrando por status.
Quando usar: Para ver o que está no backlog, o que está em progresso ou o que precisa de revisão.
Prompt: "List all specs for project proj_abc123"
Prompt: "Show me specs in progress for project proj_abc123"
Prompt: "What specs are blocked in project proj_abc123?"update_status
Transite uma spec pelo seu ciclo de vida com validação DoR/DoD em cada etapa.
Fluxo de status: draft → ready → in_progress → review → done
Cada transição valida o checklist apropriado. Você não pode marcar uma spec como done sem satisfazer seus critérios DoD.
Prompt: "Update status of spec SPEC-003 to in_progress in project proj_abc123"
Prompt: "Mark spec SPEC-007 as done in project proj_abc123"summarize_spec
Gere um resumo conciso de uma spec — útil para atualizações da equipe, descrições de PR ou notas de standup.
Prompt: "Summarize spec SPEC-005 for project proj_abc123"Gerenciamento do Ciclo de Vida de Specs
spec_history Pro
Visualize o histórico de alterações de uma spec — quem alterou o quê, quando e por quê.
Quando usar: Ao investigar por que uma spec foi alterada, durante auditorias ou ao resolver disputas sobre specs.
Prompt: "Show history for spec SPEC-003 in project proj_abc123"reconcile_spec Pro
Reconcilie uma spec com mudanças de implementação, com aprovação por mudança e verificação de conformidade com a Constituição.
Quando usar: Quando a implementação divergiu intencionalmente da spec e você precisa atualizar a spec para corresponder à realidade.
A ferramenta apresenta cada mudança para aprovação — você decide o que se torna a nova verdade da spec.
Prompt: "Reconcile spec SPEC-004 with the implementation changes in project proj_abc123"branch_spec Pro
Crie um branch de spec para experimentação — permite explorar uma grande mudança de spec sem tocar na spec principal.
Quando usar: Quando você quer prototipar uma abordagem alternativa para uma spec (arquitetura diferente, escopo diferente) antes de se comprometer com ela.
Prompt: "Create a branch of spec SPEC-012 called 'microservices-approach' in project proj_abc123"merge_spec_branch Pro
Mescle um branch experimental de spec de volta à spec principal após validação.
Prompt: "Merge the 'microservices-approach' branch of spec SPEC-012 into main in project proj_abc123"version_spec Pro
Crie um snapshot versionado de uma spec — útil para rastreamento de marcos e handoffs externos.
Quando usar: Antes de uma release importante, antes de fazer handoff para uma equipe externa, ou para fixar uma linha de base antes de uma grande refatoração.
Prompt: "Create version v1.0 snapshot of spec SPEC-008 in project proj_abc123"spec_diff Pro
Compare duas versões de spec e mostre um diff estruturado do que mudou.
Prompt: "Show the diff between v1.0 and v2.0 of spec SPEC-008 in project proj_abc123"export_spec Pro
Exporte uma spec para um formato externo (spec-kit) para compartilhamento fora do Planu.
Prompt: "Export spec SPEC-010 to spec-kit format for project proj_abc123"Portões de Qualidade
check_readiness Pro
Avalie se uma spec está pronta para implementação — completude, qualidade dos critérios e status de dependências.
Verificações realizadas:
- Todos os critérios de aceitação são testáveis e sem ambiguidade?
- Todas as dependências bloqueantes foram resolvidas?
- O checklist DoR está completo?
- A spec passa na verificação de conformidade com a Constituição?
Prompt: "Check if spec SPEC-006 is ready for implementation in project proj_abc123"challenge_spec Pro
Teste uma spec sob pressão simulando falhas, alto tráfego, casos extremos e condições adversariais.
Quando usar: Antes de aprovar uma spec para um sistema crítico, ou após uma grande revisão de spec.
Prompt: "Challenge spec SPEC-009 in project proj_abc123"red_team Pro
Revisão adversarial — argumenta contra a spec a partir dos princípios básicos antes da aprovação.
Quando usar: Para specs de alto risco (faturamento, autenticação, migração de dados) onde você quer uma revisão do "advogado do diabo" antes de fixar o design.
Prompt: "Red team spec SPEC-011 in project proj_abc123"detect_contradictions Pro
Analise todas as specs de um projeto em busca de contradições semânticas.
Quando usar: Antes de iniciar um sprint, após uma grande mudança de produto ou quando specs foram atualizadas independentemente por diferentes membros da equipe.
Prompt: "Detect contradictions in the specs for project proj_abc123"Exemplo de saída: "SPEC-002 diz que usuários podem excluir contas. SPEC-008 diz que dados de conta são imutáveis para fins de auditoria."
Escopo & Empacotamento
manage_scope Pro
Gerencie a definição de escopo do projeto e o backlog — adicione itens, remova, repriorize ou exporte como um backlog estruturado.
Prompt: "Add 'dark mode support' to the backlog for project proj_abc123 with priority high"
Prompt: "Show the current backlog for project proj_abc123"package_handoff Pro
Gere um pacote de handoff estruturado para um agente de IA implementar uma spec.
O que produz:
- Objetivo de implementação
- Critérios de aceitação numerados
- Lista de arquivos com propriedade
- Restrições e limites
- Prompt pronto para colar para o Claude ou qualquer agente de IA
Quando usar: Ao delegar a implementação para uma sessão autônoma de agente de IA ou um membro da equipe que não participou da criação da spec.
Prompt: "Package spec SPEC-009 for handoff in project proj_abc123"decompose_spec Pro
Decomponha automaticamente uma spec em tarefas independentes para agentes com propriedade exclusiva de arquivos — pronta para execução em paralelo.
Quando usar: Para specs grandes que podem ser divididas entre múltiplos agentes ou membros da equipe. A ferramenta garante propriedade exclusiva de arquivos por tarefa para evitar conflitos.
Prompt: "Decompose spec SPEC-015 into parallel agent tasks in project proj_abc123"analyze_spec_dependencies Pro
Analise o grafo de dependências de specs: encontre o caminho crítico, detecte dependências circulares e compute ondas de execução.
Prompt: "Analyze spec dependencies for project proj_abc123"
Prompt: "What is the critical path to ship SPEC-020 in project proj_abc123?"Qualidade & Cobertura
generate_checklist Pro
Gere um checklist de qualidade para uma spec — cobre prontidão de implementação, cobertura de testes, documentação, segurança e performance.
Prompt: "Generate a quality checklist for spec SPEC-002 in project proj_abc123"check_spec_accuracy Pro
Verifique a precisão de uma spec contra a realidade da implementação — checa se critérios de aceitação, referências de arquivos e detalhes técnicos ainda estão corretos.
Quando usar: Após mudanças significativas no código, antes de uma release ou quando uma spec não foi revisada há algum tempo.
Prompt: "Check accuracy of spec SPEC-005 for project proj_abc123"spec_coverage Pro
Analise a cobertura de specs no projeto — identifica áreas da base de código sem specs e specs sem implementação correspondente.
Quando usar: Durante o planejamento de sprints, revisões trimestrais ou ao integrar novos membros para entender lacunas de documentação.
Prompt: "Show spec coverage for project proj_abc123"spec_usage_report Pro
Gere um relatório de observabilidade de specs mostrando quais specs os agentes estão usando ativamente, quais estão desatualizadas e quais são referenciadas com mais frequência.
Prompt: "Show spec usage report for project proj_abc123"semantic_search Pro
Pesquise o conhecimento do projeto (specs, padrões, decisões, conhecimento aprendido) por significado — não apenas correspondência por palavra-chave.
Quando usar: Quando você lembra que algo foi decidido mas não consegue encontrá-lo por palavra-chave, ou ao procurar specs relacionadas a um tópico em um projeto grande.
Prompt: "Search for anything related to rate limiting in project proj_abc123"
Prompt: "Find specs about user permissions in project proj_abc123"Templates
list_templates
Liste todos os templates de spec disponíveis com suas descrições e casos de uso.
Prompt: "List available spec templates"apply_template Pro
Aplique um template de spec para criar rapidamente specs para padrões comuns (CRUD, auth, integração, etc.).
Quando usar: Ao criar uma spec que segue um padrão bem conhecido e você quer um ponto de partida com seções pré-preenchidas.
Prompt: "Apply the CRUD template for a users resource in project proj_abc123"Gerenciamento de Backlog
capture_idea
Capture uma ideia leve ou possibilidade futura sem criar uma spec completa. As ideias ficam no backlog até serem promovidas ou descartadas.
Prompt: "Capture idea: add offline mode support to project proj_abc123"list_backlog
Liste todas as ideias capturadas no backlog do projeto.
Prompt: "Show backlog for project proj_abc123"promote_idea
Promova uma ideia do backlog para uma spec completa, acionando o fluxo normal de criação de specs.
Prompt: "Promote idea IDEA-003 to a spec in project proj_abc123"discard_idea
Marque uma ideia do backlog como descartada com um motivo opcional.
Prompt: "Discard idea IDEA-005 in project proj_abc123 — not aligned with roadmap"Sessões & Lições
session_checkpoint
Salve um checkpoint de sessão com o contexto atual, progresso e perguntas em aberto — útil para retomar sessões longas.
Prompt: "Save a session checkpoint for project proj_abc123"planu_status
Obtenha um snapshot compacto do estado atual do projeto Planu — spec ativa, estado do git, fila e atividade recente. Projetado para caber em aproximadamente 150 tokens.
Prompt: "What's the current status of project proj_abc123?"log_lesson
Registre uma lição aprendida de uma spec ou experiência de projeto — armazenada como conhecimento pesquisável do projeto.
Prompt: "Log lesson: always run detect_contradictions before sprint planning in project proj_abc123"list_lessons
Liste todas as lições aprendidas de um projeto.
Prompt: "Show lessons learned for project proj_abc123"Limpeza
delete_spec
Exclua uma ou mais specs de um projeto. As specs excluídas são movidas para a lixeira e podem ser restauradas.
Prompt: "Delete spec SPEC-017 from project proj_abc123"delete_project
Exclua todos os dados de um projeto. Esta ação move todos os dados para a lixeira antes da remoção permanente.
Prompt: "Delete project proj_abc123"delete_pattern
Exclua um ou mais padrões aprendidos de um projeto.
Prompt: "Delete pattern PAT-002 from project proj_abc123"delete_decision
Exclua uma ou mais decisões/ADRs de um projeto.
Prompt: "Delete decision DEC-005 from project proj_abc123"manage_trash
Gerencie a lixeira: liste itens excluídos, restaure um item específico ou purgue a lixeira permanentemente.
Prompt: "List trash for project proj_abc123"
Prompt: "Restore spec SPEC-017 from trash in project proj_abc123"
Prompt: "Purge trash for project proj_abc123"generate_spec_dashboard
Regenere o dashboard planu/index.html — uma visão geral em HTML de todas as specs, seus status e métricas principais do projeto.
Prompt: "Regenerate the spec dashboard for project proj_abc123"Veja Também
- Ferramentas de Análise & Estimativa (Stream C) — estimativa, detecção de padrões, validate, recommend_model
- Ferramentas de Design & Planejamento (Stream D) — schemas, contratos de UI, ADRs, planos de execução
- Ferramentas de Plataforma & Operações (Streams E–I) — stack, agentes, git, governança