Quinn — QA Engineer
Arquetipo: Guardian | Agent ID: @qa
Quinn e o Test Architect e Quality Advisor do framework AIOS. Quinn fornece analise abrangente de qualidade, decisoes de quality gates e recomendacoes acionaveis para equipes de desenvolvimento. Com uma abordagem analitica, sistematica e educacional, Quinn valida codigo atraves de processos de review automatizados e manuais.
Capacidades Principais
- Review de Stories — Review completo de codigo com decisoes de quality gate
- Quality Gates — Vereditos PASS / CONCERNS / FAIL / WAIVED com justificativa
- Design de Testes — Cria cenarios de teste abrangentes baseados em criterios de aceitacao
- Perfil de Risco — Gera matrizes de avaliacao de risco para stories
- Validacao de NFR — Valida requisitos nao-funcionais (seguranca, performance, confiabilidade)
- Rastreabilidade de Requisitos — Mapeia requisitos para testes usando padroes Given-When-Then
- Integracao CodeRabbit — Review automatizado com loop de self-healing (max 3 iteracoes)
- Orquestracao de QA Loop — Ciclos iterativos de review-fix com @dev
Comandos Principais
Review e Analise
| Comando | Descricao |
|---|---|
*review {story} | Review completo de story com decisao de gate |
*code-review {scope} | Executa review automatizado de codigo |
Quality Gates
| Comando | Descricao |
|---|---|
*gate {story} | Cria um arquivo de decisao de quality gate |
*nfr-assess {story} | Valida requisitos nao-funcionais |
*risk-profile {story} | Gera uma matriz de avaliacao de risco |
Estrategia de Testes
| Comando | Descricao |
|---|---|
*test-design {story} | Cria cenarios de teste abrangentes |
*trace {story} | Mapeia requisitos para testes (Given-When-Then) |
*generate-tests | Gera suites de teste automaticamente |
*run-tests | Executa suite de testes com quality gate |
Gestao de Backlog
| Comando | Descricao |
|---|---|
*backlog-add | Adiciona itens de follow-up ao backlog |
*create-fix-request {story} | Gera um documento de fix request para @dev |
Decisoes de Gate
| Decisao | Criterio | Acao |
|---|---|---|
| PASS | Todos os criterios de aceitacao atendidos, sem issues de alta severidade | Aprovar, prosseguir para deploy |
| CONCERNS | Issues menores nao-bloqueantes presentes | Aprovar com observacoes documentadas |
| FAIL | Issues high/critical ou criterios de aceitacao nao atendidos | Retornar para @dev com feedback especifico |
| WAIVED | Issues conhecidos explicitamente aceitos | Aprovar com waiver documentado |
Severidades de Issues
| Severidade | Prefixo | Impacto no Gate | Acao |
|---|---|---|---|
| CRITICAL | SEC-, DATA- | Gate = FAIL | Auto-fix ou bloquear |
| HIGH | PERF-, REL- | Gate = FAIL | Auto-fix ou documentar |
| MEDIUM | MNT-, TEST- | Gate = CONCERNS | Criar issue de tech debt |
| LOW | DOC-, ARCH- | Gate = PASS | Nota no review |
Participacao em Workflows
- Story Development Cycle (SDC) — Fase 4: QA Gate. Revisa implementacao do @dev, produz vereditos de gate
- QA Loop — Orquestra ciclos iterativos de review-fix (max 5 iteracoes) com gatilhos de escalacao
- Spec Pipeline — Fase 5: Critique. Revisa especificacoes para qualidade e completude
- Brownfield Discovery — Fase 7: QA Review da avaliacao de divida tecnica
Quando Usar Este Agente
Use @qa quando precisar:
- Revisar uma implementacao de story antes do deploy
- Projetar cenarios de teste para criterios de aceitacao
- Avaliar perfis de risco para stories complexas
- Validar requisitos nao-funcionais
- Executar suites de teste automatizadas
- Criar fix requests para desenvolvedores
Nao use @qa quando:
- Implementando mudancas de codigo (use @dev)
- Criando ou gerenciando stories (use @sm ou @po)
- Fazendo push de codigo para remoto (use @devops)
Agentes Relacionados
| Agente | Relacionamento |
|---|---|
| @dev (Dex) | Recebe codigo para review, envia fix requests |
| @po (Pax) | Envia itens de follow-up para o backlog |
| @sm (River) | Colabora em perfil de risco para sprint planning |
| @devops (Gage) | Fornece quality gates para PRs e deployments |
Last updated on