Esta skill atualiza uma spec que já foi definida, planejada, iniciada ou concluída. A nova necessidade entra na mesma fonte, e somente os atos cujas provas perderam validade são reabertos.
Quando usar
Use quando uma entrega existente precisar incorporar algo esquecido, adicionar ou remover comportamento, corrigir uma definição ou mudar uma regra já registrada.
Para criar a primeira versão da spec, use specify. A update-spec depende de uma fonte existente para comparar a nova instrução com requisitos, testes, tarefas e gates já registrados.
Como descrever a tarefa
Use $specsfy-update-spec para adicionar expiração de 30 minutos àspecs/specs/0004-recuperar-senha/spec.md.Para remover um comportamento, identifique a exigência e o arquivo spec.md
que deve ser revisto. Assim, a skill consegue localizar testes e tarefas que
ficariam incompatíveis com a remoção:
Remova a exigência de SMS da spec 0004 e ajuste o trabalho afetado.Exemplo passo a passo
- A skill preserva literalmente a nova instrução.
- Lê requisitos, testes, tarefas, gates e evidências atuais.
- Classifica a mudança:
Mudança de definição: altera comportamento e condição de aceite.Atos reabertos: I, II e III.Com o impacto identificado, a skill atualiza a mesma spec.md e invalida
somente os gates que perderam validade. Depois, retoma refinamento, validação,
tarefas, testes e implementação na ordem necessária. A nova evidência é
registrada sem apagar o histórico relevante.
O que esperar
- instrução original preservada.
- impacto explicado na retomada.
- nenhuma spec duplicada.
- trabalho já válido mantido.
- transições automáticas até o estado coerente.
Erros comuns
- editar apenas o código e deixar a spec antiga.
- reabrir todos os gates sem analisar impacto.
- manter teste ou tarefa que contradiz a nova instrução.
- esconder a mudança em notas soltas.
- criar uma segunda especificação para a mesma entrega.
Próximo passo
A própria skill encaminha para a etapa reaberta. Depois da atualização, use
specsfy-progress para revisar o estado
geral.