Viniciustda/OiTenta / .agents/skills/config-prisma
config-prisma
VerifiedInicializar e padronizar a infraestrutura do Prisma no backend NestJS do Genérico com schema modular por domínio (`apps/backend/prisma/models/*.model.prisma`), entrypoint de seed técnico em `apps/backend/prisma/seed/main.ts` (sem seeds de módulos), configuração de `prisma.config.ts`, Docker Compose do backend compatível com `DATABASE_URL` do `.env` e com nomes derivados da identidade do projeto, e criação/ajuste de `DbModule` + `PrismaService` simples no padrão atual do projeto. Usar quando o pedido envolver setup inicial de Prisma, onboarding de módulos com arquivo Prisma próprio ou rebootstrap da infraestrutura de banco no backend.
Config Prisma
Overview
Executar setup determinístico da infraestrutura Prisma no apps/backend, com seed entrypoint neutro (sem tasks de módulo), módulo de banco no Nest e inicialização do Postgres via Docker Compose alinhada ao .env.
O contrato gerado de banco deve ficar compatível com a versão atual do projeto: PrismaService simples, sem TransactionManager nem runInTransaction, e infraestrutura Docker derivada da identidade do projeto para evitar colisões entre repositórios.
Workflow
- Confirmar que o workspace contém
apps/backend/package.json. - Executar o script da skill:
node .agents/skills/config-prisma/scripts/init-prisma-backend.js --dry-runnode .agents/skills/config-prisma/scripts/init-prisma-backend.js --apply --install
- Incluir arquivos Prisma por módulo (repetível):
node .agents/skills/config-prisma/scripts/init-prisma-backend.js --apply --module auth --module product
- Subir banco com Docker Compose do backend:
npm --workspace apps/backend run db:start
- Validar Prisma:
npm --workspace apps/backend run prisma:generate
O que o script garante
- Dependências Prisma no
apps/backend/package.json(prisma,@prisma/client,@prisma/adapter-pg,tsx) com preservação da versão já existente quando o backend já está configurado (sem upgrade forçado por padrão). - Scripts npm de banco/Prisma (
db:start,db:stop,db:logs,prisma:generate,prisma:migrate:*,prisma:seed,prisma:studio). - Remoção de script legado
prisma:cidquando presente. apps/backend/prisma.config.tscomseed: 'npx tsx prisma/seed/main.ts'.apps/backend/prisma/schema.prismacomgenerator client { provider = "prisma-client-js" }no padrão atual.apps/backend/prisma/seed/main.tsinicial (sem implementação de módulos) usandoPrismaClientde@prisma/clientcomPrismaPg.- Autocorreção apenas para templates legados de seed (
generated/client,generated/prisma,cid) sem sobrescrever seeds modernos já estruturados com tasks de módulo. - Não cria nem altera
prisma/seed/tasks/*de módulos específicos. apps/backend/prisma/models/bootstrap.model.prismatemporário apenas quando ainda não existe nenhum*.model.prismade domínio.- Arquivos de módulos Prisma no padrão
<module-name>.model.prisma. apps/backend/docker-compose.ymlalinhado aoDATABASE_URLcarregado deapps/backend/.env(fallback para.env.example) e comname,container_name, volume e defaults de conexão derivados do projeto atual.- Criação/ajuste de
apps/backend/src/db/db.module.tseapps/backend/src/db/prisma.service.ts. PrismaServicesimples no padrão Nest atual, sem dependência deTransactionManager.- Inclusão de
DbModuleemapps/backend/src/app.module.tsquando ausente.
Notes
- O script é idempotente: pode ser executado várias vezes sem duplicar estrutura.
- O script instala usando o nome real do workspace lido de
apps/backend/package.json(fallback:apps/backend). - Quando
.envainda não defineDB_PORT,DB_USEReDB_NAME, o script deriva defaults estáveis a partir do nome do projeto/package para gerar uma instância Docker exclusiva por repositório. - Após criar modelos reais, remover
prisma/models/bootstrap.model.prisma(se existir) e gerar nova migration. - Em backends já evoluídos, o script evita regressão de
seed/main.tspara template neutro quando o arquivo já estiver no padrão moderno com tasks registradas. - Consultar
references/prisma-init-checklist.mdpara checklist operacional.
Risk Logging Guardrails
- Registrar fatos de execucao em
.log/skills.logcom marcador no inicio da linha. - Marcadores minimos esperados:
[CMD],[FILE_CREATE],[FILE_UPDATE],[FILE_DELETE],[DIR_CREATE],[RISK],[FAIL],[AI]. - Sempre registrar
[RISK]quando houver sobrescrita, exclusao, rename/move, ou fallback forcado em arquivos/pastas. - Toda falha inesperada deve gerar
[FAIL]com descricao factual curta do evento. - Operacoes de terminal e alteracoes de arquivos devem usar os utilitarios compartilhados da skill quando existirem; quando o projeto nao tiver essa pasta, o script deve funcionar com fallback local sem bloquear a execucao.
Global Standards
- Priorizar compatibilidade com a estrutura real do monorepo atual e evitar referencias obrigatorias a arquivos auxiliares que nao existam no projeto.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |