# Ag Referencia Qualidade

> Quality Gates minimos, checklist pos-execucao, regras anti-teatralidade, metricas CI. Reference skill carregado on-demand.

- **Type:** Skill
- **Install:** `agentstack add skill-andregusman-raiz-a-gusman-claude-ag-referencia-qualidade`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [andregusman-raiz](https://agentstack.voostack.com/s/andregusman-raiz)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [andregusman-raiz](https://github.com/andregusman-raiz)
- **Source:** https://github.com/andregusman-raiz/a-gusman-claude/tree/main/archive/reference-skills-deprecated-2026-04-22/ag-referencia-qualidade

## Install

```sh
agentstack add skill-andregusman-raiz-a-gusman-claude-ag-referencia-qualidade
```

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

## About

# Quality Gates (Minimos)

Antes de declarar qualquer tarefa como concluida:

| Gate | Criterio | Comando Tipico |
|------|----------|----------------|
| Build | Sem erros | `bun run build` |
| TypeCheck | 0 erros | `bun run typecheck` ou `bunx tsc --noEmit` |
| Lint | 0 erros novos | `bun run lint` |
| Tests | 0 falhas novas | `bun run test` ou `pytest` |
| Security | 0 vulnerabilidades criticas | `bun run audit` |
| UX Render | 0 L1 failures (quando configurado) | `/ag-testar-ux-qualidade --layers=L1` |
| UX Compliance | WCAG AA + Lighthouse >= 90 | `/ag-testar-ux-qualidade --layers=L4` |

## Teste Focado (durante desenvolvimento)

Preferir execucao de teste individual para feedback rapido:
```bash
bunx vitest run path/to/test.test.ts   # Um arquivo
bunx vitest run --reporter=verbose      # Suite completa (somente no final)
```
NUNCA rodar `bun run test` durante desenvolvimento iterativo — somente para validacao final.

## Checklist Minimo Pos-Execucao
```bash
bun run typecheck && bun run lint && bun run test
```

## Regras Anti-Teatralidade (Obrigatorias)

Ao escrever ou revisar testes:
- Cada expect() DEVE poder FALHAR em cenario real
- NUNCA: `.catch(() => false)`, `|| true`, conditional sem else, expect always-true
- SEMPRE: hard-code valores esperados, testar ambos paths (sucesso + falha)
- SEMPRE: mutation mental antes de declarar done ("se eu introduzir bug, este teste falha?")
- Ver detalhes: `.claude/rules/test-quality-enforcement.md`

## Metricas de Qualidade (CI)

- **Theatrical scan**: CI bloqueia merge se anti-patterns detectados (test-quality job)
- **Mutation testing**: Stryker roda semanalmente (mutation-testing.yml), target 80%
- **DORA metrics**: Change Fail Rate, Lead Time, Deploy Frequency (dora-metrics.yml)
- **Quality gates**: TS budget, ESLint budget, file size, bun run audit (quality-gates.yml)
- **Audit local**: `bash .claude/scripts/test-quality-audit.sh [path]`

## Compaction Preservation

Ao executar `/compact`, SEMPRE incluir instrucao:
> "Preserve: lista de arquivos modificados, task atual, comandos de teste, erros encontrados"

## Source & license

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

- **Author:** [andregusman-raiz](https://github.com/andregusman-raiz)
- **Source:** [andregusman-raiz/a-gusman-claude](https://github.com/andregusman-raiz/a-gusman-claude)
- **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-andregusman-raiz-a-gusman-claude-ag-referencia-qualidade
- Seller: https://agentstack.voostack.com/s/andregusman-raiz
- 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%.