Viniciustda/OiTenta / .agents/skills/config-new-module
config-new-module
VerifiedCriar de forma deterministica um novo modulo de negocio dentro de `modules/` neste monorepo a partir de um nome de modulo e de um namespace npm obrigatorio, scaffoldar o modulo NestJS correspondente em `apps/backend/src/modules/<nome-do-modulo>` com controller e registro automatico no AppModule, e criar a estrutura base do modulo no frontend em `apps/frontend/src/app/(private)/<nome-do-modulo>/page.tsx`, `apps/frontend/src/modules/<nome-do-modulo>/pages/<nome-do-modulo>.page.tsx` e `apps/frontend/src/modules/<nome-do-modulo>/components/<nome-do-modulo>.component.tsx`. Use quando Codex precisar scaffoldar um workspace como `modules/auth`, copiar os templates fixos desta skill, registrar a dependencia do modulo em `apps/frontend` e `apps/backend`, garantir `ts-node` e `modules/*` no `package.json` raiz, instalar dependencias, executar o build do projeto e rodar os testes do modulo recem-criado.
Config New Module
Usar o script scripts/create-module.js em vez de recriar a estrutura manualmente.
Fluxo
- Confirmar que o pedido informa explicitamente
nome do moduloenamespace. - Nao prosseguir sem namespace.
- Executar a partir da raiz do projeto:
node .agents/skills/config-new-module/scripts/create-module.js --module auth --namespace @meu-projeto
- Verificar ao final:
modules/<nome-do-modulo>criado.apps/backend/src/modules/<nome-do-modulo>/<nome-do-modulo>.module.tscriado.apps/backend/src/modules/<nome-do-modulo>/<nome-do-modulo>.controller.tscriado.apps/frontend/src/app/(private)/<nome-do-modulo>/page.tsxcriado.apps/frontend/src/modules/<nome-do-modulo>/pages/<nome-do-modulo>.page.tsxcriado.apps/frontend/src/modules/<nome-do-modulo>/components/<nome-do-modulo>.component.tsxcriado.apps/backend/src/app.module.tsimportando e registrando<NomeDoModulo>Module.apps/frontend/package.jsoneapps/backend/package.jsoncontendo@namespace/<nome-do-modulo>.package.jsonraiz contendots-nodeemdevDependencies.package.jsonraiz contendomodules/*emworkspaces.npm install,npm run buildenpm run test --workspace @namespace/<nome-do-modulo>executados com sucesso.
Comportamento
- Criar
modules/caso ainda nao exista. - Recusar execucao quando
--namespacenao for informado. - Recusar execucao quando
modules/<nome-do-modulo>ja existir. - Recusar execucao quando
apps/backend/src/modules/<nome-do-modulo>ja existir. - Recusar execucao quando
apps/frontend/src/modules/<nome-do-modulo>ouapps/frontend/src/app/(private)/<nome-do-modulo>ja existirem. - Copiar os arquivos de
assets/module-template/e substituir placeholders pelo nome do modulo e namespace informados. - Copiar os arquivos de
assets/nestjs-module-template/paraapps/backend/src/modules/<nome-do-modulo>/, substituindo__MODULE_NAME__e__MODULE_CLASS_NAME__(PascalCase do nome). - Copiar os arquivos de
assets/frontend-module-template/paraapps/frontend/src/, substituindo__MODULE_NAME__,__MODULE_CLASS_NAME__(PascalCase) e__MODULE_DISPLAY_NAME__(Title Case). - Adicionar import e registro de
<NomeDoModulo>Moduleemapps/backend/src/app.module.ts. - Garantir a dependencia do modulo em
apps/frontend/package.jsoneapps/backend/package.json. - Garantir
ts-node@^10.9.2nopackage.jsonraiz. - Garantir
apps/*,modules/*epackages/*emworkspaces, preservando entradas extras existentes. - Preservar arquivos nao relacionados.
Templates
Os arquivos-base do workspace ficam em assets/module-template/:
jest.config.tspackage.jsontsconfig.jsonsrc/index.tstest/index.test.ts
Os arquivos-base do modulo NestJS ficam em assets/nestjs-module-template/:
module.ts→ copiado como<nome-do-modulo>.module.tscontroller.ts→ copiado como<nome-do-modulo>.controller.ts
Os arquivos-base do frontend ficam em assets/frontend-module-template/:
route-page.tsx→ copiado comoapp/(private)/<nome-do-modulo>/page.tsxpage.tsx→ copiado comomodules/<nome-do-modulo>/pages/<nome-do-modulo>.page.tsxcomponent.tsx→ copiado comomodules/<nome-do-modulo>/components/<nome-do-modulo>.component.tsx
Placeholders substituidos nos templates NestJS: __MODULE_NAME__ (kebab-case) e __MODULE_CLASS_NAME__ (PascalCase).
Placeholders substituidos nos templates do frontend: __MODULE_NAME__ (kebab-case), __MODULE_CLASS_NAME__ (PascalCase) e __MODULE_DISPLAY_NAME__ (Title Case).
Editar esses arquivos antes do script somente quando o template padrao precisar mudar.
Restricoes
- Nao inferir namespace quando ele nao vier no pedido.
- Nao pular
npm install,npm run buildou o teste do workspace criado. - Nao criar documentacao extra fora dos recursos da propria skill.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |