Criar a especificação no Specsfy com specsfy-03-specify

Esta skill cria a fonte única da entrega no arquivo spec.md. Ao abrir esse arquivo, você encontra a descoberta usada como base para os requisitos, os comportamentos que orientam o plano e a ligação entre tarefas, testes e evidências. Essa concentração evita que arquivos paralelos apresentem versões diferentes da mesma entrega.

Quando usar

Use para promover um backlog refinado ou criar uma spec nova ainda em estado Draft. Para mudar uma spec que já foi definida, use update-spec.

Como descrever a tarefa

Quando a ideia já tiver sido refinada no backlog, informe o caminho do item:

1
Use $specsfy-03-specify para promover
2
specs/backlog/0003-idioma-da-interface.md.

Quando o refinamento tiver produzido um brief na conversa, peça a criação com base nas definições registradas:

1
Use $specsfy-03-specify para criar uma especificação para recuperação de senha
2
com base nas definições desta conversa.

Exemplo passo a passo

1. A skill confirma a raiz do projeto e o próximo número disponível.
2. Ela lê as instruções, o brief e as evidências necessárias.
3. Cria o pacote:

1
specs/specs/0004-recuperar-senha/
2
├── spec.md
3
└── research/        # somente quando houver pesquisa externa

Em seguida, ela preenche o Ato I com requisitos e cenários, mantém as escolhas ainda abertas claramente marcadas e executa os validadores. Um resultado incompleto permanece pendente em vez de receber uma aprovação sem evidência.

Os arquivos em research/ apoiam as escolhas registradas, mas nunca substituem o texto normativo de spec.md. Quando houver divergência, a entrega e seus validadores devem seguir a spec.

O que esperar

• formato Specsfy/2.0.
• IDs rastreáveis para histórias, requisitos e condições de aceite.
• cenários que cobrem sucesso, variação e falha.
• uma única fonte normativa.
• status Draft ou Defined conforme a evidência real.

Erros comuns

• criar plan.md, tasks.md ou research.md.
• copiar uma fonte externa como requisito sem confirmação.
• aprovar gates com campos incompletos.
• misturar várias entregas grandes na mesma spec.

Próximo passo

Use specsfy-04-validate para provar que a definição está pronta. Se uma escolha importante faltar, a transição volta para specsfy-02-backlog.