LGPD Enterprise Auditor
Português (Brasil) | English
Framework de auditoria LGPD orientado a evidências, com foco em segurança, governança e uso de IA em engenharia de software.
Este projeto foi desenhado para funcionar como um sistema auditável e modular, pronto para ser reutilizado em diferentes produtos e times.
Em resumo: você instala o auditor no seu projeto com um comando, roda /lgpd-saas (ou outro cenário) no seu assistente de IA e recebe um relatório com score de 0 a 100, não conformidades com o artigo da LGPD e a evidência de cada uma, e um plano de adequação com prazos e esforço. Funciona com Claude Code, Cursor, VS Code + GitHub Copilot, OpenCode, Codex e Gemini CLI.
Site do projeto: brunolagoa.github.io/lgpd-enterprise-auditor — visão geral, demonstração navegável do relatório de exemplo e instalação.
Você escolhe o formato do relatório no início da auditoria: .md (texto completo, bom para versionar e comparar), .html (para ler no navegador, com o score em destaque, filtros, busca e versão para impressão) ou os dois. O .html é um arquivo único, funciona offline e não carrega nada de fora.
Veja um relatório de exemplo, gerado sobre um SaaS fictício, nos dois formatos:
O que é este projeto
O lgpd-enterprise-auditor é um framework que combina:
- auditoria jurídica (LGPD + ANPD);
- auditoria técnica (appsec, cloud, mobile, devsecops, IA/LLM);
- modelo de severidade e score;
- formato de relatório padronizado;
- comandos práticos para execução por cenário.
Na prática, ele permite rodar auditorias completas ou direcionadas com consistência de critérios, evidências e plano de adequação.
Instalação
Um único comando interativo, executado na raiz do projeto que você quer auditar. Ele pergunta qual ferramenta de IA você usa e se quer instalar também a skill, mostra um resumo e instala tudo localmente, dentro desse projeto (não existe instalação global).
macOS / Linux / WSL / Git Bash
curl -fsSL https://github.com/BrunoLagoa/lgpd-enterprise-auditor/releases/latest/download/install.sh | bash -s -- install
Windows (PowerShell)
powershell -ExecutionPolicy Bypass -Command "iwr https://github.com/BrunoLagoa/lgpd-enterprise-auditor/releases/latest/download/install.ps1 -OutFile $env:TEMP\lgpd-install.ps1; & $env:TEMP\lgpd-install.ps1 install"
Prefere ler o script antes de rodar? Baixe (curl -fsSL <url> -o install.sh), revise e depois execute bash install.sh install.
Os comandos acima baixam o instalador da última release, a mesma versão do framework que ele instala. O instalador usa a última versão publicada. Se não conseguir consultá-la (sem rede ou limite da API do GitHub), ele avisa e não instala a branch main por conta própria: no modo interativo pergunta antes; com --non-interactive, para e pede --version.
Conferir a integridade. As releases a partir da v1.6.0 publicam install.sh, install.ps1 e SHA256SUMS. Para instalar uma versão exata e conferir o arquivo antes de rodar:
V=vX.Y.Z # a versão desejada
curl -fsSLO "https://github.com/BrunoLagoa/lgpd-enterprise-auditor/releases/download/${V}/install.sh"
curl -fsSLO "https://github.com/BrunoLagoa/lgpd-enterprise-auditor/releases/download/${V}/SHA256SUMS"
shasum -a 256 --ignore-missing -c SHA256SUMS # no Linux: sha256sum --ignore-missing -c SHA256SUMS
bash install.sh install --version "$V"
Onde os arquivos ficam
O framework (.agents/lgpd-enterprise-auditor/) é o mesmo para todas as ferramentas; só os comandos e a skill opcional mudam de lugar:
Ferramenta (--target) | Comandos | Skill (opcional) |
|---|
claude — Claude Code | .claude/commands/lgpd-*.md | .claude/skills/lgpd-enterprise-auditor/ |
cursor — Cursor | .cursor/commands/lgpd-*.md | .agents/skills/lgpd-enterprise-auditor/ |
vscode — VS Code + GitHub Copilot | .github/prompts/lgpd-*.prompt.md | .agents/skills/lgpd-enterprise-auditor/ |
opencode — OpenCode | .opencode/commands/lgpd-*.md | .agents/skills/lgpd-enterprise-auditor/ |
agents — Codex, Gemini CLI e similares | — (sem slash commands) | .agents/skills/lgpd-enterprise-auditor/ (sempre instalada) |
- Sem a skill (padrão): a auditoria é acionada pelos slash commands (
/lgpd-saas, /lgpd-full-audit…), que executam o framework modular (.agents/lgpd-enterprise-auditor/).
- Com a skill: o assistente também pode iniciar a auditoria a partir de um pedido em linguagem natural ("faça uma auditoria LGPD deste projeto"), carregando a skill autocontida (
SKILL.md).
- Várias ferramentas no mesmo projeto são suportadas: rode o instalador uma vez por ferramenta. Elas compartilham a pasta do framework.
Atualizar, verificar e desinstalar
| Ação | Comando (bash) | PowerShell |
|---|
| Atualizar todas as ferramentas instaladas | … | bash -s -- update | … install.ps1 update |
| Verificar a instalação | … | bash -s -- check | … install.ps1 check |
| Desinstalar | … | bash -s -- uninstall | … install.ps1 uninstall |
… representa o mesmo prefixo curl …/install.sh ou iwr …/install.ps1 usado na instalação.
Uso em scripts / CI (sem perguntas):
curl -fsSL https://github.com/BrunoLagoa/lgpd-enterprise-auditor/releases/latest/download/install.sh \
| bash -s -- install --non-interactive --target cursor --with-skill
This is the beginning of the README. Read the rest at the original. Read the full README ↗
