senior-architect
por alirezarezvanisenior-architect é uma skill de Arquitetura de Software para design de sistemas, ADRs, decisões de stack, revisões de escalabilidade, análise de dependências e diagramas de arquitetura usando scripts Python e referências incluídos.
Esta skill tem pontuação 84/100, o que a torna uma candidata sólida para usuários do diretório que querem um agente capaz de criar, revisar e analisar arquitetura com fluxos reutilizáveis e scripts de apoio. Ela oferece orientação suficiente sobre gatilhos, material de referência e ferramentas executáveis para ser mais útil do que um prompt genérico, embora os usuários devam observar a ausência de instruções de instalação e a natureza heurística das ferramentas de análise.
- Forte capacidade de acionamento: o frontmatter lista explicitamente intenções comuns dos usuários, como design de arquitetura de sistemas, avaliação de microservices versus monolith, escolha de banco de dados, análise de dependências, ADRs e geração de diagramas.
- Boa substância operacional: o SKILL.md inclui comandos de início rápido, visões gerais das ferramentas, fluxos de decisão, comandos comuns e links para documentação de referência.
- Alto valor para agentes: três scripts dão suporte à geração de diagramas de arquitetura, análise de dependências e avaliação da arquitetura de projetos, enquanto as referências trazem trade-offs de padrões, fluxos de system design e matrizes de decisão tecnológica.
- Não há comando de instalação nem README no caminho da skill, então os usuários talvez precisem deduzir como copiá-la ou executá-la na configuração de skills do Agent/Claude.
- Os scripts de análise parecem heurísticos e baseados em padrões; portanto, os resultados devem ser tratados como apoio à revisão arquitetural, não como avaliações definitivas do sistema.
Visão geral da skill senior-architect
Para que serve a senior-architect
senior-architect é uma skill de Software Architecture para transformar perguntas vagas de design de sistemas em decisões arquiteturais estruturadas, diagramas, revisões de dependências e trade-offs de implementação. Ela é mais indicada para quem precisa de um plano de arquitetura, raciocínio no estilo ADR, comparação de stacks, revisão de escalabilidade ou avaliação arquitetural em nível de codebase — não apenas uma resposta genérica de brainstorming.
Usuários e trabalhos mais indicados
Use a skill senior-architect quando estiver decidindo entre padrões como monolith, modular monolith, microservices, event-driven, CQRS, hexagonal ou clean architecture. Ela também é útil para equipes que estão revisando um repositório existente, porque os scripts Python incluídos conseguem varrer a estrutura do projeto, inferir camadas arquiteturais, detectar acoplamento e gerar diagramas Mermaid, PlantUML ou ASCII.
O que a torna diferente
A skill combina orientação de prompt com ferramentas concretas para análise de repositório. As referências cobrem padrões de arquitetura, fluxos de system design e matrizes de decisão tecnológica; os scripts oferecem geração de diagramas de projeto, análise de dependências e avaliação arquitetural. Isso a torna mais prática do que um prompt simples de “aja como um arquiteto sênior” quando você precisa de evidências extraídas de uma codebase.
Restrições importantes de adoção
Os scripts são scanners heurísticos, não validadores formais de arquitetura. Eles funcionam melhor em estruturas de projeto convencionais e ecossistemas comuns como Node, Python, Go, Rust, Java, Docker e Kubernetes. Em monorepos muito customizados, o resultado gerado deve ser tratado como ponto de partida para revisão, não como decisão final.
Como usar a skill senior-architect
Instalação da senior-architect e primeiros arquivos para ler
Instale a partir do diretório de skills no GitHub com:
npx skills add alirezarezvani/claude-skills --skill senior-architect
Depois da instalação, leia SKILL.md primeiro para entender o escopo de acionamento e exemplos de comandos. Em seguida, examine:
references/architecture_patterns.mdpara trade-offs de padrões e orientações de “quando não usar”references/system_design_workflows.mdpara fluxos de planejamento de capacidade, design de APIs, migração e escalabilidadereferences/tech_decision_guide.mdpara escolhas de banco de dados, cache, filas, autenticação, frontend, cloud e estilo de APIscripts/architecture_diagram_generator.pyscripts/dependency_analyzer.pyscripts/project_architect.py
Esse caminho de leitura ajuda você a entender tanto o framework de raciocínio quanto as ferramentas executáveis de análise antes de confiar no resultado.
Entradas que geram uma arquitetura melhor
A skill senior-architect funciona melhor quando você fornece contexto de negócio e restrições técnicas. Um prompt fraco seria: “Design a scalable backend.” Um prompt mais forte seria:
Use senior-architect for Software Architecture. Design an architecture for a B2B analytics app with 50k tenants, 5M daily events, PostgreSQL today, Python/FastAPI backend, React frontend, AWS deployment, 99.9% availability target, small team of 6, and a requirement to support tenant-level data isolation. Compare modular monolith vs microservices, include risks, ADR summary, and a Mermaid component diagram.
Entradas úteis incluem usuários esperados, volume de requisições, proporção de leitura/escrita, meta de latência, meta de disponibilidade, retenção de dados, requisitos de compliance, tamanho da equipe, ambiente de deploy, stack atual, restrições de migração e decisões que já foram descartadas.
Fluxo prático de uso da senior-architect
Para um sistema novo, comece pelos fluxos de referência: esclareça requisitos funcionais, estime escala, identifique requisitos não funcionais e então peça arquiteturas candidatas com trade-offs. Para uma codebase existente, execute os scripts antes de pedir recomendações:
python scripts/architecture_diagram_generator.py ./my-project --format mermaid
python scripts/dependency_analyzer.py ./my-project --output json
python scripts/project_architect.py ./my-project --verbose
Cole no prompt os achados mais relevantes: padrão detectado, pontuação de acoplamento, dependências circulares, camadas ausentes, gerenciador de pacotes e recomendações. Isso dá ao modelo evidências fundamentadas, em vez de forçá-lo a inferir a arquitetura a partir de uma descrição vaga.
Padrão de prompt para decisões e revisões
Para decisões de design, peça um formato explícito de decisão: contexto, opções, critérios de decisão, opção recomendada, alternativas rejeitadas, riscos, plano de migração e perguntas em aberto. Para revisões, peça que a skill separe “fatos observados” de “interpretação” e “mudanças recomendadas”. Isso reduz conselhos arquiteturais excessivamente confiantes e torna o resultado mais fácil de converter em um ADR, item de roadmap ou proposta de engenharia.
FAQ da skill senior-architect
A senior-architect é só para sistemas grandes?
Não. Ela pode ajudar equipes pequenas a escolher uma arquitetura simples e evitar microservices prematuros. A referência de padrões arquiteturais incluída cobre explicitamente os trade-offs de monolith e modular monolith, então a skill é útil quando a melhor resposta é “mantenha mais simples”.
Por que ela é melhor do que um prompt comum de arquitetura?
Um prompt normal depende principalmente do que você se lembra de incluir. A skill senior-architect acrescenta fluxos de decisão reutilizáveis, referências de padrões, matrizes de comparação tecnológica e scripts de varredura de codebase. Essa combinação é especialmente valiosa quando você precisa de revisão arquitetural repetível, não apenas de um conselho pontual.
Iniciantes podem usar esta skill senior-architect?
Sim, mas iniciantes devem usá-la como apoio guiado à decisão, não como autoridade. Peça para ela explicar trade-offs, definir termos e rotular suposições. Se você não sabe sua escala, meta de disponibilidade ou restrições operacionais, peça que a skill liste as perguntas faltantes antes de recomendar um design.
Quando eu não devo usá-la?
Não use como única fonte para decisões críticas de segurança, com forte carga de compliance ou de migração em produção. Ela também não substitui profiling, testes de carga, modelagem de custos em cloud ou revisão especializada de um domínio único. Para bugs de implementação de baixo nível, uma skill de debugging específica da linguagem pode ser mais adequada.
Como melhorar a skill senior-architect
Melhore as entradas da senior-architect com restrições mensuráveis
O modo de falha mais comum é receber uma recomendação de arquitetura que parece plausível, mas não é acionável. Melhore os resultados adicionando números: usuários, requisições por segundo, crescimento de armazenamento, multiplicador de pico, orçamento de latência, meta de uptime, tamanho da equipe, frequência de release e teto de custo. Mesmo estimativas aproximadas são melhores do que adjetivos como “alta escala” ou “nível enterprise”.
Use evidências do repositório antes de pedir mudanças
Para projetos existentes, inclua a saída dos scripts e um resumo curto da árvore de arquivos. Mencione se o código usa controllers/services/repositories, pastas domain/application/infrastructure, Docker, Kubernetes, filas de mensagens ou múltiplos serviços implantáveis. Isso ajuda a senior-architect a diferenciar arquitetura intencional de nomes de pastas acidentais.
Itere do design amplo para artefatos concretos
Não pare na primeira proposta de arquitetura. Faça perguntas de acompanhamento para obter um ADR, diagrama Mermaid, sequência de migração, registro de riscos, escolha de banco de dados, fronteira de API ou modelo de ownership de serviços. Um bom caminho de iteração é: design de alto nível → comparação de trade-offs → arquitetura escolhida → diagrama → ADR → plano de implementação em fases.
Fique atento a overengineering e suposições ausentes
Se a saída recomendar microservices, event sourcing, CQRS ou mensageria distribuída, pergunte por que a complexidade operacional adicional se justifica. Se houver suposições faltando, peça uma resposta revisada que explicite as incógnitas e ofereça um padrão mais simples como default. O melhor uso da senior-architect mantém o design alinhado à capacidade da equipe, não apenas à escalabilidade teórica.