Revisão de Segurança Diferencial

Revisão de código focada em segurança para PRs, commits e diffs.

Quando Usar

• Você precisa de uma revisão focada em segurança de um PR, intervalo de commits ou diff, em vez de uma revisão de código geral.
• As alterações tocam em autenticação, criptografia, chamadas externas, transferência de valores, permissões ou outra lógica de alto risco.
• Você precisa de descobertas apoiadas por evidências de código, cenários de ataque e um artefato de relatório explícito.

Princípios Fundamentais

1. Risco em Primeiro Lugar: Foco em autenticação, criptografia, transferência de valores, chamadas externas
2. Baseado em Evidências: Cada descoberta apoiada pelo histórico do git, números de linha, cenários de ataque
3. Adaptável: Escala para o tamanho da base de código (PEQUENA/MÉDIA/GRANDE)
4. Honesto: Declare explicitamente os limites de cobertura e o nível de confiança
5. Orientado a Saída: Sempre gere um arquivo de relatório markdown abrangente

Racionalizações (Não Pule)

Referência Rápida

Estratégia de Tamanho da Base de Código

Gatilhos de Nível de Risco

Visão Geral do Fluxo de Trabalho

Pre-Analysis → Phase 0: Triage → Phase 1: Code Analysis → Phase 2: Test Coverage
    ↓              ↓                    ↓                        ↓
Phase 3: Blast Radius → Phase 4: Deep Context → Phase 5: Adversarial → Phase 6: Report

Árvore de Decisão

Iniciando uma revisão?

├─ Need detailed phase-by-phase methodology?
│  └─ Read: methodology.md
│     (Pre-Analysis + Phases 0-4: triage, code analysis, test coverage, blast radius)
│
├─ Analyzing HIGH RISK change?
│  └─ Read: adversarial.md
│     (Phase 5: Attacker modeling, exploit scenarios, exploitability rating)
│
├─ Writing the final report?
│  └─ Read: reporting.md
│     (Phase 6: Report structure, templates, formatting guidelines)
│
├─ Looking for specific vulnerability patterns?
│  └─ Read: patterns.md
│     (Regressions, reentrancy, access control, overflow, etc.)
│
└─ Quick triage only?
   └─ Use Quick Reference above, skip detailed docs

Checklist de Qualidade

Antes de entregar:

• Todos os arquivos alterados analisados
• Git blame no código de segurança removido
• Raio de explosão calculado para risco ALTO
• Cenários de ataque são concretos (não genéricos)
• Descobertas referenciam números de linha específicos + commits
• Arquivo de relatório gerado
• Usuário notificado com resumo

Integração

habilidade de construção de contexto de auditoria:

• Pré-Análise: Construa contexto de linha de base
• Fase 4: Contexto profundo em alterações de ALTO RISCO

habilidade de escrita de issues:

• Transforme descobertas em relatórios formais de auditoria
• Comando: issue-writer --input DIFFERENTIAL_REVIEW_REPORT.md --format audit-report

Exemplo de Uso

Triagem Rápida (PR Pequeno)

Input: 5 file PR, 2 HIGH RISK files
Strategy: Use Quick Reference
1. Classify risk level per file (2 HIGH, 3 LOW)
2. Focus on 2 HIGH files only
3. Git blame removed code
4. Generate minimal report
Time: ~30 minutes

Revisão Padrão (Base de Código Média)

Input: 80 files, 12 HIGH RISK changes
Strategy: FOCUSED (see methodology.md)
1. Full workflow on HIGH RISK files
2. Surface scan on MEDIUM
3. Skip LOW risk files
4. Complete report with all sections
Time: ~3-4 hours

Auditoria Profunda (Alteração Grande e Crítica)

Entrada: 450 arquivos, reescrita do sistema de autenticação
Estratégia: CIRÚRGICA + construção de contexto de auditoria
1. Contexto de linha de base com construção de contexto de auditoria
2. Análise profunda apenas nas alterações de autenticação

…