Primeiros passos

Instalação: hardening de segurança para qualquer agente de IA

Instale o Lagune em qualquer projeto, como plugin quando o seu agente oferece suporte ou com o skills CLI nos demais, e escolha as especializações de segurança que combinam com ele.

O Lagune ajuda seu agente de IA a deixar um projeto mais seguro. Você aponta para o seu código, o agente descobre o que o seu sistema realmente faz e então guia você pelo trabalho de segurança que importa para ele. O Lagune é o primeiro projeto da metodologia Security-Driven Hardening (SDH).

Apoie o open source

Curtiu o Lagune? Dê uma ⭐ no GitHub

Escolha o seu agente​

informação
  • Por baixo dos panos, o Lagune roda em Node.js, mas você usa a linguagem que quiser.
  • Para rodar totalmente offline, instale o Lagune no seu projeto com npm i -D lagune@0.16.0.

Categorias​

O conhecimento de segurança do Lagune vem em especializações, agrupadas em categorias.

Escolha as categoriasOpcional
Execute este comando
npx lagune write add --categories owasp
dica

Todo projeto começa com owasp, e o /lagune-charter adiciona as categorias que a leitura dele sobre o projeto justifica.

Requisitos​

Você precisa ter o Node.js (LTS) instalado no seu sistema.

Use um badge ✨​

Usa o Lagune? Adicione um ao seu README:

Secured By Lagune
Security Powered By Lagune
Security-Driven Hardening with Lagune

Próximo passo​

Veja o que cada uma das Skills do Lagune faz.

Perguntas frequentes

O Lagune é um fluxo de segurança open source, exclusivamente defensivo, que ajuda seu agente de IA a fortalecer a segurança de qualquer código. Você aponta para o seu código, ele detecta o que o seu sistema realmente faz e então orienta as correções de segurança que importam para esse contexto.

Escolha o seu agente: Claude Code, GitHub Copilot CLI, Muse Code, Antigravity CLI, Cursor, Kimi Code, OpenCode, Codex CLI, Factory Droid, Grok Build, Devin CLI e Hermes Agent instalam o Lagune como plugin, Gemini CLI e Qwen Code como extensão, o Pi como pacote e qualquer outro agente com npx skills add wellwelwel/lagune. Funciona tanto em projetos novos quanto em existentes.

Não. Ele roda pelo seu próprio agente de IA, então nenhuma chave de API é necessária.

Você precisa ter o Node.js (LTS) instalado no seu sistema.

Qualquer uma. Por baixo dos panos, o Lagune roda em Node.js, mas audita e fortalece a segurança de projetos escritos em qualquer linguagem de programação.

Um diretório .lagune/ com o estado de segurança do seu projeto, criado pelo primeiro comando que grava algo. O skills CLI também instala os slash commands no projeto, onde o seu agente os lê, enquanto um plugin os mantém dentro do agente.

Do mesmo jeito que você instalou. A página de instalação de cada agente mostra como atualizar o Lagune nele, e o skills CLI o atualiza com npx skills update. Seu charter, os artefatos das fases e as suas próprias especializações continuam intactos.

As nativas das categorias dele, mais as suas próprias. O charter registra as categorias que a leitura dele sobre o projeto justifica, e npx lagune write add --categories as altera.

Não. O comando /lagune aplica hardening ao trabalho enquanto ele é escrito: aceita qualquer prompt, constrói o que você pediu e o protege com padrões seguros, guiado pelo charter. O fluxo Blue Team de cinco fases audita o que já existe.

Sim. O fluxo Blue Team de cinco fases audita o que já existe: o charter define suas regras de segurança, o detect mapeia o que o sistema faz e onde estão os riscos, o plan dá uma nota a cada achado e associa uma correção a ele, o harden aplica as correções e o verify comprova que elas se sustentam e as encerra.

Um agente lendo por conta própria encontra o que parece uma vulnerabilidade e ignora o que parece um controle. Uma lista de endereços bloqueados dá a impressão de que alguém já tratou o risco, então ninguém confere que ela deixa a maioria deles de fora, e o código vai para produção. O Lagune inverte esse padrão: uma proteção que já está no código é considerada não comprovada até ser verificada, cada especialização do catálogo recebe um veredito explícito, e o verify pergunta se o risco acabou, não se existe um controle. Cada achado também continua sendo um único item rastreado entre as execuções, então pode ser comprovado como resolvido e encerrado, enquanto um pedido simples entrega um relatório diferente a cada vez, sem nada para comparar.

Pedir código seguro deixa a definição de seguro por conta do agente e pressupõe que você sabe o que pedir. O requisito geralmente já está dentro do seu pedido sem que nenhum de vocês perceba: pedir uma página que mostra os cursos a que um usuário tem acesso estabelece uma regra de autorização, e uma verificação que nunca é escrita não deixa nada no código para ser notado. O comando /lagune carrega o seu charter e as especializações que combinam com o que está prestes a ser construído antes de a primeira linha ser escrita, e depois relê o resultado à luz da defesa que usou. A forma segura raramente custa mais do que a insegura, então o que decide o resultado é saber qual escolher, e é isso que chega de antemão.

Não. O Lagune lê código e nunca executa o seu sistema nem envia requisições manipuladas a ele. O verify confirma que um controle está presente e correto no código-fonte, o que é uma pergunta diferente de saber se ele resiste a um ataque contra um alvo em produção, então "não dá para saber pelo código" é um veredito legítimo, e não uma aprovação silenciosa. O DAST responde à pergunta sobre a execução e o Lagune responde à pergunta sobre o código-fonte, então um não substitui o outro. Até o comando opcional prove respeita esse limite: os testes dele verificam o comportamento seguro, nunca um payload de ataque.

Não, de jeito nenhum! Um pentest é um trabalho autorizado em que um profissional usa o próprio julgamento contra o seu sistema em produção, encadeando achados e sondando a lógica de negócio que nenhuma regra por superfície descreve. Os achados de um pentest podem entrar no fluxo Blue Team do Lagune, para que o detect registre essas questões e o que um profissional relata seja planejado, fortalecido e verificado.

Política de segurança​

Consulte o SECURITY.md.

Licença​

O Lagune é distribuído sob a Apache License 2.0.

Copyright © 2026-presente Weslley Araújo e colaboradores.

Última atualização em 3 de novembro de 2026.

Copyright © 2026-presente Weslley Araújo e colaboradores. O Lagune é distribuído sob a Apache License 2.0. Consulte a Política de Segurança.

Todos os nomes de produtos, marcas comerciais e marcas registradas mencionados pertencem aos seus respectivos donos e são usados apenas para fins de identificação.