audit-deep

Files (1)

• SKILL.md

SKILL.md (first lines)

# Audit Deep — Auditoria Profunda por Categoria

Mergulho profundo em UMA categoria. Enquanto audit-2-scan faz cobertura ampla (6 categorias, profundidade media), audit-deep dedica toda a sessao a UMA (cobertura total, profundidade maxima).

## Etapa 1 — Identificar categoria e contexto

1. Identifique a categoria. Se o usuário não disse qual, **a primeira coisa que você faz é chamar a tool `ask_choice` — antes de qualquer output textual**. Use exatamente esta chamada:

   ```json
   {
     "name": "ask_choice",
     "arguments": {
       "question": "Qual categoria você quer auditar em profundidade?",
       "options": [
         "security — Vulnerabilidades, secrets, injeção, permissões",
         "logic — Erros de lógica, condições incorretas, edge cases",
         "resilience — Tratamento de erros, timeouts, retries, crash recovery",
         "performance — Gargalos, uso de memória, I/O, concorrência",
         "maintainability — Código morto, duplicação, acoplamento, padrões quebrados",
         "bugs — Bugs funcionais, comportamento incorreto, regressões"
       ]
     }
   }
   ```

   Quando o tool retornar, use `chosen_value.split(' — ')[0]` para extrair a chave (`security`, `logic`, etc).

   **PROIBIDO**: escrever a lista de categorias como bullets markdown, tabela, ou texto livre pedindo pro usuário responder. Isso vira lixo no terminal — sempre `ask_choice`.

2. Encontre o AUDIT mais recente em `docs/audits/current/`. Se nao existir, tente `docs/`, `/audits/`. Nenhum: "Rode audit-1-setup + audit-2-scan + audit-4-report primeiro." e pare.

3. Leia o AUDIT. Extraia: mapeamento estrutural, issues da categoria, pontos cegos.

4. Leia o reference file: `references/[categoria].md` — contem o checklist especializado.

## Etapa 2 — Auditoria profunda

Siga o checklist do reference file. Diferenca do scan:
- **audit-2-scan**: padroes obvios nos arquivos principais
- **audit-deep**: CADA arquivo, linha por linha, CADA item do checklist

Para cada arquivo relevante: leia inteiro, aplique TODOS os items do checklist.

## Etapa 3 — Verificar issues anteriores

Para cada issue da categoria no AUDIT anterior:
- Fix aplicado? → RESOLVIDO
- Fix parcial? → documente o que falta
- Nao aplicado? → PENDENTE

## Etapa 4 — Salvar resultado

1. **Se existe** `DEEP_[CATEGORIA].md` em `docs/audits/current/`: leia a versao interna, mova para `docs/audits/archive/DEEP_[CATEGORIA]_V[versao_antiga].md`
2. **Gere novo** em `docs/audits/current/DEEP_[CATEGORIA].md` (sem versao no nome do arquivo, versao fica no header)

```markdown
# AUDITORIA PROFUNDA — [CATEGORIA] — [NOME_DO_PROJETO]
> **Versao:** V[X.Y]
> **Data:** [YYYY-MM-DD]
> **Categoria:** [nome]
> **Base:** AUDIT_V[versao do audit base]
> **Arquivos analisados:** [X de Y total]

---

## RESUMO

| Status | Quantidade |
|--------|-----------|
| Novos problemas | X |
| Issues anteriores resolvidas | X |
| Issues anteriores parcialmente resolvidas | X |
| Issues anteriores pendentes | X |
| **Total de issues ativas** | **X** |

---

## ISSUES ANTERIORES — STATUS

### Resolvidas
| Issue | Titulo | Verificacao |
|-------|--------|------------|

### Parcialmente resolvidas
| Issue | Titulo | O que falta |
|-------|--------|------------|

### Pendentes
| Issue | Titulo | Observacao |
|-------|--------|-----------|

---

## NOVOS PROBLEMAS

#### Issue #D[NNN] — [Titulo]
- [ ] **Concluido**
- **Severidade:** [CRITICO | ALTO | MEDIO | BAIXO]
- **Arquivo:** `caminho/arquivo`
- **Linha(s):** XX-YY
- **Problema:** [descricao]
- **Impacto:** [impacto]
- **Codigo problematico:**
\`\`\`[lang]
\`\`\`
- **Fix sugerido:**
\`\`\`[lang]
\`\`\`
- **Observacoes:**
> _[espaco]_

---

## COBERTURA

| Arquivo | Analisado | Issues |
|---------|-----------|--------|

---

From freire19/Mythos, MIT.

More from freire19/Mythos