Skills de
arquitetura e testes NestJS.

Skill Transversal

Entidades e Domínio

Prompt de Instalação das 11 Skills

Execute este prompt uma única vez por máquina. O agente lê o boilerplate real do projeto e gera as 11 skills com base no código concreto — não em exemplos genéricos.

# PROMPT — Criar as 11 Skills de Arquitetura NestJS

Você está dentro de um projeto NestJS que usa Clean Architecture + Feature-Based.
Leia o código real em `src/` e o boilerplate em `boilerplate/src/application/listas/`
antes de criar qualquer skill. Quando docs e código divergirem, o código prevalece.

## 0. Leitura obrigatória antes de começar

Leia nesta ordem (sem criar nada ainda):
1. `docs/arquitetura-oficial/00-INDICE.md`
2. `docs/arquitetura-oficial/01-visao-geral.md`
3. `docs/arquitetura-oficial/03-estrutura-de-modulo.md`
4. `docs/arquitetura-oficial/04-camada-application.md`
5. `docs/arquitetura-oficial/05-camada-infra.md`
6. `docs/arquitetura-oficial/06-camada-shared.md`
7. `docs/arquitetura-oficial/skills/README.md`
8. `boilerplate/src/application/listas/` (leia todos os arquivos)
9. Um módulo real em `src/application/` de sua escolha (leia tudo)

## 1. Criar as 11 skills em `.claude/skills/`

Para cada skill abaixo, crie `.claude/skills//SKILL.md` com:
- Frontmatter: `name`, `description` (acionado pelo agente automaticamente)
- O que a skill ensina (padrões concretos do código real, não genéricos)
- Template base com código real do boilerplate
- Anti-patterns específicos desta camada
- Referência ao(s) arquivo(s) de boilerplate correspondentes

### Skills a criar:

1. **arquitetura-geral** — visão macro, fluxo HTTP→DB, regras de dependência,
   onde cada artefato vai, como criar um módulo do zero, divergências documentadas

2. **controller** — estrutura com `withApmAndTransaction` em todo método,
   `useTransaction: true/false`, `transformInput`, `@DocumentApiEndpoint`,
   `@JwtExport()`, versionamento `v1/`, o que o controller NÃO pode fazer

3. **use-case** — orquestrador + sub use case, `implements IGenericUseCase`,
   método único `executar()`, logging INICIO/FIM, `Resposta` com mensagem
   UPPERCASE, `@Inject('IXyzRepository')`, transação como parâmetro

4. **entidade** — dois tipos distintos: entidade de domínio (input/output,
   `static fromDto()`, sem decorators) e entidade de banco (auditoria obrigatória,
   sem `fromDto()`). Localização correta de cada uma.

5. **adapter** — interfaces TypeScript puras, prefixo `I`, `Transaction`
   em escrita, `incluirDesativados?` em leitura, por que usar token string

6. **repository** — `implements IXyzRepository`, soft delete obrigatório
   em toda leitura, campos de auditoria em escrita, retorno via mapper,
   padrão 3 passos para queries customizadas (count → ids → detalhes)

7. **model** — `@Table({ tableName, schema, timestamps: false })`,
   `field: 'snake_case'`, campos de auditoria obrigatórios, relacionamentos,
   nunca exportar fora de `infra/`

8. **infra** — mappers `toDomain()` e `toPersistence()`, decorator
   `withApmAndTransaction` e seus parâmetros, `@JwtExport()`,
   `@DocumentApiEndpoint()`, `@Public()`, serviços externos

9. **modules** — imports obrigatórios, `SequelizeModule.forFeature()`,
   guards por módulo, token string para repos, como adicionar ao AppModule

10. **shared** — regra de inclusão (2+ módulos), o que `SharedModule` exporta,
    `IGenericUseCase`, utilitários, enums, decisão local vs. shared

11. **domain** — dois locais de domínio, entidades de banco em
    `shared/domain/entities/database/[schema]/`, enums, funções puras,
    `JwtPayload`, `Resposta`, tabela de decisão "onde colocar este artefato?"

## 2. Convenções dos arquivos SKILL.md

- `description` deve descrever quando o agente deve aplicar a skill
  automaticamente (ex: "Use quando criar um endpoint HTTP em NestJS seguindo
  Clean Architecture. Trigger: criar controller, endpoint, route handler.")
- Templates devem usar código do boilerplate, não exemplos inventados
- Documentar divergências conhecidas entre docs e código real como alertas
- Máximo 600 linhas por skill. Se exceder, divida em sub-seções

## 3. Verificação após criação

Após criar todas as 11 skills:
1. Liste o conteúdo de `.claude/skills/` — devem existir 11 pastas
2. Teste uma skill: pergunte "Crie um controller para um módulo de avaliações"
   e verifique se o agente usa os padrões corretos sem precisar de instrução
3. Reporte quais skills foram criadas e quais padrões cada uma capturou

## Regras inegociáveis

- Nunca inventar padrões não encontrados no código real
- Quando código e docs divergirem, sempre documentar na skill e usar o código
- Skills descrevem o projeto específico, não Clean Architecture genérica
- Incluir pelo menos um exemplo de código real (do boilerplate) em cada skill