promovaweb Conversar com uma spec pelo estado atual
Preparação obrigatória
Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na
raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.
Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma
pendência.
Modo de interação
Modo de interação: perguntas.
Antes de formular qualquer pergunta, leia e aplique o
Contrato de perguntas numeradas de .specsfy/Spec.md.
Leia a spec.md pelo ID informado e confirme a pasta de estado. A pasta é o
estado operacional; Status é seu espelho verificável. Preserve a spec como
fonte normativa e registre apenas respostas, escolhas e justificativas
confirmadas pela pessoa responsável.
Conduzir a conversa
- Leia a spec, seus gates, tarefas, evidências e o contexto do projeto.
- Identifique a lacuna real que mais afeta a próxima etapa e monte uma rodada conforme o contrato central.
- Reavalie a spec depois de cada rodada. Não repita informação confirmada nem use perguntas como ritual.
- Atualize a seção adequada da spec após confirmar a resposta. Quando a nova informação mudar capacidade necessária, ajuste também o Effort.
- Entregue a responsabilidade de validação, implementação ou transição à skill correspondente. Esta skill não aprova gate, não executa tarefa e não move a spec.
Adaptar o foco à pasta
| Pasta | Foco da conversa |
|---|---|
draft |
problema, atores, comportamento, regras, falhas e aceite |
defined |
ambiguidade que afeta plano, dados, segurança ou testes |
planned |
dependências, ordem de tarefas, estratégia de TDD e BDD |
in-progress |
mudança tardia, descoberta de execução e impacto no escopo |
review |
aceite observado, documentação, pendências de entrega e retorno |
completed |
não entreviste para alterar a entrega; inicie ou reabra a mudança pelo fluxo correto |
inbox não recebe perguntas. backlog continua sob responsabilidade de
$specsfy-02-backlog, que chama este protocolo de descoberta quando necessário.
Atualizar Effort
Use Effort como estimativa de capacidade de raciocínio e execução necessária, nunca como prazo. Escolha um inteiro de 1 a 10 e uma justificativa curta:
- 1–2: alteração atômica e padrão conhecido;
- 3–4: mudança local e testes diretos;
- 5–6: vários arquivos ou integração conhecida;
- 7–8: mudança transversal, migração ou integração externa;
- 9–10: arquitetura, alta incerteza ou revisão humana frequente.
Execute após a confirmação:
specsfy effort <id-da-spec> <1-10> --reason "<o que mudou a estimativa>"
O comando atualiza Effort, data, justificativa e histórico em spec.md.
Não vincule a estimativa ao nome de um modelo: use a faixa para escolher o
perfil de execução light, standard, high ou maximum.
Integrar ClickUpfy quando presente
Se o projeto contiver uma skill clickupfy-* e a spec tiver ClickUp Task,
depois de uma transição ou ajuste de Effort carregue a skill ClickUpfy
apropriada. Use o mapeamento configurado pelo projeto ou, quando ausente,
draft/defined/planned para To Do, in-progress para In Progress,
review para In Review e completed para Complete.
O estado local permanece canônico. Se a atualização remota não ocorrer, registre a pendência na spec sem declarar sincronização concluída.
Limites
- Não inventar respostas, Effort, vínculo de tarefa ou status remoto.
- Não alterar uma spec em
completedcomo forma de iniciar mudança nova. - Não mover pastas por comando do sistema; use
specsfy transitionsomente na skill responsável depois de seus gates. - Não exigir ClickUp para uma spec sem integração configurada.