activemq-artemisJMS com ActiveMQ Artemis no Spring Boot 4 — JmsTemplate, @JmsListener, queues × topics, durable subscriptions, transações, redelivery e dead-letter no broker, JSON, Docker/Kubernetes/Amazon MQ e testes. Use quando o projeto exigir JMS/XA ou integrar com legado JMS; em greenfield, decida antes com me
agile-deliveryEntrega ágil do ponto de vista do PM — Scrum e Kanban na prática, planejamento por capacidade, forecast por vazão (Monte Carlo), métricas de fluxo, bugs e interrupções, dependências, retrospectiva e acordo PM ↔ tech lead. Use quando planejar sprint ou fluxo, responder pedidos de data sem prometer, o
api-gatewayAPI Gateway e BFF com Spring Cloud Gateway — rotas, filtros, circuit breaker, rate limit, CORS, token relay, autenticação na borda sem confiar em headers de identidade externos, e comparação com Ingress/ALB/AWS API Gateway/service mesh. Use quando criar ou revisar a porta de entrada de microsserviço
api-versioningVersionamento de API REST no Spring Boot 4 — quando versionar (e quando uma mudança aditiva basta), versão major no path (/api/book/v1 → v2) com DTOs e controllers por versão, versionamento nativo do Spring Framework 7 (configureApiVersioning, @GetMapping(version), baseline "1.2+", 400 para versão i
application-securitySegurança de aplicação (AppSec) em APIs Spring Boot 4, guiada pelo OWASP API Security Top 10 — autorização por objeto e por função (IDOR/BOLA), mass assignment, consumo de recursos e rate limit, injeção, SSRF, desserialização e XML, security headers e CORS, segredos e criptografia, erros e logs, dep
argocdEntrega contínua por GitOps com Argo CD no Kubernetes/EKS — repositório de configuração, Application/AppProject/ApplicationSet, sync policy, Flyway como PreSync hook, CI que só atualiza a tag, promoção por PR, rollback por git revert, segredos fora do Git e segurança do Argo CD. Use quando configura
authenticationAutenticação stateless com JWT próprio no Spring Boot 4 / Spring Security 7 — User/Permission, JwtTokenProvider, JwtTokenFilter, SecurityConfig em lambda DSL, /auth/signin e /auth/refresh, BCrypt e @PreAuthorize. Use quando adicionar login JWT, proteger endpoints, autorizar por permission ou investi
aws-architecture-diagramDiagrama de arquitetura AWS no padrão draw.io (diagrams.net) com os ícones e grupos oficiais — AWS Cloud, conta, região, VPC, Availability Zones, subnets públicas e privadas — gerado por script com coordenadas absolutas, setas com protocolo, exportado em PNG pelo draw.io desktop e conferido visualme
aws-cognitoAmazon Cognito com a API Spring Boot como OAuth2 Resource Server — User Pool, app clients, Authorization Code + PKCE e client credentials, validação do access token (token_use, client_id), cognito:groups e scopes como authorities, operações admin pelo SDK e testes. Use quando trocar o JWT próprio po
aws-dynamodbAmazon DynamoDB com o Enhanced Client do SDK v2 — modelagem por padrões de acesso (PK, SK, GSI), repository sem Lombok, query × scan, paginação, escrita condicional e optimistic locking, transações, TTL, streams, capacidade, IAM, IaC e testes com LocalStack. Use quando persistir dados em DynamoDB ou
aws-ecs-fargateSpring Boot no Amazon ECS com Fargate — task definition (execution × task role, secrets, logs), service com ALB e circuit breaker com rollback, auto scaling, graceful shutdown, deploy por GitHub Actions, ECS Exec, custos e troubleshooting. Use quando rodar containers na AWS sem Kubernetes ou quando
aws-eksSpring Boot no Amazon EKS — ECR (tags imutáveis, scan, lifecycle), cluster com eksctl, IRSA/Pod Identity em vez de access keys, AWS Load Balancer Controller com ALB Ingress, logs e métricas, rede, segurança e custos. Use quando preparar cluster, registry, permissões de pod ou exposição via ALB na AW
aws-eventbridgeAmazon EventBridge com Spring Boot — event bus, regras e event patterns, targets com retry e DLQ, PutEvents tratando FailedEntryCount, envelope de evento, archive/replay, schema registry e EventBridge Scheduler no lugar de @Scheduled em várias réplicas. Use quando rotear eventos por conteúdo, reagir
aws-keyspacesAmazon Keyspaces (Cassandra gerenciado) com Spring Data Cassandra — conexão TLS na porta 9142, autenticação SigV4, LOCAL_QUORUM, modelagem por consulta, schema por IaC, limitações frente ao Cassandra, IAM e testes. Use quando migrar um modelo Cassandra para a AWS ou compará-lo com DynamoDB.
aws-lambdaAWS Lambda em Java — handler puro, Spring Cloud Function ou serverless-java-container, redução de cold start (SnapStart, init fora do handler, memória, arm64), SQS com partial batch failure, Powertools, RDS Proxy, concorrência, IAM, SAM e testes. Use quando criar ou otimizar uma função Lambda ou dec
aws-observabilityObservabilidade na AWS para Spring Boot — CloudWatch Logs com retenção e Logs Insights, métricas (Micrometer CloudWatch, EMF, Prometheus gerenciado) e seu custo, traces OpenTelemetry/ADOT para o X-Ray, alarmes acionáveis, dashboards e SLOs por plataforma (ECS, EKS, Lambda). Use quando levar logs, mé
aws-parameter-storeConfiguração externa na AWS — Parameter Store (String, SecureString) via spring.config.import, convenção de nomes por ambiente, Parameter Store × Secrets Manager × variáveis de ambiente, IAM e KMS, restart × refresh, e AppConfig para feature flags com rollout gradual. Use quando tirar configuração d
aws-rds-secrets-managerAmazon RDS e AWS Secrets Manager para Spring Boot — banco em subnet privada com TLS verificado, Multi-AZ e backups, dimensionamento do pool e RDS Proxy, senha entregue por External Secrets ou Spring Cloud AWS, rotação e IAM mínimo. Use quando conectar a aplicação a um banco na AWS sem senha no Git.
aws-s3-sqsAmazon S3 e SQS com Spring Cloud AWS — S3Template (upload, download, presigned URL), SqsTemplate e @SqsListener, DLQ, visibility timeout, consumer idempotente, credenciais pela default chain, IAM mínimo e testes com LocalStack. Use quando guardar arquivos no S3 ou processar trabalho assíncrono em fi
aws-sdk-javaBase de todas as skills aws-* — AWS SDK for Java v2 (BOM, clients singleton, HTTP client), default credentials chain (IRSA, task role, SSO, nunca access keys), região, timeouts e retries, paginação, exceptions, Spring Cloud AWS × SDK puro e LocalStack. Use antes de qualquer integração com a AWS em J
aws-sesE-mail transacional com Amazon SES — domínio verificado (DKIM, SPF, DMARC), saída do sandbox, envio pela API com Spring Cloud AWS, templates Thymeleaf, envio assíncrono por fila, bounces e complaints com supressão, IAM por remetente e testes. Use quando enviar e-mail pela AWS ou investigar entregabi
aws-sns-sqsPub/sub na AWS com fan-out SNS → filas SQS — Standard × FIFO, raw message delivery, filter policy, queue policy, DLQ e redrive, SnsTemplate e @SqsListener, consumer idempotente, IAM mínimo, métricas e testes com LocalStack. Use quando um evento precisa chegar a vários serviços na AWS; complementa aw
aws-terraformInfraestrutura como código na AWS com Terraform — módulos e ambientes, estado remoto com lock, providers fixados, exemplos (ECR, SQS com DLQ, DynamoDB, log group, IAM mínimo, RDS com senha gerenciada), segredos fora do state, prevent_destroy, plan/apply no CI com OIDC, scanners, e quando preferir CD
backlog-refinementSessão de refinamento de backlog — preparação do PM, roteiro de 60 minutos com saídas por item, Definition of Ready estendida (privacidade, NFRs, contrato, migration, rollout, métricas), Example Mapping, fatiamento, estimativa e template de card refinado. Use quando preparar ou conduzir um refinamen
bean-validationValidação de entrada com Jakarta Bean Validation no Spring Boot 4 — constraints nos DTOs, @Valid no body, constraints em @RequestParam/@PathVariable, handler que devolve 400 com erros por campo, a regra da interface *ControllerDocs e mensagens no idioma salvo do projeto. Use quando rejeitar input in
cachingCache no Spring Boot — @Cacheable/@CachePut/@CacheEvict, Caffeine local × Redis/ElastiCache distribuído, TTL e tamanho máximo, desenho de chaves, cachear DTOs (nunca entities), invalidação, stampede, tolerância a falha do cache, hit ratio e testes. Use quando uma leitura medida como cara precisar de
code-organizationFundação do pacote — faz uma única vez o questionário de preferências do projeto (comentários, database, Swagger, build tool, mapper, injection) e define o layout flat-by-layer sob br.com.edimilsonldutra, naming, Startup, patterns de entity/DTO/controller/service/exception e o application.yml. Use a
code-styleEstilo de código Java do pacote — comentários (default nenhum), var, guard clauses, quebras de linha, annotations, equals/hashCode, logger SLF4J, idioms modernos, Jackson 3 e chains do REST Assured, sem Lombok. Use ao gerar ou revisar código Java deste padrão ou quando pedirem para ajustar o estilo
contract-testingContract testing entre microsserviços — Pact (consumidor, verificação no provedor, provider states, broker, can-i-deploy), Spring Cloud Contract, contratos de eventos, breaking change do OpenAPI (oasdiff), tolerant reader e integração no CI. Use quando mudar uma API ou um evento consumido por outro
cqrs-event-sourcingCQRS e Event Sourcing no Spring Boot — três níveis de CQRS (do mais simples ao store separado), projeções idempotentes e reconstruíveis, read-your-writes, event store com optimistic concurrency, snapshots, upcasting, LGPD, Axon e quando NÃO usar. Use quando leitura e escrita tiverem necessidades mui
ddd-hexagonalDDD tático e arquitetura hexagonal no Spring Boot — bounded contexts e context map, intensidade de DDD por subdomínio (Core, Supporting, Generic), entities, value objects como records, aggregates e invariantes, domain events, ports e adapters, mapeamento domínio ↔ JPA, ArchUnit, diagnóstico e refato
design-docsDesign doc técnico (tech spec / SDD) usado como spec no desenvolvimento orientado a especificação — quando escrever (e quando um ADR basta), relação com PRD, ADR, threat model e plano, template completo (contexto, objetivos e não-objetivos, desenho, contratos de API, dados e migrations, decisões irr
design-patternsPadrões de projeto (GoF e corporativos) aplicados a Spring Boot no padrão do pacote — Strategy, Factory, Template Method, Adapter, Decorator e Proxy (AOP, @Transactional, auto-invocação), Observer com eventos do Spring, Builder, Singleton e beans sem estado, Chain of Responsibility (filtros), State
docker-and-docker-composeContainerização de Spring Boot — Dockerfile simples ou multi-stage com layers (jarmode tools), usuário não-root, flags de JVM para container, .dockerignore, o plain jar do Gradle, docker-compose com o database e healthcheck por banco. Use quando dockerizar o projeto, subir app e banco localmente ou
emailEnvio de e-mail no Spring Boot 4 com Spring Mail (SMTP) — configuração com timeouts e credenciais por variável de ambiente, package mail com EmailSender, HTML com Thymeleaf, anexos, envio assíncrono depois do commit, validação de destinatário e header injection, Mailpit no desenvolvimento, GreenMail
exception-handlingTratamento global de erros no Spring Boot 4 / Spring 7 — record ExceptionResponse, domain exceptions com @ResponseStatus, @ControllerAdvice com um handler por exception, fix do type do ProblemDetail, os dois formatos de erro, o que nunca chega ao handler e mensagens no idioma salvo. Use quando padro
file-import-exportImportar e exportar dados em XLSX e CSV no Spring Boot 4 — contratos FileImporter/FileExporter com factory, Apache POI (SXSSF para exportar em stream) e Commons CSV, interface MediaTypes, exportação por header Accept, criação em massa validada linha a linha em uma transação, limites, CSV injection,
file-upload-downloadUpload e download de arquivos no Spring Boot 4 — MultipartFile, limites de tamanho, FileStorageService com nome gerado e sanitização contra path traversal, validação de tipo por assinatura (Tika), download em stream com Content-Disposition seguro, metadados no banco com dono, disco local × S3, 413 e
flyway-migrationsMigrations Flyway no Spring Boot 4 — dependencies (starter e módulo do banco), naming V{N}__Descricao.sql, DDL/DML e tipos do MySQL, diferenças para MariaDB, PostgreSQL, SQL Server e Oracle, seeds não determinísticos, sequenciamento e mudanças sem downtime (expand → contract). Use quando criar ou al
github-actions-awsPipeline GitHub Actions para Spring Boot na AWS — build e testes com Testcontainers, OIDC sem access keys, imagem no ECR com tag imutável (git sha), deploy no EKS com verificação e rollback, environments com aprovação, cache, cobertura no PR e trust policy mínima. Use quando criar ou revisar CI/CD p
github-actions-cloudDeploy por GitHub Actions no Google Cloud e no Azure, sem chaves de longa duração — OIDC com Workload Identity Federation (GCP) e federated credentials (Azure) restritos ao repositório e ao environment, imagem no Artifact Registry/ACR com tag imutável, deploy no Cloud Run, GKE, Azure Container Apps
github-actionsCI com GitHub Actions para Spring Boot, sem depender de nuvem — build e testes com Testcontainers (Maven e Gradle), cache, cobertura no PR, imagem no GitHub Container Registry com GITHUB_TOKEN, tags por commit e por versão, permissões mínimas, actions fixadas, Dependabot, CodeQL, branch protection,
guideÍndice do plugin squads — o que o pacote faz, quais skills estão realmente instaladas, como se agrupam e qual usar para cada necessidade. Use quando o desenvolvedor perguntar o que o plugin sabe fazer, qual skill usar ou por onde começar, ou parecer inseguro sobre o próximo passo.
hateoasHATEOAS com Spring HATEOAS no Spring Boot 4 — DTO estendendo RepresentationModel com @Relation, links montados no service com linkTo/methodOn, HAL em JSON, links em XML/YAML, coleções e páginas com PagedResourcesAssembler, Swagger, testes e quando não usar. Use quando a API precisar devolver links (
helm-chartsHelm para Spring Boot — estrutura do chart, values por ambiente, templates com helpers, checksum de ConfigMap, secrets fora do chart, lint/template/diff no CI, upgrade --atomic, rollback e Helm × Kustomize. Use quando empacotar a aplicação como chart ou depurar um release Helm.
idempotencyIdempotência em APIs e consumers Spring Boot — por que requests e mensagens se repetem, Idempotency-Key em POST (chave única, hash do request, replay da resposta, 409/422), transação única, efeitos externos em duas fases, consumers idempotentes, TTL e testes de concorrência. Use quando um POST ou co
integration-testingTestes de integração no Spring Boot 4 com banco real em container — Testcontainers singleton, @SpringBootTest com porta aleatória e REST Assured, isolamento de dados, contrato de erro e segurança, migrations, cache de contexto, outros containers, Awaitility e anti-patterns (nunca H2). Use quando tes
java-modern-featuresJava 17 a 25 aplicado ao padrão do pacote — records, sealed interfaces, pattern matching, switch expressions, text blocks, SequencedCollection, virtual threads no Spring Boot e suas armadilhas, Scoped Values e o que NÃO usar em entities/DTOs. Use quando decidir se uma feature moderna de Java agrega
jvm-performancePerformance de Spring Boot em container — método (medir, achar o gargalo, mudar uma coisa), queries e N+1, HikariCP, memória e GC no pod (MaxRAMPercentage), startup (CDS/AOT), diagnóstico com JFR e dumps, e teste de carga. Use quando a API estiver lenta, o pod levar OOMKilled ou o pool de conexões s
kafkaApache Kafka com Spring Boot 4 — KafkaTemplate idempotente, @KafkaListener, JSON seguro (trusted packages, ErrorHandlingDeserializer), keys e partições, consumer groups, DefaultErrorHandler com DLT e @RetryableTopic, exactly-once, tópicos, Schema Registry, Strimzi/MSK, lag e testes com Testcontainer
kubernetesDeploy de Spring Boot no Kubernetes — Deployment com rolling update sem downtime, probes do Actuator, requests/limits, graceful shutdown, securityContext, Service, Ingress, ConfigMap/Secret, HPA, PDB, Kustomize por ambiente, Flyway em Job e troubleshooting com kubectl. Use quando criar manifests ou
localstackLocalStack para desenvolver e testar integrações AWS sem conta — o que ele prova e o que NÃO prova (IAM, desempenho), docker-compose com init scripts, profile local com trava contra a AWS real, Testcontainers, Terraform contra o emulador, CI e fidelidade por serviço. Use quando rodar ou testar S3, S
maven-configBuild Maven (e equivalentes Gradle) para Spring Boot 4 / Java 25 — parent e properties, o que o BOM gerencia e o que exige versão, starters modulares do Boot 4, Jackson 3, surefire com o agent do Mockito, Flyway plugin, como resolver versões atuais e comandos. Use quando adicionar dependencies ou pl
messagingPonto de partida de mensageria — quando usar (e quando não), comparação de Kafka, RabbitMQ, Artemis, SQS/SNS, EventBridge e outros, desenho de eventos, garantias de entrega, idempotência, ordenação, retry, DLQ, schema, observabilidade, segurança e anti-patterns como dual write. Use para escolher um
microservicesPonto de partida de arquitetura de microsserviços — quando adotar (e quando não), monolito modular primeiro, decomposição por bounded context, dados por serviço, distributed monolith, pré-requisitos de plataforma, catálogo de padrões com a skill de cada um, Strangler Fig e checklist de decisão. Use
modular-monolithMonolito modular com Spring Modulith — módulos por capacidade de negócio, API pública e internals encapsulados, verificação da estrutura em teste, eventos entre módulos com publication registry, @ApplicationModuleTest, dados por módulo e extração para microsserviço. Use quando organizar uma aplicaçã
monolith-decompositionAnálise somente leitura de um monolito Spring Boot existente antes de modularizar ou extrair serviços — inventário e tamanho das capacidades, regra de negócio duplicada, classes sem dono, acoplamento em três dimensões (força, distância, volatilidade), agrupamento em domínios com mapa de donos das ta
observabilityObservabilidade no Spring Boot 4 — Actuator em porta separada, liveness × readiness, métricas Micrometer e Prometheus, métricas e health indicators customizados, tracing OpenTelemetry, logs JSON com trace id e o que monitorar (RED/USE). Use quando adicionar health checks, métricas, tracing ou logs e
paginationPaginação de listagens no Spring Boot 4 — Pageable a partir de page/size/direction, tamanho máximo, ordenação só por campos permitidos, Page × PagedModel do Spring Data (VIA_DTO) × PagedModel HAL do Spring HATEOAS com PagedResourcesAssembler, busca paginada, contagem cara, keyset e testes. Use quand
pdf-reportsRelatórios PDF com JasperReports 7 no Spring Boot 4 — dependencies e o repositório extra no Gradle, templates .jrxml no formato da versão 7, compilação uma vez com cache, PdfExporter na estrutura de exporters, parâmetros, sub-relatórios, QR code com ZXing, fontes no container, memória e testes. Use
postman-newmanTestes de API de caixa-preta com Postman e Newman — onde eles entram (smoke e regressão contra a aplicação rodando, não no lugar do REST Assured), coleção versionada no Git, environments sem segredos, login JWT no pre-request, encadeamento de ids, testes com pm.test e JSON Schema, dados únicos, data
prd-writingPRD que a engenharia consegue executar — template completo (problema, objetivos e não-objetivos, requisitos funcionais e NFRs com números, critérios Given/When/Then, métricas e guardrails, riscos, lançamento, perguntas em aberto), exemplo preenchido e handoff ao tech lead. Use quando escrever, revis
prioritizationPriorização de backlog e iniciativas — RICE com exemplo calculado, ICE, Value × Effort, MoSCoW, Kano, WSJF/Cost of Delay, capacidade para dívida técnica, dependências, como dizer não, vieses e revisão periódica. Use quando ordenar pedidos concorrentes contra um objetivo ou justificar o que fica de f
privacy-lgpdLGPD aplicada a produto e sistemas Spring Boot — conceitos, princípios, bases legais, privacy by design, mapa de dados e RIPD, direitos do titular e como implementá-los, retenção e eliminação ponta a ponta, dados em logs/eventos/analytics, fornecedores, incidentes e checklist para o PRD (não é acons
product-discoveryDescoberta de produto antes de construir — os quatro riscos, enquadramento do problema, Jobs to be Done, entrevistas sem viés (The Mom Test), síntese, árvore de oportunidades, hipóteses testáveis, experimentos baratos e a decisão de seguir, ajustar ou parar. Use antes de escrever um PRD ou quando o
product-metricsMétricas de produto e experimentação — North Star e métricas de entrada, AARRR e HEART, vaidade × acionável, guardrails, funil e coortes, tracking plan sem PII, A/B test (MDE, amostra, duração, peeking, SRM) e como o backend emite eventos de negócio. Use quando definir como medir o sucesso de uma fu
product-roadmapRoadmap orientado a resultado e OKRs — Now/Next/Later em vez de datas, temas e outcomes, horizontes de confiança, OKRs mensuráveis, ligação OKR ↔ roadmap ↔ backlog, planejamento trimestral, capacidade, versões por audiência e como responder pedidos de data. Use quando montar ou revisar roadmap e OKR
product-strategyEstratégia de produto — visão, kernel da estratégia (diagnóstico, política, ações), posicionamento e proposta de valor, análise competitiva, TAM/SAM/SOM sem inventar números, unit economics, business case e build/buy/partner. Use quando definir a direção do produto ou justificar um investimento.
project-claude-mdGera ou atualiza o CLAUDE.md de um projeto Spring Boot — comandos verificados, pré-requisitos de teste, runtime setup, arquitetura não óbvia, settings que não podem sair, política de versões, notas de Docker/CI e o bloco de preferências salvas. Use após o scaffold, quando o projeto não tiver CLAUDE.
rabbitmqRabbitMQ com Spring Boot 4 / Spring AMQP — exchanges, queues, bindings e dead-letter exchange como beans, publisher confirms, @RabbitListener com ack e retry, quorum queues, retry com atraso (TTL e DLX), prefetch, JSON, Docker/Kubernetes/Amazon MQ, segurança, métricas e testes. Use quando criar fila
refactoringRefatoração segura de Java/Spring Boot — refatorar × mudar comportamento, quando não refatorar, rede de segurança com characterization tests, passos pequenos e verdes, catálogo de smells e refatorações, Parallel Change, Branch by Abstraction, Strangler Fig, expand → contract e revisão do PR. Use qua
release-managementLançamentos seguros — deploy × release, feature flags, entrega progressiva (piloto, canary, percentual), critérios de sucesso e de aborto definidos antes, rollback e seu limite com o banco, go/no-go, comunicação, deprecação de APIs e revisão pós-lançamento. Use quando planejar o lançamento de uma fu
repository-understandingMétodo somente leitura para entender um repositório desconhecido — objetivo, orientação, provar que builda e testa, entrypoints, camadas, dados pelas migrations, integrações, configuração, testes, hotspots no Git, uma fatia vertical, riscos com evidência e aderência ao padrão, entregando docs/archit
resiliencesaga-patternscaffoldservice-communicationsolidspring-data-jpastakeholder-communicationswagger-advancedswaggertechnical-product-managementtest-coveragetest-patternstestingthreat-modelingtransactional-outboxuser-storiesweb-config