RepoIntermediate

Sentinel: o guardião que revisa o que sua IA escreveu (e ainda te traz o fix)

Quando você constrói com IA, a velocidade esconde um risco: a IA escreve em "modo construtor" — otimista, imaginando que tudo vai dar certo — e é cega aos próprios bugs. Um segredo que vaza pro git, uma consulta que deixa vazar os dados de outro cliente, um botão que um usuário de teclado não consegue apertar. O Sentinel é um guardião que você instala no seu agente e que revisa o código em 18 frentes, e a diferença dele pra todo o resto é brutal: ele não só aponta o problema, ele te entrega o conserto mínimo E o teste que impede que ele volte. É de graça, mora no GitHub, e aqui eu te ensino quando usar, por que importa e como instalar em um comando.

Jun 25, 202612 min

Pra quem é isso?

Pra qualquer pessoa que constrói software com IA — mesmo que você não saiba programar. Se você pede pra uma IA fazer um app, um backend ou uma função, ela escreve o código por você… mas ninguém revisa se ela não deixou um buraco. Este recurso te dá um guardião de graça que revisa de verdade, e te explica em bom português. Você não precisa entender de segurança: o guardião entende por você.

1. O momento: quando a IA escreve mais rápido do que você consegue revisar

O momento chega sempre igual. Você pede pra sua IA "faz o login do meu app", e em trinta segundos você já tem código funcionando. Você testa, entra, funciona. Passa pro próximo feature. E pro próximo. A IA produz numa velocidade que você, como humano, não consegue auditar linha por linha. Esse é o momento exato em que aparece o risco silencioso.

Porque a IA não escreve como um auditor desconfiado. Ela escreve no que a gente chama de "modo construtor": otimista, imaginando um único caminho feliz, focada em "fazer funcionar". E nesse modo ela é fisicamente incapaz de enxergar os próprios bugs — do mesmo jeito que você não consegue fazer cócegas em si mesmo. O código roda, sim. Mas "roda" e "é seguro" são duas coisas diferentes.

Pense assim

Construir é como cozinhar com pressa pra servir um banquete: você está concentrado em tirar os pratos, não em conferir se deixou o gás aberto. Auditar é a mente oposta: entrar na cozinha vazia, fria, procurando o que pode pegar fogo. São dois cérebros incompatíveis. O Sentinel é o segundo cérebro — o que entra depois com a lanterna pra achar o gás aberto que você, cozinhando, não conseguia ver.

2. A dor: os bugs que a IA não vê são os mais caros

A dor é real e honesta — não é um apocalipse, é um acidente que sai caro. Estes são os erros clássicos que a IA deixa passar sem querer, uma vez e outra:

O que o "modo construtor" não vê

Um segredo (uma chave de API, uma senha) escrito direto no código e enviado pro git — onde fica pra sempre, mesmo que você apague depois.

Uma consulta ao banco de dados que esquece de filtrar por usuário → um cliente consegue ver os dados de outro. O erro mais caro em qualquer app com vários usuários.

Um endpoint sem proteção de acesso: qualquer um com a URL entra.

Um botão que funciona com o mouse mas é invisível pra quem navega com teclado ou leitor de tela (falha de acessibilidade, e às vezes de lei).

Dados pessoais (e-mails, telefones) escritos nos logs sem querer.

O que dói não é o bug em si: é quando você fica sabendo. Você fica sabendo quando um usuário reclama, quando alguém vaza os dados, quando chega uma multa. A essa altura já está em produção. O custo de um bug cresce com o tempo que ele demora pra ser descoberto — e os que a IA não vê são justamente os que mais demoram pra vir à tona.

O dado que explica tudo

Um agente que acerta 85% das vezes em cada passo soa bem… até você encadear 8 passos: 0,85⁸ ≈ 27% de sucesso de ponta a ponta. O erro não é usar IA — é não ter uma segunda mente que revise o que a primeira deixou passar. Isso é o Sentinel.

3. O hábito: revisar NÃO é uma vez, é toda vez que a IA mexe no código

Aqui está a chave que muda o comportamento, não só o conhecimento: o Sentinel não é algo que você usa uma vez e pronto. É um hábito. Toda vez que sua IA escreve ou muda código importante, você pede pro Sentinel revisar antes de dar como bom. Como colocar o cinto: você não faz "quando lembra", você faz sempre, no automático.

Os momentos em que você SEMPRE deveria passar o Sentinel:

Os 4 momentos do hábito

Antes de subir seu app pra produção (deixar o mundo ver) → "isso está seguro?".

Quando a IA mexeu em algo sensível: login, pagamentos, banco de dados, dados de usuários.

Ao revisar uma mudança antes de aceitar (um PR, uma branch nova).

De tempos em tempos, uma revisão geral — porque o que era seguro ontem pode ter quebrado com uma mudança de hoje.

A regra de ouro do Sentinel

O Sentinel não para em "aqui tem um problema, boa sorte". Ele segue uma regra que vale pra toda engenharia séria: "sem teste, o fix não está feito". Por isso, pra cada bug real que ele confirma, ele te traz duas coisas: o conserto mínimo E um teste de regressão — uma pequena prova que garante que aquele bug nunca mais volte. Caçar o bug é metade; blindar ele pra sempre é a outra metade.

4. O que ele revisa exatamente: 18 frentes

O Sentinel escaneia em 18 dimensões, divididas em dois grandes grupos. Você não precisa entender todas — mas vê-las te dá a dimensão do que ele faz por você:

