Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Search & research

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-bdd

About 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

  1. Leia specs/specs/<NNNN>-<slug>/spec.md, testes e configuração do projeto.
  2. Exija Formato: Specsfy/2.0 e Definition Gate: Passed. No modo prepare, use Status: Defined e Plan Gate: Pending; nos modos cycle e verify, use Status: Planned ou Implementing.
  3. Selecione uma fatia vertical pequena: um AC Gherkin e seus FR/NFR.
  4. Resolva o runner de testes pela stack antes de escrever testes:
    • projeto PHP (composer.json ou artisan), 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.
  5. Em Node, considere a decisão materializada quando package.json expuser o script test:tdd; não escolha nem instale dependência silenciosamente.
  6. Leia references/test-levels.md para escolher o nível mais baixo que ainda prova o comportamento.

Usar o BDD para escrever TDD

  • Use o bloco Gherkin do AC em spec.md como contrato de referência sem mudar seu significado.
  • Não crie, copie nem execute arquivos .feature ou step definitions. Os termos Given/When/Then permanecem apenas na spec.md.
  • Em PHP, escreva o teste TDD com Pest em tests/Feature/ ou tests/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, FR e NFR: caminho feliz, regra/variação crítica e falha ou limite material. Um único marcador SPECSFY: compartilhado pelo arquivo conta como um caso, mesmo que o arquivo contenha vários testes.
  • Cubra cada AC com 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

  1. Leia o BDD de referência e escreva o menor teste TDD que prova o AC e seus requisitos.
  2. Execute o teste TDD; nunca execute Gherkin.
  3. Confirme falha pelo comportamento ausente ou incorreto.
  4. Se falhar por sintaxe, fixture, importação ou ambiente, corrija o teste e repita.
  5. 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

Read the complete source ↗