Architecture

A skill architecture-decision-records ajuda a registrar decisões de arquitetura durante sessões no Claude Code como ADRs estruturados. Ela identifica momentos de decisão, registra contexto, alternativas e justificativa, e mantém um histórico de ADR para futuras pessoas mantenedoras. É útil para equipes de Technical Writing e de engenharia que precisam de um histórico durável de decisões.

O improve-codebase-architecture ajuda você a identificar atritos arquiteturais, módulos superficiais e oportunidades de aprofundamento em uma codebase. Use-o em revisões de refatoração, melhorias de testabilidade e decisões de design navegáveis por IA, especialmente quando quiser que a skill respeite `CONTEXT.md` e orientações em `docs/adr/`.

documentation-and-adrs ajuda agentes a escrever documentação técnica e ADRs focados em decisões. Use para registrar contexto, restrições, trade-offs, opções rejeitadas e consequências em arquitetura, APIs, infraestrutura, auth e mudanças de funcionalidades. É ideal quando você precisa de justificativas duráveis para engenheiros e agentes no futuro, e não apenas de um resumo bem escrito.

archimate ajuda a criar diagramas ArchiMate no PlantUML com `!include <archimate/Archimate>`, macros tipadas para elementos e macros para relacionamentos. Ele se encaixa em visões em camadas de arquitetura corporativa para negócio, aplicação, tecnologia, motivação e planejamento de migração. Use archimate para diagramas quando precisar de notação EA estruturada, e não de diagramas genéricos de nuvem ou rede.

A skill kaizen orienta melhorias pequenas e seguras de código para refatoração, arquitetura, correções de fluxo de trabalho, tratamento de erros e validação. Ela favorece mudanças iterativas, prevenção no design e escopo mínimo. Use quando quiser um guia prático de kaizen para melhorar o código sem exagerar na engenharia.

clickhouse-architecture-advisor ajuda a projetar workloads no ClickHouse com decisões orientadas pela carga de trabalho para ingestão, particionamento, joins, dicionários, upserts e pré-agregação. É especialmente útil para Desenvolvimento Backend, observabilidade, SIEM, analytics de produto, telemetria de IoT e pipelines financeiros. O skill classifica as orientações como official, derived ou field.

plan-eng-review é uma skill interativa de revisão de plano de engenharia para validar arquitetura, fluxo de dados, casos de borda, cobertura de testes, performance e riscos de rollout antes de começar a codar. Use a skill plan-eng-review quando você tiver um design doc ou plano de implementação e quiser um retorno mais preciso do que um prompt genérico de revisão.

A skill cloud-solution-architect ajuda um agente a agir como um Azure Cloud Solution Architect na tomada de decisões de Cloud Architecture. Use para revisar designs, escolher estilos de arquitetura, comparar serviços Azure e aplicar princípios, padrões e boas práticas de design com menos suposições do que em um prompt genérico.