---
name: generate_pentest_report
phase: 6_reporting
tools: [markdown, python]
dependencies: [pentest_completed]
mitre_tactic: N/A
---

# Objetivo
Consolidar todos os achados do pentest em um relatório profissional contendo sumário executivo, achados técnicos com evidências, classificação de risco (CVSS), mapeamento MITRE ATT&CK e recomendações de remediação.

# Condições de Execução
- Pelo menos uma fase do pentest foi concluída com achados registrados.
- Os resultados das ferramentas estão salvos no workspace do projeto.

# Estrutura do Relatório

O relatório deve seguir a seguinte estrutura:

```markdown
# Relatório de Pentest - {client_name}
**Data:** {date}
**Escopo:** {scope}
**Classificação:** Confidencial

## 1. Sumário Executivo
Resumo de alto nível para gestores. Inclua:
- Número total de vulnerabilidades por severidade
- Risco geral da organização (Crítico/Alto/Médio/Baixo)
- Top 3 achados mais críticos
- Recomendação principal

## 2. Metodologia
- Padrões seguidos (PTES, OWASP WSTG v4.2)
- Ferramentas utilizadas
- Período de execução

## 3. Achados Técnicos
Para cada vulnerabilidade encontrada:
### 3.X - {Nome da Vulnerabilidade}
- **Severidade:** Crítica/Alta/Média/Baixa/Informativa
- **CVSS Score:** X.X
- **CVE:** CVE-XXXX-XXXXX (se aplicável)
- **MITRE ATT&CK:** TXXXX (Tática), TXXXX.XXX (Técnica)
- **Endpoint/Ativo Afetado:** {url/ip/service}
- **Descrição:** Explicação técnica da vulnerabilidade
- **Evidência:** Output da ferramenta ou screenshot
- **Impacto:** O que um atacante poderia fazer
- **Recomendação:** Como corrigir

## 4. Resumo de Vulnerabilidades
| # | Vulnerabilidade | Severidade | CVSS | Ativo |
|---|---|---|---|---|

## 5. Mapeamento MITRE ATT&CK
Tabela mapeando cada achado para táticas e técnicas do MITRE ATT&CK.

## 6. Recomendações Gerais
Recomendações de segurança que vão além das vulnerabilidades específicas encontradas.

## 7. Apêndices
- Outputs completos das ferramentas
- Lista de IPs/domínios testados
- Timeline de atividades
```

# Comandos para Geração

## 1. Coletar Todos os Resultados
```bash
echo "=== Arquivos de Resultados ===" > {workspace}/report_sources.txt
find {workspace}/ -name "*.txt" -o -name "*.json" -o -name "*.csv" -o -name "*.xml" | sort >> {workspace}/report_sources.txt
```

## 2. Gerar Relatório em Markdown
O agente deve ler todos os arquivos de resultados e compilar o relatório seguindo a estrutura acima, salvando em:
```bash
{workspace}/report_{client_name}_{date}.md
```

## 3. Converter para PDF (se necessário)
```bash
pandoc {workspace}/report_{client_name}_{date}.md -o {workspace}/report_{client_name}_{date}.pdf --pdf-engine=xelatex -V geometry:margin=1in
```

# Análise de Resultados
- Revise o relatório para garantir que todas as vulnerabilidades estão documentadas.
- Verifique se as evidências (outputs) estão incluídas.
- Confirme que as recomendações são acionáveis e específicas.

# Tratamento de Erros
- Se `pandoc` não estiver instalado: `sudo apt install pandoc texlive-xetex -y`.
- Se o relatório ficar muito grande, divida em Sumário Executivo (para gestores) e Relatório Técnico (para equipe de TI).
