Slash Commands

Slash commands sao atalhos para fluxos comuns. Ao inves de descrever um workflow inteiro em texto, voce invoca o comando e o Claude Code executa o playbook completo.

Como usar

No Claude Code, digite / seguido do nome do comando. Argumentos opcionais apos o nome:

/novo-cliente Dra. Camila Borges agendamento saude evolution

/investigar-trace abc123def456

/otimizar-custo usa-salus

/auditar-config petisco-alimentos

Se voce nao passar argumentos, Claude Code pergunta o que falta (uma pergunta por vez).

Comandos disponiveis

/novo-cliente

Cria estrutura completa de tenant novo na plataforma.

Argumentos esperados (opcionais, ele pergunta se faltar):

1. Nome do cliente
2. Tipo de agente (sdr, vendas, suporte, agendamento, recuperacao, cobranca, pos-venda)
3. Nicho (saude, beleza, educacao, ecommerce, b2b-servicos, saas, infoproduto)
4. Provider (evolution, stevo)
5. Integracoes especificas

O que ele faz:

1. Valida e confirma contexto
2. Define tenant_id no padrao
3. Cria estrutura de pastas em agent-{tipo}/tenants/{tenant_id}/
4. Gera config.yaml baseado em template + playbook do nicho
5. Cria knowledge base inicial (estrutura minima)
6. Vetoriza KB no Qdrant
7. Compila system prompt
8. Configura mensageria e CRM
9. Faz deploy
10. Documenta no Notion (via MCP)
11. Cria projeto Asana de implantacao (via MCP)
12. Retorna resumo + proximos passos

Ver workflow completo

/investigar-trace

Analisa trace problematico do Langfuse e propoe correcao.

Argumentos esperados:

• trace_id (do Langfuse)

O que ele faz:

1. Acessa o trace via Langfuse API
2. Coleta input, output, tools chamadas, tokens, latencia
3. Identifica categoria do problema (qualidade, custo, latencia, fluxo)
4. Forma 2-3 hipoteses ranqueadas
5. Valida hipotese mais provavel
6. Propoe fix minimo viavel
7. Sugere validacao via eval
8. Documenta em .claude/reference/incidentes.md

Ver workflow de debug

/otimizar-custo

Analisa perfil de custo de tenant e propoe otimizacoes.

Argumentos esperados:

• tenant_id

O que ele faz:

1. Coleta metricas reais (30 dias)
2. Compara com baseline do tipo de agente
3. Verifica oportunidades em ordem de risco:
   • Prompt caching ativo?
   • top_k do RAG razoavel?
   • Memory summarizer agressivo?
   • Tatica hibrida (model router)?
   • Modelo principal apropriado?
4. Simula impacto financeiro de cada uma
5. Recomenda ordem de aplicacao

Regra: nunca recomenda trocar modelo principal sem antes esgotar as outras opcoes.

Ver workflow de otimizacao

/auditar-config

Audita config.yaml de tenant contra boas praticas atuais.

Argumentos esperados:

• tenant_id

O que ele faz:

Verifica conformidade em 6 dimensoes:

1. Validity: schema valido, vars resolviveis, IDs existem no CRM
2. Performance: top_k entre 3-8, summarize_after coerente
3. Custo: prompt caching ativo, model router configurado
4. Compliance: LGPD, retention adequado, consent flow
5. Operacional: tags Langfuse, handoff configurado, horario
6. Seguranca: secrets nao hardcoded, tokens com escopo minimo

Saida classifica desvios em [CRITICO], [ATENCAO], [OPORTUNIDADE].

Adicionar novo slash command

Para criar um comando novo, crie arquivo em .claude/commands/{nome}.md:

---
description: Descricao curta do que o comando faz
allowed-tools: Read, Write, Edit, Bash
---

# /{nome}

Descricao detalhada do comando.

## Argumentos

$ARGUMENTS

## Contexto

Antes de executar, leia:
- arquivo1.md
- arquivo2.md

## Execucao

1. Passo 1
2. Passo 2
3. Passo 3

## Saida esperada

Formato esperado da resposta.

Quando voce digita /{nome} no Claude Code, ele le esse arquivo e executa.

Comandos planejados

Backlog de comandos que ainda serao implementados:

• /deploy-tenant — deploy de tenant especifico
• /comparar-agentes — comparativo tecnico entre tipos
• /gerar-prompt — gera system prompt seguindo padrao
• /relatorio-mensal — relatorio operacional do mes
• /onboarding-parceira — fluxo de onboarding de parceira nova