Ferramentas de Ciclo de Vida de Specs (Stream B)
O Stream B contém 11 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.
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 o specforge para esclarecer requisitos para adicionar pagamentos Stripe ao projeto 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.
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: "Crie uma spec para adicionar autenticação Google OAuth ao meu projeto 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: "Liste todas as specs do projeto proj_abc123"
Prompt: "Mostre-me as specs em progresso do projeto proj_abc123"
Prompt: "Quais specs estão bloqueadas no projeto 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: "Atualize o status da spec SPEC-003 para in_progress no projeto proj_abc123"
Prompt: "Marque a spec SPEC-007 como done no projeto 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: "Resuma a spec SPEC-005 do projeto proj_abc123"generate_checklist
Gere um checklist de qualidade para uma spec — cobre prontidão de implementação, cobertura de testes, documentação, segurança e performance.
Prompt: "Gere um checklist de qualidade para a spec SPEC-002 no projeto proj_abc123"reconcile_spec
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: "Reconcilie a spec SPEC-004 com as mudanças de implementação no projeto proj_abc123"manage_scope
Gerencie a definição de escopo do projeto e o backlog — adicione itens, remova, repriorize ou exporte como um backlog estruturado.
Prompt: "Adicione 'suporte a modo escuro' ao backlog do projeto proj_abc123 com prioridade alta"
Prompt: "Mostre o backlog atual do projeto proj_abc123"detect_contradictions
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: "Detecte contradições nas specs do projeto 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."
check_readiness
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: "Verifique se a spec SPEC-006 está pronta para implementação no projeto proj_abc123"package_handoff
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: "Empacote a spec SPEC-009 para handoff no projeto proj_abc123"