my-skills

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.

Indice das skills .NET C# / ASP.NET Core: mapa de navegacao entre os 7 modulos de skills consolidados (architecture, code-quality, dependency-config, observability, performance, testing, production-readiness). Usar quando: decidir qual skill consultar; entender a organizacao das skills; mapear uma tarefa especifica ao modulo correto.

Observabilidade completa para .NET C# / ASP.NET Core: Health Checks com AspNetCore.Diagnostics.HealthChecks (liveness/readiness/startup probes para Kubernetes), health checks customizados para regras de negocio, logging estruturado com OpenTelemetry integrado a tracing, scopes de log para correlacao, metricas e telemetria, CancellationToken aplicado corretamente, configuracao por ambiente. Usar quando: implementar health checks; configurar probes Kubernetes; integrar logging com tracing; auditar observabilidade; adicionar metricas; configurar monitoramento.

Performance e otimizacao .NET C# / ASP.NET Core: consultas Entity Framework Core otimizadas (AsNoTracking, AsSplitQuery, Compiled Queries, projecoes, ExecuteUpdateAsync/ExecuteDeleteAsync), estrategias de caching (IMemoryCache local, IDistributedCache/Redis distribuido), HttpClient otimizado com IHttpClientFactory e Polly (retry, circuit breaker), paginacao eficiente, streaming com IAsyncEnumerable. Usar quando: otimizar queries EF Core; implementar caching; configurar HttpClient; code review de performance; pull request review; investigar lentidao.

Checklist de prontidao para producao .NET C# / ASP.NET Core: configuracao de logging/tracing com OpenTelemetry (OTLP padrao oficial), formato de logs estruturados JSON, sanitizacao de dados sensiveis (CPF, email, telefone), niveis de log por ambiente, correlacao via TraceId, exportacao OTLP, checklist consolidado de deploy. Usar quando: preparar servico para producao; configurar OpenTelemetry; revisar logs; sanitizar dados; validar deploy; garantir observabilidade completa.

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.

Retrieves up-to-date documentation, API references, and code examples for any developer technology. Use this skill whenever the user asks about a specific library, framework, SDK, CLI tool, or cloud service -- even for well-known ones like React, Next.js, Prisma, Express, Tailwind, Django, or Spring Boot. Your training data may not reflect recent API changes or version updates. Always use for: API syntax questions, configuration options, version migration issues, "how do I" questions mentioning a library name, debugging that involves library-specific behavior, setup instructions, and CLI tool usage. Use even when you think you know the answer -- do not rely on training data for API details, signatures, or configuration options as they are frequently outdated. Always verify against current docs. Prefer this over web search for library documentation and API details.

Padroes arquiteturais e estrutura de projeto React + Vite + TypeScript: organizacao de pastas (flat, intermediaria, feature-based), separacao de UI reutilizavel vs logica de dominio, path aliases com @/, convencoes de pastas (kebab-case) e arquivos (PascalCase.tsx), public API via index.ts, shared vs features, agrupamento por dominio. Usar quando: criar projeto React novo; criar feature nova; refatorar estrutura de pastas; revisar PR com mudancas de imports/pastas; decidir onde colocar codigo; organizar componentes/paginas/hooks; configurar aliases no Vite/tsconfig.

Padroes transversais de qualidade de codigo React + Vite + TypeScript: convencoes de nomenclatura (Ingles, PascalCase componentes, camelCase variaveis, kebab-case pastas), estrutura e tamanho de componentes (max ~300 linhas), React Hooks patterns (useState tipado, useEffect cleanup, useCallback/useMemo com motivo), TypeScript strict sem any, props tipadas com interface, componentes genericos, imports organizados com aliases, renderizacao condicional segura, tratamento de erros. Skill transversal que deve ser aplicada apos geracao de codigo. Usar quando: gerar codigo TSX; revisar PR; refatorar e padronizar; validar naming conventions; criar componentes e hooks.

Configura projetos React (Vite) para deploy em subpath no Kubernetes, permitindo múltiplas POCs compartilharem um único host (ex: host/poc-01, /poc-02). Use sempre que o contexto envolver: deploy de SPA React em subpath, base path no Vite, React Router basename, Nginx SPA fallback em subpath, Dockerfile multi-stage para React com path dinâmico, Ingress com múltiplos paths, ou variações de "rodar frontend em /meu-path em vez da raiz". Dispare com "multipath", "subpath", "base path", "compartilhar host", "deploy de POC", "múltiplas POCs no mesmo domínio", ou ao criar projeto React para Kubernetes com path diferente de "/". Gera Dockerfile, nginx.conf.template, Ingress e ajusta vite.config.ts e React Router.

Use este skill quando o usuario precisar definir padroes de APIs REST/HTTP (agnostico a linguagem/framework). 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; validar contrato com Spectral linter.

Use este agente para gerar diagramas técnicos (Mermaid) em Product Requirements Documents (PRDs) ou especificações de arquitetura. Ative o agente mermaid-diagram-generator sempre que o usuário solicitar representação visual de fluxos de sistemas, integrações de APIs, microsserviços ou lógica de processos (ex: gateways de pagamento, sistemas de notificação orientados a eventos ou brokers de mensageria).

Orquestrador de testes QA end-to-end. Recebe PRD e/ou techspec, conduz entrevista para extrair expectativas do usuario, analisa requisitos, propoe plano de tasks por user story/feature, aguarda aprovacao do usuario, cria estrutura de evidencias, dispara subagentes via qa-task-runner e consolida relatorio final. Usar quando: executar testes QA; validar PRD/techspec; criar plano de testes E2E; orquestrar subagentes de teste.