8 de segurança clássica: segredos no código, endpoints sem proteção, consultas que pulam o filtro por usuário, configurações de banco de dados que ficam lentíssimas em escala, cabeçalhos de segurança mal configurados, dados pessoais nos logs, entradas sem validação, e dependências com vulnerabilidades conhecidas.

10 "pontos cegos do modo construtor": os bugs recorrentes que a IA comete uma vez e outra ao construir interfaces e lógica — atalhos de teclado que roubam o Enter do chat, botões invisíveis pro teclado, vazamentos de memória sutis, identificadores duplicados, erros que são engolidos em silêncio. Esse segundo grupo é o ingrediente secreto: ele nasce de um protocolo de qualidade lapidado em muitas rodadas de auditoria real, não de uma lista genérica da internet.

O que o torna confiável (e não barulhento)

O medo com qualquer scanner é que ele te encha de alarmes falsos. O Sentinel faz algo diferente: pra cada suspeita, ele tenta refutar a si mesmo antes de reportar (será que é um falso positivo? esse "segredo" é só um exemplo? essa consulta é de verdade multiusuário?). Ele só te reporta o que sobrevive a essa dúvida. Melhor 5 achados reais do que 20 barulhentos.

5. Como se instala: um comando

O Sentinel é uma skill pro Claude Code (o assistente de IA que trabalha no seu terminal ou editor). Ele se instala em um comando, e fica disponível em todos os seus projetos. Se você usa Claude Code, é só isso que você digita:

bash

/plugin marketplace add MentexDev/neuralos-sentinel
/plugin install neuralos-sentinel@neuralos-sentinel

Usa outro assistente (Cursor, Codex, Gemini CLI)? O Sentinel segue o padrão aberto de skills, então ele também funciona lá com npx skills add MentexDev/neuralos-sentinel. Depois de instalado, você não o chama com um comando estranho: você fala normal com a sua IA.

O jeito mais fácil: só fala com ele

Depois de instalado, você não memoriza nada. Você diz pra sua IA coisas como: "escaneia este projeto com o Sentinel", "esse código está seguro antes de eu subir?" ou "revisa essa mudança procurando bugs de segurança". A IA reconhece a intenção e ativa o guardião sozinha. Simples assim.

6. O prompt pronto pra copiar

Pra você não ter que pensar no que dizer, aqui está o prompt completo, de ponta a ponta. Cola no seu agente (com o Sentinel já instalado), preenche os [colchetes], e deixa o guardião fazer o trabalho dele:

Auditar meu código com o Sentineltext

Quero que você escaneie meu código com a skill neuralos-sentinel, em modo read-only (não mude nada sem o meu OK).

Alvo a revisar: [o projeto todo / esta pasta / este arquivo / a última mudança que você fez]
Stack / tecnologia: [ex. Next.js + banco de dados PostgreSQL, ou "não tenho certeza, olha o código"]
Contexto: [ex. "é um app com vários usuários/clientes, então os dados NÃO podem se misturar" · "tem login e pagamentos" · o que você souber]

Siga o procedimento do Sentinel: escaneie as 18 dimensões, VERIFIQUE cada achado (descarte os falsos positivos), e me entregue um relatório ordenado por gravidade. Pra cada problema real: me diga em bom português o que é, em que arquivo está, por que importa, o conserto proposto e o teste que blinda ele. No final, uma seção de "o que revisei e descartei" pra eu confiar que você não inventou alarmes.

NÃO aplique nenhuma mudança ainda: primeiro me mostre o relatório e eu decido o que consertar.

7. O caminho fácil: quem faz o quê

Como o Sentinel mora dentro do seu agente de código, vale deixar claro o que acontece pelo chat e o que você faz você mesmo. É mais simples do que parece:

O que o agente faz sozinho (pelo chat)

Ler todo o seu código e escaneá-lo nas 18 frentes.

Verificar cada achado pra não te dar alarmes falsos.

Escrever o relatório claro pra você, com o fix e o teste de cada problema real.

O que você decide (um clique / um "sim")

Aprovar quais consertos você quer que ele aplique (o Sentinel é read-only: não mexe em nada sem a sua permissão).

Rotacionar de verdade um segredo que ficou exposto (isso se faz no painel do provedor, pela web).

Decidir se um achado se aplica ao seu caso ou não (você é quem conhece o seu negócio).

Honestidade: o que o Sentinel NÃO é

Não é mágica nem um antivírus que pega tudo. É uma rede de alta confiança pros erros mais comuns e caros — não substitui uma auditoria de segurança profissional pra um banco. E como a análise é feita pelo seu agente de IA, o código é processado onde esse agente rodar (igual a qualquer pedido que você faz pra ele). O Sentinel não adiciona nenhum canal de saída pra terceiros: o que ele encontra fica na sua sessão.

8. O repositório (grátis, MIT, dá uma estrelinha)

O Sentinel é de código aberto e grátis pra sempre. Ele mora aqui — entra, dá uma olhada, instala, e se ele caçar um bug pra você, deixa uma estrela pra mais gente encontrar:

MentexDev/neuralos-sentinel

REPO

O guardião de segurança do seu código com IA. Caça o bug em 18 dimensões (segurança + builder-mode) e te traz o fix com o teste de regressão dele. Read-only por padrão.

MarkdownMITView on GitHub

No NeuralOS…

O Sentinel nasceu da mesma disciplina com que o NeuralOS é construído: detectar o problema, trazer o conserto, blindar com um teste. É o primeiro de uma família de guardiões — pequenos aliados de IA que vigiam seu produto e te propõem o conserto, sem mexer em nada sozinhos. A ideia de fundo: que a IA não só construa, mas também cuide do que constrói.