# Core Repository

> Criar, revisar ou orientar contratos e implementações de repositório no padrão Genérico. Usar quando o pedido envolver arquivos `*.repository.ts`, operações de persistência de entidades (create/update/findById/findAll/delete), adaptação de infraestrutura (ex.: Prisma) para contratos de core, tratamento de erros com `Result` e mapeamentos `toDomain/fromDomain`.

- Skill: `eskcti/core-repository` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add eskcti/core-repository`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eskcti/core-repository/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: EskCti (https://skillmd.com/u/eskcti)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/eskcti/core-repository

---


# Repository

## Overview

Aplicar o padrão de repositório para escrita e leitura de entidades de domínio com contratos no `core` e implementação desacoplada em infraestrutura.

## Guidelines

- Definir contrato em `packages/*/core/src/**/provider/*.repository.ts`.
- Reutilizar bases de shared quando aplicável (`CrudRepository`, `CreateRepository`, etc.).
- Implementar em adapter de infraestrutura (ex.: `apps/backend/src/**/*.prisma.ts`) retornando `Result`.
- Mapear domínio explicitamente:
  - `toDomain`: payload do banco -> entidade.
  - `fromDomain`: entidade -> payload de persistência.
- Tratar falhas com `Result.fail(...)` e não vazar exceção no fluxo normal.
- Manter separação CQRS:
  - Repository para comando/escrita e leitura orientada a entidade.
  - Query para leitura/projeção DTO.

## Workflow

1. Confirmar agregados/entidades cobertos pelo repositório.
2. Definir/ajustar contrato no core com métodos mínimos necessários.
3. Implementar adapter de infraestrutura respeitando o contrato.
4. Implementar mapeamento `toDomain`/`fromDomain`.
5. Garantir consistência transacional para operações compostas.
6. Criar/ajustar mocks in-memory para testes de use case.

## References

Consultar `references/repository-pattern.md` para contratos, exemplos de implementação e checklist.
Consultar `../skills-standards.md` para convenção global de nomenclatura.

## Global Standards

- Consultar `../skills-standards.md` para padroes globais de nomenclatura e convencoes gerais entre skills.