Guide for writing and auditing tests across all layers — unit, integration, and E2E. Use this skill when writing new tests, creating test files, deciding what to test at each layer, choosing between unit vs integration vs E2E, and also when auditing existing tests, cleaning up redundant tests, or finding missing coverage. Triggers on: "write tests", "add tests for", "create unit tests", "create integration tests", "create e2e tests", "should I test this", "what layer should this test be", "audit tests", "test cleanup", "which tests can I delete", "what tests am I missing", "review test quality".

Padroes arquiteturais e estrutura de projeto Java Spring Boot 3+ / Java 21: Clean Architecture, Hexagonal, Repository Pattern com MapStruct, CQRS type-safe, tratamento de erros com ProblemDetail RFC 7807, estrutura multi-modulo Maven, organizacao de pacotes por feature/dominio. Usar quando: criar servico/modulo/feature Java; definir camadas domain/application/api/infra; implementar CQRS; configurar exception handler global; definir transacoes em use cases; organizar pastas e pacotes; configurar dependencias entre modulos.

Padroes transversais de qualidade de codigo Java Spring Boot / Java 17+: HARD RULES numeradas para naming, metodos, classes, DI, null handling, exceptions, collections, records, sealed classes, logging e estilo. Uso correto de DTOs, MapStruct, validacao Bean Validation, Optional, null safety. Skill transversal que deve ser aplicada apos geracao de codigo. Usar quando: gerar codigo Java; revisar naming conventions; validar clean code; aplicar regras de qualidade; revisar DTOs e mapeamentos.

Dependencias e configuracoes padrao para projetos Java Spring Boot 3+: pom.xml/build.gradle base, Spring Data JPA com HikariCP, Flyway migrations, MapStruct, OpenAPI/Swagger, Resilience4j, Spring Cache, WebClient, Micrometer/Prometheus, profiles de ambiente (dev/test/prod), Spotless formatting. Usar quando: criar projeto Java; adicionar nova integracao; configurar JPA/Hibernate; alterar infraestrutura; configurar profiles; setup de migrations.

Observabilidade completa para Java Spring Boot: logging estruturado JSON com OpenTelemetry, tracing distribuido com Jaeger, metricas customizadas com Micrometer/Prometheus, Health Checks com Actuator (liveness/readiness/startup probes), correlacao trace_id/span_id via MDC, sanitizacao de dados sensiveis (LGPD/PCI-DSS), configuracao Logback por profile. Usar quando: implementar logging; configurar health checks; adicionar metricas; setup tracing; auditar observabilidade; configurar probes Kubernetes.

Performance e otimizacao Java Spring Boot: consultas JPA otimizadas (fetch join, projecoes, paginacao eficiente), deteccao e correcao de N+1, QueryDSL e Spring Data Specification para queries dinamicas, estrategias de caching (Caffeine local, Redis distribuido), batch processing com EntityManager, WebClient com pool de conexoes e timeout, HikariCP pool. Usar quando: otimizar queries; revisar performance JPA; implementar caching; configurar WebClient; code review de performance; pull request review.

Estrategias de teste Java Spring Boot: testes unitarios com JUnit 5 + AssertJ + Mockito (padrao AAA), testes de integracao com Spring Boot Test + Testcontainers (PostgreSQL), testes E2E com Playwright, Dev Containers para ambiente isolado, naming convention (methodName_Condition_ExpectedBehavior), fixtures reutilizaveis, cobertura > 70% para logica de negocio. Usar quando: criar testes; revisar testes; garantir cobertura; configurar Testcontainers; setup de ambiente de teste.

Workflow de auditoria de seguranca stack-agnostico orientado por sub-agents reais com execucao em Docker. Detecta linguagem, framework e superficie de ataque (Fase 0); resolve escopo via PRD/TechSpec/OpenAPI quando fornecidos ou audita superficie completa como fallback (Fase 1); monta matriz de casos de teste de seguranca aplicaveis baseada em OWASP Top 10 2021 (Fase 2); orquestra sub-agents especializados em paralelo (SAST, SCA, secrets, container, auth, crypto, IaC) executando ferramentas open-source via imagens Docker oficiais (Semgrep, Trivy, Gitleaks, Hadolint, OWASP Dependency-Check, Checkov, gosec, cargo-audit); consolida achados em SARIF e relatorio markdown priorizado. Suporta Java, Node, Python, Go, Rust, .NET. Usar quando: auditar seguranca de projeto; pre-deploy; pre-merge de mudancas sensiveis; security review periodico; escopo via PRD/TechSpec ou auditoria completa.

Consolidador de relatorios QA. Recebe qa_session.json e todos os relatorios individuais (qa_report_task_XX.md) gerados pelos subagentes qa-task-runner, e produz um relatorio consolidado completo em Markdown e/ou PDF. Estrutura: sumario executivo, resultado por feature, detalhes de falhas (expected vs actual), evidencias referenciadas e recomendacoes de investigacao. Usar quando: consolidar resultados de testes QA; gerar relatorio final de sessao de testes.

Subagente de execucao de testes QA para uma user story ou feature especifica. Recebe contexto do qa-orchestrator (qa_session.json + trecho do PRD/techspec), planeja casos de teste, executa via Playwright CLI (UI), cURL (API) e Docker CLI (banco de dados), salva todas as evidencias, e gera relatorio individual. NUNCA modifica testes para forcam pass. NUNCA sugere correcoes de codigo. Reporta o que encontrou com total fidelidade. Usar quando: executar task de teste QA individual; validar user story especifica.