Comandos prontos¶

Fluxos prontos para colar no Claude Code.

description: Audita as mudanças atuais (diff) antes de abrir/mergear um PR argument-hint: "[branch-base opcional, ex: main]"

Audite as mudanças atuais deste repositório antes de virar um Pull Request. Use as ferramentas do Volt:

O que mudou: git_diff (working tree) e git_status. Se eu informei uma base em "$ARGUMENTS", compare contra ela.
Testes impactados: tests_impacted — quais testes deveriam rodar por causa dessas mudanças.
Qualidade: quality_smells nos arquivos alterados (funções longas, console.log, TODO, complexidade).
Segurança: procure segredos e padrões perigosos nas mudanças (sec_secrets_scan / sec_sast se o add-on Security estiver disponível; senão env_detect_secrets).

Entregue um checklist de revisão dizendo o que está bom e o que precisa ajustar antes do merge. Seja direto e aponte arquivo:linha.

description: Analisa dependências (desatualizadas, vulneráveis, licenças)¶

Analise as dependências deste projeto com o Volt:

Desatualizadas: deps_outdated — atual vs. mais recente.
Vulnerabilidades: deps_vuln_scan — por severidade.
Licenças: deps_licenses — destaque licenças restritivas (GPL/AGPL) que possam ser problema comercial.

Entregue um plano de atualização priorizado: primeiro o que tem vulnerabilidade crítica, depois o que está muito defasado. Indique quais updates são seguros (patch/minor) e quais são major (podem quebrar).

description: Diagnóstico geral do projeto usando o Volt (git, env, infra, dependências)¶

Faça um diagnóstico completo deste projeto usando as ferramentas do Volt (MCP). Execute e resuma:

Git: git_status e os 5 últimos commits (git_log).
Ambiente: rode env_detect_secrets no arquivo .env (se existir) e alerte qualquer segredo exposto.
Máquina: infra_health (CPU, memória, disco).
Dependências: deps_audit (vulnerabilidades + pacotes desatualizados).
Código: quality_report (complexidade, smells).

No final, entregue um resumo executivo com os 3 pontos mais urgentes a resolver, em ordem de prioridade.

description: Onboarding rápido — o Claude aprende o projeto inteiro em minutos¶

Quero entender este projeto rapidamente. Use o Volt:

Indexe o código: context_index na raiz do projeto.
Resumo: context_summary — quantos símbolos, por tipo, e os arquivos mais densos.
Estrutura Git: git_log (histórico recente) e git_status.
Salve as conclusões importantes com memory_save (ex.: stack usada, módulos principais, decisões) para lembrar nas próximas sessões.

Entregue um mapa do projeto: o que é, qual a stack, quais são os módulos/arquivos centrais e por onde começar a mexer. Escreva como se estivesse explicando para um dev novo no time.

description: Diagnóstico de produção (saúde da máquina, logs e anomalias) argument-hint: "[caminho do arquivo de log opcional]"

Faça um diagnóstico de produção com o Volt:

Máquina: infra_health, infra_disk e infra_ports — recursos e o que está escutando.
Processos: infra_processes — o que está consumindo CPU.
Logs: se eu informei um arquivo em "$ARGUMENTS" (ou se houver um log padrão), rode logs_stats, logs_anomalies (erros mais repetidos + taxa de erro) e, se fizer sentido, logs_correlate.
Containers: infra_docker ps (se houver Docker).

Entregue um status de saúde (verde/amarelo/vermelho) e a causa mais provável de qualquer anomalia encontrada, com o próximo passo de investigação.

description: Revisa o banco de dados (schema, índices, estatísticas) — somente leitura¶

Revise o banco de dados deste projeto usando o Volt (Database, somente leitura). Garanta que DATABASE_URL está configurada; se não, peça para eu configurar.

Schema: db_schema — tabelas e colunas.
Índices: db_indexes — o que está indexado.
Estatísticas: db_table_stats — tabelas maiores, linhas mortas (precisa de VACUUM?).
Se eu te der uma query lenta, rode db_explain_analyze e explique o plano.

Entregue recomendações práticas: índices faltando, tabelas que precisam de manutenção e possíveis gargalos. Nunca execute escrita — é tudo read-only.

description: Varredura de segurança do projeto (segredos, vulnerabilidades, código perigoso)¶

Faça uma varredura de segurança completa deste projeto com o Volt:

Segredos no código: sec_secrets_scan (add-on Security) ou, se não disponível, env_detect_secrets nos arquivos .env.
Código perigoso (SAST): sec_sast — eval, command/SQL injection, XSS, hash fraco, credenciais em URL.
Dependências vulneráveis: deps_vuln_scan / sec_deps_audit (foco em high/critical).
Se houver uma URL/endpoint público no projeto, valide os headers de segurança com sec_headers.

Entregue um relatório de risco ordenado por severidade (crítico → baixo), com onde está cada problema e como corrigir. Termine com uma nota geral de risco (0–10).

description: Roda e analisa os testes (cobertura, flaky, impactados)¶

Analise a saúde dos testes deste projeto com o Volt:

Mapa: tests_patterns — quais arquivos de teste existem.
Execução: tests_run — roda a suíte e mostra se passou.
Cobertura: tests_coverage — se houver relatório, traga os percentuais.
Impactados: tests_impacted — quais testes as mudanças atuais afetam.
Se eu suspeitar de teste instável, rode tests_flaky no comando específico.

Entregue um resumo: passou ou falhou, cobertura atual, e onde faltam testes. Sugira os 3 testes mais importantes a adicionar.