Agente backend engineer

Engenheiro Backend (backend-engineer)

Esta página descreve o agente backend-engineer de forma didática. Se algum termo for novo, consulte o Glossário.

O que é / cargo

Este agente é o engenheiro de backend: ele programa a parte do software que roda no servidor, longe dos olhos do usuário. É onde ficam as regras de negócio, o banco de dados e a lógica que faz o sistema funcionar. (Backend e frontend estão explicados no Glossário.) O foco dele é código que aguenta uso real, e não só funcionar numa demonstração.

Quando o Claude usa este agente

O Claude Code aciona o engenheiro de backend quando o trabalho é do lado do servidor. Exemplos:

• "Implemente um endpoint" (um ponto de entrada da API, o endereço que recebe pedidos).
• "Escreva essa consulta ao banco de dados (query SQL)."
• "Crie a autenticação de login."
• "Monte uma fila de tarefas em segundo plano."
• "Essa API está lenta, otimize."
• "O endpoint não responde, descubra o motivo."

O que ele faz

• Modela as regras de negócio com tipos claros, de forma que dados inválidos nem cheguem a ser criados (errar cedo evita erro tarde).
• Projeta e programa APIs: o contrato (o combinado de entrada e saída) é versionado, validado e documentado. API é o jeito de dois programas conversarem; veja o Glossário.
• Cuida da persistência: como os dados ficam guardados no banco, com transações seguras e mudanças de estrutura (migrations) que podem ser desfeitas.
• Usa cache (memória rápida) para acelerar, com regras claras de quando atualizar.
• Trata a concorrência: quando muita coisa acontece ao mesmo tempo, evita que um pedido atrapalhe o outro.
• Garante resiliência: toda chamada externa tem tempo limite e tentativa de repetição, para uma falha de rede não derrubar tudo.
• Cuida da segurança: valida o que entra, nunca cola texto do usuário direto numa consulta (isso evita um ataque famoso chamado SQL injection) e mantém segredos fora do código.
• Coloca observabilidade: registros (logs) organizados e métricas, para enxergar o que acontece em produção. Nunca grava dados pessoais (PII) nesses registros.
• Escreve testes que tocam o banco de verdade, porque só assim alguns erros aparecem.

Cor e camada

Cor azul (agente operacional). Família: Engenharia.

Manuais que ele consulta

• CONTRACT: o padrão de código e a autoridade do projeto.
• TESTES: a disciplina de testes (TDD) e os níveis de teste.
• ORG: governança e quem decide o que (papéis RACI).
• pipeline_release_1.0: as fases de engenharia do projeto (da 4 à 9).

Exemplo de pedido

Você diz: "Preciso de um endpoint que cadastra um cliente e não pode duplicar se a pessoa clicar duas vezes." O engenheiro de backend implementa o endpoint, valida os dados na entrada, usa uma chave de idempotência (um mecanismo que faz o pedido repetido não criar dois cadastros), grava no banco com segurança e entrega o código com testes.

---

Veja também o Arquiteto de Software (desenho do sistema), o Engenheiro Frontend (a parte visível que consome a API), o Engenheiro de QA (testes) e Caetano (CTO), o C-level da engenharia. Voltar para a Home.