Onde salvar um agente (como o padrao-dev-projetos-ia) e as formas corretas de
chamar ele quando for começar um projeto novo.
É um arquivo .md com um cabeçalho (nome + descrição) e, no corpo, as instruções
que aquele agente deve seguir sempre que for usado — no nosso caso, o
padrao-dev-projetos-ia.md guarda todo o padrão de desenvolvimento da iSoft Brasil
(stack, listas com busca, paginação server-side, máscaras, date picker, entrada por voz, e a
disciplina de testar e não repetir erro já corrigido).
| Local | Vale para | Prioridade | Quando usar |
|---|---|---|---|
~/.claude/agents/ |
Todos os seus projetos | Média | Uso pessoal, em qualquer projeto novo que você começar (é o nosso caso) |
.claude/agents/ (dentro do projeto) |
Só aquele projeto | Alta | Padrão específico daquele projeto, ou pra versionar no Git e compartilhar com o time |
Se existir um agente com o mesmo nome nos dois locais, o de dentro do projeto
(.claude/agents/) vence.
Não existe um comando de barra tipo /nome-do-agente. Existem 3 formas:
| Forma | Como usar | Garantia |
|---|---|---|
| Menção direta | @agent-padrao-dev-projetos-ia seguido do pedido |
Garante que esse agente específico seja usado |
| Linguagem natural | Mencionar o agente no pedido, ex: "use o agente padrao-dev-projetos-ia pra..." | O Claude decide se delega, com base no pedido |
| Padrão da sessão inteira | claude --agent padrao-dev-projetos-ia no terminal, ou {"agent": "padrao-dev-projetos-ia"} no settings.json |
Todo o projeto já usa esse agente por padrão |
Exemplo prático (o mais simples, direto no chat do VS Code):
@agent-padrao-dev-projetos-ia vamos começar um projeto novo
O comando /agents não lista nem invoca agentes — a partir da
v2.1.198 do Claude Code, ele só mostra um lembrete pra editar os arquivos diretamente. Pra
confirmar que o agente está no lugar certo, é mais simples só chamar ele
(@agent-padrao-dev-projetos-ia) e ver se ele responde.