Viniciustda/OiTenta / .agents/skills/module-repository
module-repository
VerifiedCria contratos de repositório padronizados para agregados dos módulos de negócio, reaproveitando interfaces compartilhadas de persistência e gerando também uma implementação em memória para apoiar testes dos casos de uso.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.4 KB |
| agents/openai.yaml | config | 312 B |
| references/few-shots/fake-user.repository.example.ts | script | 1.3 KB |
| references/few-shots/user.repository.example.ts | script | 257 B |
| references/mandatory-readings.md | markdown | 1.2 KB |
| references/repository-pattern.md | markdown | 1.6 KB |
references/repository-pattern.md
View on GitHub# Repository Pattern
Padrao observado no projeto:
- O contrato do repositorio fica em `modules/<modulo>/src/<aggregate>/provider/<aggregate>.repository.ts`
- O arquivo `provider/index.ts` reexporta o contrato
- O agregado expoe `model`, `provider` e `usecase` por meio de `src/<aggregate>/index.ts`
- O repositorio de dominio usa import de `@poupig/shared`
- A entidade do agregado vem de `../model`
- O teste usa fake em `modules/<modulo>/test/mock/fake-<aggregate>.repository.ts`
- A fake importa tipos do modulo via `../../src` quando isso simplifica o consumo
Padrao CRUD minimo observado em `auth`:
```ts
import { CrudRepository } from "@poupig/shared";
import { User } from "../model";
export interface UserPageParams {
page: number;
perPage: number;
}
export interface UserRepository extends CrudRepository<
User,
User,
User,
UserPageParams
> {}
```
Padrao da fake observado em `auth`:
- usa `Map<string, Entity>` para storage
- aceita dados iniciais no construtor
- expoe leitura da colecao em memoria
- implementa `findPage` retornando `PageResult<TEntity>`
- falha no `update` quando o registro nao existe
Heuristicas seguras:
- Se a entidade ja representa o payload de criacao e atualizacao, reutilize a propria entidade como generic de `CrudRepository`.
- Se nao for seguro reutilizar a entidade, crie tipos auxiliares locais pequenos e explicitos.
- Se o pedido mencionar somente parte das operacoes CRUD, prefira composicao com contratos granulares em vez de `CrudRepository`.
- Em repositorios customizados, evite declarar manualmente um metodo que ja encaixa em contrato compartilhado.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |