# Harness Testing

> Use quando for gerar ou auditar testes automatizados de uma feature ou task. Ativado por "gerar testes", "cobertura", "testar", "testes automatizados". Esta etapa produz os sensores computacionais do harness.

- **Type:** Skill
- **Install:** `agentstack add skill-thaifurforo-ai-toolkit-harness-testing`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [thaifurforo](https://agentstack.voostack.com/s/thaifurforo)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [thaifurforo](https://github.com/thaifurforo)
- **Source:** https://github.com/thaifurforo/ai-toolkit/tree/main/skills/harness-testing

## Install

```sh
agentstack add skill-thaifurforo-ai-toolkit-harness-testing
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](https://github.com/thaifurforo)
- **Source:** [thaifurforo/ai-toolkit](https://github.com/thaifurforo/ai-toolkit)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-thaifurforo-ai-toolkit-harness-testing
- Seller: https://agentstack.voostack.com/s/thaifurforo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.