ag-verificar-seguranca — Auditar Codigo
Spawn the ag-verificar-seguranca agent to perform a security and quality audit.
Invocation
Use the Agent tool with:
subagent_type: ag-verificar-seguranca
mode: auto
run_in_background: true
prompt: Compose from template below + $ARGUMENTS
Prompt Template
Projeto: [CWD or user-provided path]
Focus: [OWASP, secrets, deps, all]
Executar auditoria de seguranca conforme foco solicitado. Verificar OWASP Top 10, secrets expostos, dependencias vulneraveis, RLS, e conformidade.
Gerar relatorio com severidade e recomendacoes.
Important
- ALWAYS spawn as Agent subagent — do NOT execute inline
- After spawning, confirm to the user
- READ-ONLY audit — does NOT fix issues, only reports findings
- Supports focus modes: OWASP, secrets, deps, or all
Output
- audit-report.md com findings: descricao, severity, localizacao (file:line), remediacao
- OWASP Top 10 checklist (A01-A10)
- Secrets scan (grep: sk_, pk_, api_key, token, password)
- Dependency audit (
bun run audit --production)
- RLS verification (para projetos Postgres/Supabase)
Anti-Patterns
- NUNCA auditar sem rodar
bun run audit — ferramenta automatica detecta o que olho humano perde
- NUNCA ignorar severity CRITICAL — um CRITICAL bloqueia deploy
- NUNCA confiar no README para avaliacao de seguranca — codigo e a verdade
Escalacao: Issues para Findings P0/P1
Findings com severidade P0 (CRITICAL) ou P1 (HIGH) DEVEM ser registrados como GitHub Issues:
Agent({
subagent_type: "ag-registrar-issue",
name: "issue-registrar",
model: "haiku",
run_in_background: true,
prompt: "Repo: [detectar]\nOrigem: ag-verificar-seguranca\nSeveridade: [P0-critical ou P1-high]\nTitulo: [SECURITY] descricao do finding\nContexto: [finding completo: descricao, localizacao file:line, OWASP category, remediacao sugerida]\nArquivos: [arquivos afetados]\nLabels: security"
})
- P0/P1: SEMPRE criar issue (bloqueia deploy)
- P2/P3: apenas documentar em audit-report.md (nao poluir backlog)
Quality Gate
Auditoria de Resiliencia
Para cada dependencia externa (API, DB, servico), verificar:
Classificacao de Severidade — Resiliencia
| Achado |
Severidade |
| Chamada externa sem timeout |
P0 — CRITICO |
| Retry sem backoff (loop infinito possivel) |
P0 — CRITICO |
| Sem circuit breaker em dependencia critica |
P1 — ALTO |
| Sem fallback para servico opcional |
P2 — MEDIO |
| Health check incompleto (so liveness) |
P3 — BAIXO |
1---2name: ag-verificar-seguranca3description: Auditoria de seguranca, qualidade e conformidade. OWASP Top 10, secrets scan, dependency audit. Use antes de deploy.4---5
6# ag-verificar-seguranca — Auditar Codigo
7
8Spawn the `ag-verificar-seguranca` agent to perform a security and quality audit.
9
10## Invocation
11
12Use the **Agent tool** with:
13- `subagent_type`: `ag-verificar-seguranca`
14- `mode`: `auto`
15- `run_in_background`: `true`
16- `prompt`: Compose from template below + $ARGUMENTS
17
18## Prompt Template
19
20```
21Projeto: [CWD or user-provided path]
22Focus: [OWASP, secrets, deps, all]
23
24
25Executar auditoria de seguranca conforme foco solicitado. Verificar OWASP Top 10, secrets expostos, dependencias vulneraveis, RLS, e conformidade.
26Gerar relatorio com severidade e recomendacoes.
27```
28
29## Important
30- ALWAYS spawn as Agent subagent — do NOT execute inline
31- After spawning, confirm to the user
32- READ-ONLY audit — does NOT fix issues, only reports findings
33- Supports focus modes: OWASP, secrets, deps, or all
34
35## Output
36
37- audit-report.md com findings: descricao, severity, localizacao (file:line), remediacao
38- OWASP Top 10 checklist (A01-A10)
39- Secrets scan (grep: sk_, pk_, api_key, token, password)
40- Dependency audit (`bun run audit --production`)
41- RLS verification (para projetos Postgres/Supabase)
42
43## Anti-Patterns
44
45- NUNCA auditar sem rodar `bun run audit` — ferramenta automatica detecta o que olho humano perde
46- NUNCA ignorar severity CRITICAL — um CRITICAL bloqueia deploy
47- NUNCA confiar no README para avaliacao de seguranca — codigo e a verdade
48
49## Escalacao: Issues para Findings P0/P1
50
51Findings com severidade P0 (CRITICAL) ou P1 (HIGH) DEVEM ser registrados como GitHub Issues:
52
53```
54Agent({
55 subagent_type: "ag-registrar-issue",
56 name: "issue-registrar",
57 model: "haiku",
58 run_in_background: true,
59 prompt: "Repo: [detectar]\nOrigem: ag-verificar-seguranca\nSeveridade: [P0-critical ou P1-high]\nTitulo: [SECURITY] descricao do finding\nContexto: [finding completo: descricao, localizacao file:line, OWASP category, remediacao sugerida]\nArquivos: [arquivos afetados]\nLabels: security"
60})
61```
62
63- P0/P1: SEMPRE criar issue (bloqueia deploy)
64- P2/P3: apenas documentar em audit-report.md (nao poluir backlog)
65
66## Quality Gate
67
68- [ ] Nenhum secret hardcoded encontrado?
69- [ ] Nenhuma vulnerabilidade CRITICAL sem remediacao?
70- [ ] OWASP Top 10 coberto (A01-A10)?
71- [ ] Todas as issues tem remediacao sugerida?
72- [ ] Findings P0/P1 registrados como GitHub Issues via ag-registrar-issue?
73
74### Auditoria de Resiliencia
75Para cada dependencia externa (API, DB, servico), verificar:
76- [ ] **Circuit Breaker** presente? (evita cascading failure)
77- [ ] **Retry com backoff exponencial**? (com jitter, sem retry em 4xx)
78- [ ] **Timeout configurado**? (connection + read + total)
79- [ ] **Fallback definido**? (cache stale, valor padrao, degradacao)
80- [ ] **Health Check** implementado? (liveness + readiness)
81- [ ] **Idempotencia** em operacoes de escrita? (retry seguro)
82
83### Classificacao de Severidade — Resiliencia
84
85| Achado | Severidade |
86|--------|-----------|
87| Chamada externa sem timeout | P0 — CRITICO |
88| Retry sem backoff (loop infinito possivel) | P0 — CRITICO |
89| Sem circuit breaker em dependencia critica | P1 — ALTO |
90| Sem fallback para servico opcional | P2 — MEDIO |
91| Health check incompleto (so liveness) | P3 — BAIXO |