poc-iam-service

Catálogo de Design Patterns (GoF e auxiliares) com guia de decisão e implementação. Use esta skill sempre que o contexto envolver padrões de projeto, refatoração estrutural, ou quando detectar code smells que um padrão resolve — como: cadeias de if/else para instanciar objetos (Factory), comportamentos condicionais que mudam por estado (State), algoritmos intercambiáveis (Strategy), acoplamento a bibliotecas externas (Adapter), funcionalidades empilháveis (Decorator), notificações reativas (Observer), controle de acesso ou cache em objetos (Proxy), eliminação de duplicação em fluxos similares (Template Method), ou instância única global (Singleton). Também dispare quando o usuário mencionar explicitamente nomes de padrões, pedir para "aplicar um design pattern", "refatorar usando padrões", "desacoplar", ou quando perguntar "qual padrão usar aqui?". Esta skill funciona em qualquer linguagem — os princípios são agnósticos de stack.

Create and edit Excalidraw diagrams programmatically. Use when the user asks to create diagrams, flowcharts, architecture diagrams, wireframes, or any visual drawings in Excalidraw format (.excalidraw files).

Use este skill quando o usuário precisar criar mensagens de commit, revisar commits existentes, ou quando uma tarefa for finalizada e for necessário gerar a mensagem de commit padronizada. Exemplos de ativação: o usuário pede para commitar alterações; o usuário finaliza uma tarefa e precisa da mensagem de commit; o usuário pergunta sobre o padrão de commit do projeto; o usuário pede para revisar ou corrigir uma mensagem de commit.

Use este skill quando o usuario precisar definir padroes de APIs REST/HTTP. Exemplos de ativacao: padronizar versionamento via path; definir convencoes de URLs (plural, ingles, kebab-case); definir paginacao padrao; aplicar RFC 9457 (Problem Details) para erros; adotar OpenAPI 3 e design-first; padronizar codigos de status e payload JSON.

Use este skill quando o usuario precisar padronizar nomenclatura de roles (perfis de acesso) em microservicos. Exemplos de ativacao: definir SCREAMING_SNAKE_CASE para roles; alinhar Keycloak e claims; configurar roles no .NET e Spring Security; manter catalogo oficial de roles e regras de migracao.

Padroes arquiteturais e estrutura de projeto .NET C# / ASP.NET Core: Clean Architecture com camadas numeradas, Repository Pattern com Entity Framework Core, CQRS nativo (sem MediatR) com Commands, Queries, Handlers e Dispatcher, tratamento global de erros (IExceptionHandler, ProblemDetails), Custom Exceptions e Result Pattern, FluentValidation em handlers, estrutura de pastas e dependencias entre projetos. Usar quando: criar novo microservico; criar modulo/feature; implementar endpoints e fluxo CQRS; definir contratos (DTOs/requests/responses); definir ou revisar estrutura de camadas; organizar pastas e projetos; configurar referencias entre projetos.

Padroes transversais de qualidade de codigo .NET C# / ASP.NET Core: convencoes de nomenclatura (PascalCase, camelCase, kebab-case), principios SOLID e Clean Code, estrutura de metodos e classes, async/await e CancellationToken, Dependency Injection, Exception Handling, estilo de codigo. Skill transversal que deve ser aplicada apos geracao de codigo. Usar quando: gerar codigo C#; revisar naming conventions; validar clean code; aplicar regras de qualidade; revisar estilo e formatacao; configurar DI.

Dependencias e configuracoes padrao para projetos .NET C# / ASP.NET Core: pacotes NuGet base, Entity Framework Core com PostgreSQL (padrao oficial) e Oracle (alternativa suportada), Mapster para mapeamento, FluentValidation, CQRS nativo, Polly para resiliencia, RabbitMQ com Rmq.CloudEvents, configuration patterns (appsettings, options, DI), Unit of Work, migrations, interceptors, criacao de bibliotecas profissionais NuGet. Usar quando: criar projeto .NET; adicionar infra (DB, cache, messaging); configurar EF Core; alterar baseline de libs; criar ou publicar class library NuGet.

Estrategias de teste .NET C# / ASP.NET Core: testes unitarios com xUnit + AwesomeAssertions + Moq (padrao AAA), testes de integracao com WebApplicationFactory + Testcontainers (PostgreSQL padrao oficial), testes E2E com Playwright, Dev Containers para ambiente isolado, naming convention (MethodName_Condition_ExpectedBehavior), fixtures reutilizaveis, cobertura > 80% para logica de negocio. Usar quando: criar testes; revisar testes; garantir cobertura; configurar Testcontainers; setup de ambiente de teste.

Skill agregadora de validacao de producao para Java Spring Boot: verifica logging correto, observabilidade, health checks, cache, Actuator, profiles, seguranca minima, Dockerfile otimizado, Kubernetes probes, graceful shutdown. Usar quando: antes de merge; antes de deploy; geracao de build final; validacao pre-producao; review de readiness.

Telemetria e observabilidade completa para frontend React + TypeScript: setup OpenTelemetry Web (WebTracerProvider, auto-instrumentations, BatchSpanProcessor, OTLP HTTP exporter), propagacao de trace context W3C para APIs (fetch/axios interceptors), hook useTracing para spans customizados em componentes, tratamento global de erros (error + unhandledrejection), sanitizacao de dados sensiveis (LGPD/PCI-DSS), telemetria apenas em producao. Usar quando: bootstrapping do projeto; instrumentar telas/fluxos criticos; diagnostico de UX/performance; checklist prod readiness do frontend; configurar tracing distribuido.

Skill agregadora de validacao de producao para React + Vite + TypeScript: verifica telemetria em prod (OpenTelemetry), propagacao W3C Trace Context, config runtime 12-factor (sem rebuild por ambiente), tratamento global de erros, sanitizacao de dados sensiveis (LGPD/PCI-DSS), CI pipeline (type-check/lint/test/build), Dockerfile otimizado, cobertura de testes. Usar quando: antes de merge; antes de deploy; validacao pre-producao; review de readiness; auditoria de repositorio frontend.

Configuracao em runtime e containerizacao para React + Vite + TypeScript: 12-factor config no frontend (runtime e nao build-time), padrao runtime-env.template.js com envsubst gerando runtime-env.js no start do container, window.RUNTIME_ENV como single source of truth, runtimeConfig.ts tipado, Dockerfile multi-stage (Node build + nginx runtime), script entrypoint 40-runtime-env.sh com validacao (falhar cedo), proibido usar import.meta.env para configs entre ambientes. Usar quando: criar/atualizar Dockerfile e pipeline; padronizar variaveis por ambiente; onboarding de novos frontends; PR review de infra/container; configurar deploy sem rebuild.

Estrategias de teste React + Vite + TypeScript: testes unitarios com Vitest + React Testing Library + jest-dom (padrao AAA), testes de hooks com renderHook e act, mock de API com MSW (server/handlers, reset por teste), testes de formularios com react-hook-form, queries semanticas (getByRole, getByLabelText), userEvent para interacao, cobertura minima 70%+, checklist de CI (lint/type-check/test/build). Usar quando: criar testes; revisar testes; garantir cobertura; configurar MSW; setup de ambiente de teste; corrigir bug com teste regressivo.