Repository navigation
Agente software architect
Esta página descreve o agente software-architect de forma didática. Se algum termo for novo, consulte o Glossário.
Este agente é o arquiteto de software: ele desenha a estrutura geral do sistema antes de a primeira linha de código ser escrita. Decide como as partes do programa se encaixam, qual tecnologia usar e como o sistema vai aguentar crescer sem quebrar. Ele pensa em troca-troca (em inglês, trade-offs): toda escolha tem um custo, e o trabalho dele é achar a opção mais simples que resolve o problema de verdade.
O Claude Code aciona o arquiteto quando você pede para pensar o desenho do sistema. Exemplos de frases que disparam este especialista:
- "Como eu arquiteto esse sistema?"
- "Qual tecnologia (stack) devo usar?"
- "Isso deve ser um microsserviço ou um programa único (monolito)?"
- "Vai escalar quando tiver muitos usuários?"
- "Qual o melhor jeito de duas partes do sistema conversarem?"
- "Banco de dados SQL ou NoSQL?"
- Define a estrutura de base do sistema: as camadas, os módulos e como eles dependem uns dos outros, para ninguém se perder depois.
- Escolhe o padrão de arquitetura adequado (por exemplo, um programa único bem organizado, ou vários serviços separados) sempre pesando vantagens e custos.
- Seleciona a stack: as linguagens, os frameworks, os bancos de dados e as ferramentas que o projeto vai usar.
- Desenha como as partes conversam entre si: chamadas diretas (síncronas) ou por mensagens e eventos (assíncronas), com contratos claros.
- Cuida dos atributos de qualidade: velocidade, capacidade de crescer, resistência a falhas, segurança e custo. Ele só projeta para escala quando há uma meta real definida, nunca por "achismo".
- Registra cada decisão importante num documento chamado ADR (Architecture Decision Record, registro de decisão de arquitetura), explicando o contexto, as opções avaliadas e as consequências aceitas.
Um cuidado central: ele começa simples e só adiciona complexidade quando surge uma dor real. Isso evita o over-engineering (veja o Glossário). E ele nunca fecha uma decisão grande sozinho: apresenta opções com prós e contras e espera você escolher.
Cor azul (agente operacional). Família: Engenharia.
-
pipeline_release_1.0: as 12 fases do projeto, da ideia ao lançamento; mostra onde a arquitetura entra. -
ORG: governança e quem decide o que (tabela de papéis RACI). -
CONTRACT: o padrão de código e a autoridade do projeto. -
TESTES: como o projeto garante qualidade e usa testes. -
AGILE: o ritmo de trabalho da equipe. -
arquitetura-principios: os princípios de arquitetura do plugin (as 4 camadas, SOLID, DRY).
Você diz: "Estou começando um sistema de reservas e não sei se uso um programa único ou vários serviços separados." O arquiteto responde com duas ou três opções de desenho, cada uma com vantagens, custos e esforço, recomenda a mais simples que serve ao seu caso e, depois da sua escolha, grava um ADR documentando a decisão.
Veja também o Tech Lead (decisões técnicas locais), o Engenheiro Backend e o Engenheiro Frontend (quem implementa o desenho), e Caetano (CTO), o C-level que coordena a engenharia. Voltar para a Home.