Alice

A Alice é a agente de IA do Embrapa I/O. Ela conhece as regras da plataforma e trabalha dentro do seu código, no seu assistente de IA, sempre pedindo a sua aprovação antes de mudar qualquer coisa fora da sua máquina. A agente é uma só, mas cada tarefa vem num plugin próprio, que você instala conforme o que faz no dia a dia:

O código de todos os plugins está em github.com/embrapa-io/alice.

Instalação

Os plugins são para o Claude Code. O repositório da Alice é um marketplace de plugins, chamado embrapa-io: primeiro você adiciona o marketplace, uma vez só, e depois instala os plugins que quiser. No terminal:

claude plugin marketplace add embrapa-io/alice

claude plugin install compliance@embrapa-io       # conformidade (toda equipe)
claude plugin install sentinel@embrapa-io         # relatórios da Sentinela
claude plugin install cve@embrapa-io              # alertas de CVE crítico
claude plugin install boilerplate@embrapa-io      # app → boilerplate do catálogo

Ou, de dentro de uma conversa no Claude Code:

/plugin marketplace add embrapa-io/alice
/plugin install compliance@embrapa-io
/plugin install sentinel@embrapa-io
/plugin install cve@embrapa-io
/plugin install boilerplate@embrapa-io
/reload-plugins

O /reload-plugins carrega os plugins na conversa aberta. Se instalou pelo terminal com o Claude Code aberto, rode-o na conversa (ou abra uma conversa nova) para os comandos aparecerem.

Atualização

A Alice muda com a plataforma. Para receber as versões novas, atualize o marketplace e depois cada plugin que tiver instalado. No terminal:

claude plugin marketplace update embrapa-io

claude plugin update compliance@embrapa-io
claude plugin update sentinel@embrapa-io
claude plugin update cve@embrapa-io
claude plugin update boilerplate@embrapa-io

Se o Claude Code estiver aberto, rode /reload-plugins na conversa depois de atualizar.

Para conferir o que está instalado e em que versão: claude plugin list.

Remoção e troca de nome

claude plugin uninstall <plugin>@embrapa-io

Atenção! Em 03/11/2026, o plugin critical-cves passou a se chamar cve. Quem instalou o nome antigo: claude plugin uninstall critical-cves@embrapa-io e claude plugin install cve@embrapa-io. O comando agora é /cve:alice.

Outros assistentes de IA

No Gemini CLI, OpenCode, GitHub Copilot, Codex e outros, a Alice de conformidade (compliance) é instalada como módulo do BMAD Method, conforme o capítulo Spec-Driven Development. Os outros plugins (sentinel, cve e boilerplate), por enquanto, existem só para o Claude Code.

Como usar

Abra o Claude Code na pasta certa (a da aplicação, a do projeto ou a do boilerplate, conforme o plugin) e chame o comando. Digitar só /alice lista as Alices instaladas. A Alice se apresenta, mostra um menu e espera a sua escolha:

• qualquer código do menu vale a qualquer momento da conversa, e MH mostra o menu de novo;
• também dá para pedir direto, em português, junto com o comando, como em /sentinel:alice trate o relatório desta semana;
• DA dispensa a agente.

Regras que todos os plugins seguem:

• nada sai da sua máquina sem o seu «pode» explícito: push, tag, merge request, issue, reinício de build, voto no Dashboard, mudança no Sentry ou no SonarQube;
• mudanças em lote passam antes por uma tabela de aprovação;
• dados de usuários e segredos não vão para issues, commits nem relatórios.

Vários plugins consultam a plataforma pelos MCP Servers. Conecte ao Claude Code os que cada um pede (abaixo) antes de usar.

Conformidade: compliance

Na pasta da aplicação, /compliance:alice (ou /alice):

É o caminho para trazer uma aplicação existente para a plataforma e para manter qualquer aplicação aderente depois de mudanças grandes.

Relatórios da Sentinela: sentinel

Na pasta do projeto (a que reúne os clones das apps) ou no clone de uma app, /sentinel:alice. Ela busca os relatórios da Sentinela, confere cada achado contra o código, registra o que procede como issues no Kanban do grupo no GitLab (com milestones, responsáveis e prazos pela capacidade da equipe), guia a correção issue por issue e devolve à Sentinela o que o relatório errou, pelos votos útil ou ruído.

Pede o MCP do Dashboard e o MCP do GitLab; recomenda a CLI glab autenticada em git.embrapa.io (para milestones de grupo e o board); usa, se houver, os MCPs do Sentry e do SonarQube.

CVEs críticos: cve

Na pasta da app (ou numa pasta com os clones das apps do projeto), /cve:alice. Ela lista as builds com alerta de CVE crítico, confere cada CVE no código da versão implantada e executa, build a build e sempre com confirmação, a ação indicada pelo alerta.

Antes de reiniciar, a Alice confere se a imagem nova do fornecedor já traz a versão corrigida; antes de desativar uma build com dados, faz o backup e espera a confirmação; nunca dá salto de versão maior em banco de dados sem plano de migração. Pede o MCP do Dashboard, o papel de arquiteto no projeto e Docker na máquina.

Boilerplates: boilerplate

Na pasta da aplicação já aderente, num clone do repositório io/boilerplate/<nome>, /boilerplate:alice:

O plugin boilerplate não substitui o compliance: se a aplicação ainda não estiver aderente, rode antes a conformidade. O passo a passo completo está em Boilerplate.

Perguntas frequentes

Preciso instalar todos os plugins? Não. Quem só desenvolve aplicações precisa do compliance. Arquitetos de projeto ganham com sentinel e cve. O boilerplate é para quem mantém modelos do catálogo.

A Alice manda meu código para algum lugar? Ela roda no seu assistente de IA, com a conta e o contrato que você usa nele. Os plugins só trazem as instruções e os scripts da plataforma; o que o assistente faz com o código segue as regras dele. Vale a mesma regra de sempre: dado sigiloso ou pessoal só em ferramenta e conta autorizadas para isso.

O comando não aparece depois de instalar. Reinicie o Claude Code ou abra uma conversa nova. Confira com claude plugin list se o plugin está instalado e habilitado.

Onde reporto um problema ou sugiro uma melhoria? Nas issues de github.com/embrapa-io/alice.