메뉴
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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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.
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.
| name | roles-naming |
| description | 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. |
Estabelecer um padrão universal para a nomenclatura de perfis de acesso (Roles) em ecossistemas de microserviços. O foco é garantir que qualquer serviço (independente de linguagem ou framework) e qualquer provedor de identidade (IdP) se comuniquem sem necessidade de transformações complexas de dados.
admin, Admin e ADMIN.ROLE_ do Spring) no banco de dados do IdP.O padrão obrigatório é SCREAMING_SNAKE_CASE.
| Regra | Padrão | Exemplo Correto | Exemplo Incorreto |
|---|---|---|---|
| Case | Caixa alta | EDITOR | editor, Editor |
| Separador | Underscore | TECH_LEAD | tech-lead, TechLead |
| Semântica | Substantivo | ANALYST | CAN_WRITE, DO_EDIT |
| Prefixo IdP | Nenhum | MANAGER | ROLE_MANAGER, APP_MANAGER |
Para evitar confusão em ecossistemas grandes, as roles devem seguir esta lógica:
ADMIN, SUPPORT).BILLING_OPERATOR.FLEET_MANAGER.Para manter a agnosticidade, a responsabilidade é dividida da seguinte forma:
SALES_MANAGER).roles (array de strings)."roles": ["USER", "SALES_MANAGER"]Independente da tecnologia (Python, Go, Node, .NET, Java), o serviço deve:
roles do JWT.ROLE_ do Spring), o serviço deve injetá-lo programaticamente na camada de middleware/configuração, e nunca esperar que ele venha no token.SYSTEM_ADMIN: Acesso total e irrestrito.AUDITOR: Acesso de leitura (Read-Only) em todos os logs e registros.SALES_CONSULTANT: Operações de venda e CRM.INVENTORY_MANAGER: Gestão de estoque e entradas.TECHNICAL_EVALUATOR: Laudos e vistorias técnicas.SCREAMING_SNAKE_CASE?roles?