Viniciustda/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.
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
nome do modulo, correspondente a uma pasta ja existente emmodules/<modulo>.nome do agregado.
Entrada opcional, mas recomendada
tipo de estrutura inicial dos casos de uso:crudexample
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
- Validar que o pedido informa explicitamente o modulo e o agregado.
- Validar que
modules/<modulo>ja existe e contemsrc/index.ts. - Normalizar o nome do agregado para
kebab-caseem pastas e arquivos. - Se
modenao vier no pedido, fazer a pergunta objetiva acima e aguardar. - Executar a partir da raiz do projeto:
node .agents/skills/module-aggregate/scripts/create-aggregate.js --module auth --aggregate user-profile --mode crud
- Verificar ao final:
modules/<modulo>/src/<aggregate>/model/<aggregate>.entity.tsmodules/<modulo>/src/<aggregate>/provider/<aggregate>.repository.tsmodules/<modulo>/src/<aggregate>/usecase/index.tsmodules/<modulo>/src/<aggregate>/index.tsmodules/<modulo>/src/index.tsexportando./<aggregate>sem remover exports existentes
O que a skill cria
- Estrutura do agregado em
modules/<modulo>/src/<aggregate>/ - Pastas
model,providereusecase - Entidade base com
EntityeEntityState - Contrato inicial de repositorio com
CrudRepository - Arquivos
index.tsnecessarios para exportar o agregado - Casos de uso minimos conforme o modo solicitado
Modos de usecase
crud
Cria a base padronizada:
create-<aggregate>.usecase.tsupdate-<aggregate>.usecase.tsdelete-<aggregate>.usecase.tsfind-<aggregate>-by-id.usecase.tsfind-<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 demodel,providereindex.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
crudouexamplequando 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: 196k | 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: 192k | 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: 192k | 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: 192k | Updated | Claude CodeCodex | Verified | Install |