abrahamvilchesdelacruz/ididntcatchthat/api-shared
Claude Code and agent skill by abrahamvilchesdelacruz/ididntcatchthat
- community
Checking that the SKILL.md file is still in the repository.
SharedModule global, bounded context shared, env validation Joi en apps/api/. Trigger: Al crear o modificar SharedModule, añadir validación de variables de entorno con Joi, o infraestructura transversal.
Install
npx vskill@latest install abrahamvilchesdelacruz/ididntcatchthat/api-sharedSKILL.md
The same SKILL.md was published earlier as abrahamvilchesdelacruz/ididntcatchthat/api-shared.
When to Use
- Al crear o modificar el módulo
SharedModuleglobal - Al crear un shared interno de un bounded context
- Al añadir validación de variables de entorno
- Al registrar infraestructura transversal (logger, event bus, filtros globales)
Leereferences/docs.mdpara skills relacionadas, ADRs y documentación externa.
Leereferences/module-patterns.mdpara los módulos completos (SharedModule,AppModule,AchievementModule) y el schema Joi de variables de entorno.
Structure
Shared interno por bounded context
Los bounded contexts con múltiples submódulos tienen un shared/ propio que contiene:
- `domain/` — value objects, interfaces o constantes que cruzan submódulos dentro del BC
- `infrastructure/framework/` — el módulo NestJS del BC completo (wiring), exception registry del BC
Env Validation — Joi (esencial)
Reglas de env:
abortEarly: falsesiempre — ver todos los errores de una.required()en todo lo que no tiene default — falla en bootstrap, no en runtime- Joi para env — no Zod. Es la integración nativa de
@nestjs/config - La configuración vive en
ConfigModule.forRoot()en `AppModule`, no enSharedModule
ConfigModule y TypeORM — van en AppModule
ConfigModule.forRoot() y TypeOrmModule.forRootAsync() se configuran en `AppModule`, no en SharedModule.
ConfigModulese declaraisGlobal: truepara queConfigServiceesté disponible en todos los módulos- TypeORM se configura mediante
buildTypeOrmDataSourceOptions()que parseaDATABASE_URL SharedModuleno importa ni re-exportaConfigModuleniTypeOrmModule
SharedModule — lo que exporta
SharedModule provee infraestructura transversal que todos los módulos necesitan sin importarla explícitamente:
| Token / clase | Implementación | Descripción | |
|---|---|---|---|
LOGGER_SERVICE | PinoLogger | Logger estructurado | |
DOMAIN_EVENT_PUBLISHER | AmqpMessageBus | Publica eventos al bus | |
DOMAIN_EVENT_CONSUMER | AmqpMessageBus | Consume eventos del bus | |
GlobalExceptionRegistry | — | Registry central de excepciones | |
HttpExceptionFilter | — | Filtro HTTP global (vía APP_FILTER) |
Criteria + TypeORM
El patrón Criteria se aplica directamente en cada repositorio con QueryBuilder — no hay un converter compartido. Cada repositorio aplica sus propios filtros porque puede tener relaciones y aliases distintos.
Ver implementación canónica en skill api-criteria.
Reglas
SharedModulese importa una sola vez enAppModule— es@Global()ConfigModuleyTypeOrmModulese configuran enAppModule, no enSharedModule- Los bounded context modules no son globales — se importan explícitamente en
AppModule synchronize: falsesiempre — las migraciones son la fuente de verdad del schema- La validación de env falla en bootstrap — si falta una variable, la app no arranca
- BC modules exportan solo lo que otros BCs necesitan (tokens de repositorio o domain services)
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/api-shared/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/abrahamvilchesdelacruz/ididntcatchthat/api-shared)