Harness Testing

Harness: Testes (Etapa 06)

Persona: QA Engineer.

Integrações

> Verificar disponibilidade antes de usar (consultar harness.config.yaml). > Se não disponível → usar harness-engineering/references/12-fallback-skills.md.

• test-driven-development (se disponível) — escrever testes antes (invocar também durante implementação); fallback: 12-fallback-skills.md § test-driven-development
• verification-before-completion (se disponível) — antes de marcar a etapa como concluída; fallback: 12-fallback-skills.md § verification-before-completion
• finishing-a-development-branch (se disponível) — após esta etapa — finaliza a branch para o PR; fallback: 12-fallback-skills.md § finishing-a-development-branch

Posicionamento Shift-Left

pré-commit:    testes unitários (rápidos, determinísticos)
pré-push:      testes de integração
CI (por PR):   integração + estruturais + contrato
CI semanal:    mutation testing

Tipos de Teste a Gerar

1. Testes Unitários (pré-commit)

• Cada função/método em isolamento, dependências mockadas
• Por CA: happy path + falha esperada + caso limite

Estrutura:

describe('[Módulo]', () => {
  describe('CA-01: [critério]', () => {
    it('should [comportamento] when [condição]', ...)
    it('should [falha] when [condição inválida]', ...)
    it('should [caso limite] when [valor limite]', ...)
  });
});

2. Testes de Integração (CI por PR)

• Fluxo completo: controller → service → repository
• DB em memória ou testcontainers

3. Testes de Contrato de API (CI por PR)

• Status codes corretos por cenário
• Shape do response (campos obrigatórios, tipos)
• Comportamento com input inválido

4. Testes Estruturais (CI por PR) ⭐ mais importantes para harnessability

Verificar que as camadas dependem apenas na direção permitida. Configurar por violação:

• Detectado automaticamente
• Mensagem de erro inclui instrução de remediação inline
• CI bloqueia em caso de violação

Matriz de Cobertura por CA

| CA | ✅ Happy path | ❌ Falha esperada | ⚠️ Caso limite | |----|--------------|-------------------|----------------| | CA-01 | | | | | CA-02 | | | |

Regras de Teste

• Nomes: should [comportamento] when [condição] — sem nomes vagos
• Estrutura: Arrange → Act → Assert (linha em branco entre cada parte)
• Teste comportamentos observáveis, não implementação interna
• Mocks resetados entre testes (beforeEach)
• Nenhum any em testes TypeScript
• Testes não devem depender de ordem de execução

Saída Esperada

Suíte completa + testes estruturais configurados + rastreabilidade por CA + todos os gates verificados.

Próximo Passo → harness-documentation

Em seguida: invocar finishing-a-development-branch → abrir PR → atualizar documentação.

---

Template completo de prompt: Ver ./prompt.md

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: thaifurforo
• Source: thaifurforo/ai-toolkit
• License: MIT

Install and usage instructions live in the source repository linked above.