PALESTRA TÉCNICA · UPAM3D
Boas práticas criando
agentes com Claude Code
Skills · Subagentes · Slash commands · MCPs
MaximoFN · 2026
Começar bem: o comando /init
Gerar o contexto que Claude usará durante toda a sessão
$ /init
- Cria o arquivo
CLAUDE.mdna raiz do projeto. - Indexa a estrutura, dependências e convenções do repositório.
- Esse arquivo é carregado em cada conversa: é o contexto base.
- Se o contexto muda, executa-se de novo para atualizá-lo.
Subagente claude-code-guide
O especialista interno que sabe como se constrói em Claude Code
$ @claude-code-guide
- Subagente que conhece skills, subagentes, slash commands, hooks e MCPs.
- É invocado com
@claude-code-guide. - Você pergunta e ele guia passo a passo para criá-los corretamente.
- Evita reinventar a roda: aplica padrões comprovados.
- Útil quando você começa e quando quer revisar o seu próprio design.
Skills · “I know kung fu”
Conhecimento empacotado para uma tarefa concreta
$ /skill
- Um skill ensina Claude a fazer uma tarefa específica.
- Compõe-se de instruções + scripts + exemplos em uma pasta.
- Invocação manual com
/skill; senão, o agente o chama quando considera. - Reutilizável entre projetos:
ler-excel-qualidade,ler-pdf-qualidade, etc. - Se a tarefa se repete, transforme-a em skill.
Subagentes
Processos filhos com sua própria janela de contexto
$ @subagente
- Cada subagente tem seu próprio contexto: não contamina o principal.
- Podem ser lançados em paralelo para acelerar tarefas independentes.
- Devolvem apenas o resumo → mantêm a conversa limpa.
- Invocação manual com
@subagente; senão, o agente o chama quando considera. - Ideais para investigação, leitura massiva ou tarefas com muito ruído.
MCPs · Model Context Protocol
Padrão para conectar ferramentas externas
- Protocolo aberto para expor ferramentas externas a um LLM.
- Perdendo terreno frente aos skills para tarefas cotidianas.
- Seu nicho atual: executar programas ou serviços longos / persistentes.
- Custo: ocupam muita janela de contexto ao carregar todas as suas tools.
- Padrão recomendado: um skill que explique a Claude como usar o MCP.
Slash commands
Sequências de tarefas reproduzíveis a um comando de distância
$ /command
- Um comando = uma sequência bem definida de passos.
- São invocados com
/command— sempre lançados pelo usuário. - Orquestram skills + subagentes + escrita de arquivos.
- Aceitam argumentos:
/criar-doc-qualidade "Higiene das Mãos". - Convertem um processo de horas em uma única chamada.
Próximos passos · Aprender
Aprofundar em cada peça para projetá-las melhor
- Skills: quando criar um, quais triggers definir, como estruturá-lo.
- Subagentes: critérios de isolamento e distribuição de contexto.
- Slash commands: orquestração, paralelismo e tratamento de erros.
- Boas práticas de prompting interno e validação de saídas.
Próximos passos · Iterar
O que se usa, melhora; o que não se usa, sobra
- Testar os skills com casos reais e medir onde falham.
- Refinar instruções e triggers com cada uso.
- Eliminar passos redundantes; adicionar apenas o que agrega valor.
- Compartilhar os skills úteis com o resto da equipe.
FIM DA PALESTRA
Obrigado
Perguntas?