specsfy-06-tdd-bdd
Use quando o usuário pede TDD, BDD, testes derivados do Gherkin de referência da especificação, rastreabilidade entre `spec.md` e testes, ou um ciclo RED-GREEN-REFACTOR. Use também quando uma transição automática pedir materialização, RED ou verificação de testes. Use para editar as seções 11–13 e executar testes; `specsfy-07-implement` continua responsável pelas tarefas de produção na seção 14 do mesmo arquivo.
promovaweb · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add promovaweb/specsfy --skill specsfy-06-tdd-bddAbout this skill
name: specsfy-06-tdd-bdd
description: "Use quando o usuário pede TDD, BDD, testes derivados do Gherkin de referência da especificação, rastreabilidade entre spec.md e testes, ou um ciclo RED-GREEN-REFACTOR. Use também quando uma transição automática pedir materialização, RED ou verificação de testes. Use para editar as seções 11–13 e executar testes; specsfy-07-implement continua responsável pelas tarefas de produção na seção 14 do mesmo arquivo."
Executar TDD orientado pelo BDD da especificação
Leia o BDD como referência e converta o comportamento especificado em testes TDD executáveis e evidência rastreável. O Gherkin ajuda o usuário e o agente a entender contexto, ação e resultado; ele próprio não é uma suíte de testes.
Orquestrar a conversa
Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie
Pendência detectada: <descrição> — ação: resolvendo nesta etapa e resolva-a
quando pertencer ao próprio escopo. Quando houver troca de responsabilidade,
anuncie Transição automática: $specsfy-06-tdd-bdd → $<destino> — motivo: <motivo> — resultado esperado: <resultado> e carregue imediatamente a skill de
destino, sem pedir confirmação nem repetir o comando. Continue na mesma
conversa. Depois de uma correção necessária a esta etapa, anuncie Retomada automática: $<destino> → $specsfy-06-tdd-bdd — pendência resolvida: <resultado> e retome-a imediatamente. Reavalie o estado após cada handoff para
evitar ciclos. Não peça confirmação para o handoff; ações sensíveis continuam
exigindo autorização específica.
Escolher o modo
prepare: antes da implementação, criar o próximo teste/scenario e provar RED sem escrever código de produção.cycle: executar RED → GREEN → REFACTOR para uma fatia explicitamente escolhida.verify: executar suites e auditar rastreabilidade sem criar comportamento novo.
Se o usuário não indicar o modo, use prepare quando a seção 14 ainda não estiver em execução e cycle quando houver uma tarefa ativa.
Preparar
- Leia
specs/specs/<NNNN>-<slug>/spec.md, testes e configuração do projeto. - Exija
Formato: Specsfy/2.0eDefinition Gate: Passed. No modoprepare, useStatus: DefinedePlan Gate: Pending; nos modoscycleeverify, useStatus: PlannedouImplementing. - Selecione uma fatia vertical pequena: um
ACGherkin e seusFR/NFR. - Resolva o runner de testes pela stack antes de escrever testes:
- projeto PHP (
composer.jsonouartisan), inclusive PHP + Node: use Pest; - projeto Node sem PHP: pergunte ao usuário qual runner adotar antes de instalar ou configurar; recomende Vitest por padrão;
- outra stack: preserve o runner de testes existente ou pergunte quando não houver decisão reproduzível.
- projeto PHP (
- Em Node, considere a decisão materializada quando
package.jsonexpuser o scripttest:tdd; não escolha nem instale dependência silenciosamente. - Leia
references/test-levels.mdpara escolher o nível mais baixo que ainda prova o comportamento.
Usar o BDD para escrever TDD
- Use o bloco Gherkin do
ACemspec.mdcomo contrato de referência sem mudar seu significado. - Não crie, copie nem execute arquivos
.featureou step definitions. Os termos Given/When/Then permanecem apenas naspec.md. - Em PHP, escreva o teste TDD com Pest em
tests/Feature/outests/Unit/, no menor nível que prova o comportamento. Marque cada caso executável, imediatamente junto à sua definição, com:
// SPECSFY: US-001 FR-001 AC-001
- Em Node, depois da resposta do usuário, escreva o teste TDD no runner
escolhido e use
SPECSFY: US-001 FR-001 AC-001. - Materialize no mínimo três casos TDD distintos para a feature inteira e para
cada
US,FReNFR: caminho feliz, regra/variação crítica e falha ou limite material. Um único marcadorSPECSFY:compartilhado pelo arquivo conta como um caso, mesmo que o arquivo contenha vários testes. - Cubra cada
ACcom ao menos um caso TDD, sem multiplicar casos equivalentes. - Escolha unidade, integração, contrato ou browser conforme a fronteira descrita pelo BDD; não crie uma segunda suíte apenas para rotulá-la como BDD.
- Não use mocks para remover justamente a fronteira que o cenário pretende provar.
Ciclo obrigatório
RED
- Leia o BDD de referência e escreva o menor teste TDD que prova o
ACe seus requisitos. - Execute o teste TDD; nunca execute Gherkin.
- Confirme falha pelo comportamento ausente ou incorreto.
- Se falhar por sintaxe, fixture, importação ou ambiente, corrija o teste e repita.
- Se passar antes da mudança, o teste não demonstra o gap: refine-o ou prove que a funcionalidade já existe.
No modo prepare, pare após o RED válido, registre evidência e conclua o
checklist da tarefa [TEST] correspondente. Não
altere Plan Gate; anuncie e retorne automaticamente para
$specsfy-05-tasks, que valida todos os predecessores antes de promover a
spec para Planned.
Registre a linha correspondente na tabela Evidência RED-GREEN-REFACTOR com o RED observado.
GREEN
No modo cycle, escreva o mínimo de código de produção que satisfaça o cenário. Execute primeiro o teste focal e depois a suite relacionada. Não generalize antes de haver um exemplo que exija generalização.
Atualize a mesma linha de evidência com o GREEN observado.
REFACTOR
Com tudo verde, elimine duplicação e melhore nomes/estrutura sem alterar comportamento. Execute novamente as suites relacionadas. Registre o comando de regressão na seção 11 e a evidência na matriz da seção 12.
Auditar rastreabilidade
Execute:
python3 .agents/skills/specsfy-06-tdd-bdd/scripts/check_traceability.py specs/specs/<NNNN>-<slug>/spec.md .
Trate como gap cada feature, US, FR ou NFR com menos de três casos TDD e
cada AC sem ao menos um caso. Para NFR verificado manualmente ou por
observabilidade, cite a evidência sem dispensar os três casos automatizáveis;
quando necessário, ajuste --kinds sem remov