Monte uma equipe pequena de agentes para um projeto

Escolha uma tarefa que caiba numa revisão

Use como exercício um formulário de inscrição com e-mail, validação e confirmação. Escreva três critérios: o campo recusa um endereço inválido, o envio não acontece duas vezes e a mensagem de sucesso só aparece após resposta válida. Guarde o estado inicial do projeto em uma branch ou cópia.

Agency Agents reúne perfis de papel e fluxo de trabalho. Instalar um perfil não cria um serviço autônomo nem fornece um modelo de IA.

Selecione dois papéis com entregas diferentes

No repositório, leia o perfil Frontend Developer e um perfil de revisão adequado ao projeto. Compare missão, ferramentas esperadas e entregas. Para o exercício, uma pessoa implementa e a outra revisa; só acrescente segurança ou banco de dados quando esses temas entrarem na tarefa.

O app Agency Agents, ligado pelo próprio repositório, permite navegar e instalar perfis em diferentes ferramentas. Baixe pelo link oficial e confira o destino antes de instalar.

Instale a seleção no ambiente correto

Se preferir scripts, clone o repositório em uma pasta de trabalho, leia scripts/install.sh e execute os comandos abaixo dentro dessa pasta. Eles listam os grupos disponíveis e instalam o grupo escolhido para Claude Code. Para uma seleção menor, use o assistente interativo ou o filtro de agentes documentado pelo projeto.

No Windows, esses arquivos .sh precisam de um ambiente Bash compatível; o app evita essa etapa. Para Cursor ou Codex, o README pede executar scripts/convert.sh antes da instalação específica da ferramenta. Não cole os comandos de Claude Code em outra ferramenta.

./scripts/install.sh --list teams
./scripts/install.sh --tool claude-code --division engineering

Peça a implementação com limites observáveis

Abra uma nova sessão ou recarregue os perfis conforme a ferramenta. Confirme que o agente escolhido aparece. Envie os critérios do primeiro passo e peça um plano curto antes de editar. Neste exercício o envio deve usar um endpoint de teste, sem cadastrar pessoas reais.

Use o perfil Frontend Developer. Implemente o formulário de inscrição neste projeto, reutilizando os componentes existentes. Antes de editar, aponte os arquivos envolvidos. Valide e-mail, bloqueie envio duplicado e só mostre sucesso após resposta válida. Use dados e endpoint de teste. Ao terminar, mostre como verificar cada critério e o que ainda não foi testado.

Faça uma segunda leitura do resultado

Entregue ao revisor o diff, os critérios e a saída dos testes. Peça achados com caminho de arquivo, condição que causa o problema e impacto. Uma opinião vaga como “parece seguro” não encerra a revisão. Se houver conflito entre os perfis, volte ao comportamento esperado e execute o cenário que diferencia as duas interpretações.

Revise esta alteração contra os três critérios originais. Procure um cenário que ainda falhe. Para cada achado, indique arquivo, trecho, passos de reprodução e correção mínima. Separe falha demonstrada de suspeita. Não mude o código nesta revisão.

Verifique e guarde o que foi aprendido

Teste endereço inválido, envio válido, clique duplo, erro do servidor e navegação por teclado. Registre quais passos passaram e quais ficaram inconclusivos. Corrija os achados relevantes e repita somente os cenários afetados.

Salve o briefing, o diff e o relato da revisão. Esse conjunto permite avaliar se os perfis ajudaram naquela tarefa; quantidade de agentes instalados não mede qualidade.