hackbrasil-2026-bora/OiTenta / .agents/skills/module-aggregate
module-aggregate
UnverifiedCria a estrutura padronizada de um agregado dentro de um módulo de negócio, organizando pastas, arquivos-base e nomenclaturas de model, provider e usecase para acelerar a evolução consistente do projeto.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| agents/openai.yaml | config | 348 B |
| assets/common/aggregate/index.ts.tpl | other | 80 B |
| assets/common/model/entity.ts.tpl | other | 385 B |
| assets/common/model/index.ts.tpl | other | 45 B |
| assets/common/provider/index.ts.tpl | other | 49 B |
| assets/common/provider/repository.ts.tpl | other | 393 B |
| assets/common/usecase/index.ts.tpl | other | 20 B |
| assets/usecase/crud/create.usecase.ts.tpl | other | 666 B |
| assets/usecase/crud/delete.usecase.ts.tpl | other | 546 B |
| assets/usecase/crud/find-by-id.usecase.ts.tpl | other | 673 B |
| assets/usecase/crud/find-page.usecase.ts.tpl | other | 748 B |
| assets/usecase/crud/update.usecase.ts.tpl | other | 666 B |
| assets/usecase/example/create.usecase.ts.tpl | other | 741 B |
| scripts/create-aggregate.jsexecutable | script | 8.8 KB |
SKILL.md
View on GitHub---
name: module-aggregate
description: Cria a estrutura padronizada de um agregado dentro de um módulo de negócio, organizando pastas, arquivos-base e nomenclaturas de model, provider e usecase para acelerar a evolução consistente do projeto.
---
# Module Aggregate
Use o script `scripts/create-aggregate.js` para criar de forma deterministica a estrutura base de um agregado dentro de um modulo existente em `modules/<modulo>`.
## Entradas obrigatorias
1. `nome do modulo`, correspondente a uma pasta ja existente em `modules/<modulo>`.
2. `nome do agregado`.
## Entrada opcional, mas recomendada
3. `tipo de estrutura inicial dos casos de uso`:
- `crud`
- `example`
Se o pedido nao informar essa terceira entrada, interrompa e pergunte de forma objetiva:
`Deseja criar a base de usecases em "crud" ou "example"?`
Sem essa resposta, nao executar a skill.
## Fluxo
1. Validar que o pedido informa explicitamente o modulo e o agregado.
2. Validar que `modules/<modulo>` ja existe e contem `src/index.ts`.
3. Normalizar o nome do agregado para `kebab-case` em pastas e arquivos.
4. Se `mode` nao vier no pedido, fazer a pergunta objetiva acima e aguardar.
5. Executar a partir da raiz do projeto:
```bash
node .agents/skills/module-aggregate/scripts/create-aggregate.js --module auth --aggregate user-profile --mode crud
```
6. Verificar ao final:
- `modules/<modulo>/src/<aggregate>/model/<aggregate>.entity.ts`
- `modules/<modulo>/src/<aggregate>/provider/<aggregate>.repository.ts`
- `modules/<modulo>/src/<aggregate>/usecase/index.ts`
- `modules/<modulo>/src/<aggregate>/index.ts`
- `modules/<modulo>/src/index.ts` exportando `./<aggregate>` sem remover exports existentes
## O que a skill cria
- Estrutura do agregado em `modules/<modulo>/src/<aggregate>/`
- Pastas `model`, `provider` e `usecase`
- Entidade base com `Entity` e `EntityState`
- Contrato inicial de repositorio com `CrudRepository`
- Arquivos `index.ts` necessarios para exportar o agregado
- Casos de uso minimos conforme o modo solicitado
## Modos de usecase
### `crud`
Cria a base padronizada:
- `create-<aggregate>.usecase.ts`
- `update-<aggregate>.usecase.ts`
- `delete-<aggregate>.usecase.ts`
- `find-<aggregate>-by-id.usecase.ts`
- `find-<aggregate>-page.usecase.ts`
### `example`
Cria apenas um caso de uso minimo e generico para demonstrar a estrutura:
- `create-<aggregate>.usecase.ts`
## Convencoes obrigatorias
- Nao implementar regras reais de negocio.
- Nao inventar atributos especificos do agregado.
- Nao assumir uma abordagem opinativa de DDD alem da organizacao por agregado ja usada no projeto.
- Nao criar controller, adapter, implementacao Prisma, migration ou qualquer infraestrutura adicional.
- Preservar exports existentes em `modules/<modulo>/src/index.ts`.
- Usar apenas recursos contidos nesta skill em `.agents/skills/module-aggregate`.
## Recursos internos
- `scripts/create-aggregate.js`: materializa a estrutura do agregado.
- `assets/common/`: templates base de `model`, `provider` e `index.ts`.
- `assets/usecase/crud/`: templates dos casos de uso CRUD.
- `assets/usecase/example/`: template do caso de uso minimo de exemplo.
## Guardrails
- Nao executar quando o modulo informado nao existir.
- Nao executar quando o agregado ja existir.
- Nao inferir o modo `crud` ou `example` quando ele nao vier no pedido.
- Nao editar arquivos fora de `modules/<modulo>/src/**`, exceto a propria skill.
- Nao adicionar documentacao extra fora dos arquivos da skill.
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: 198k | 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 |