メニュー
Scaffolds a complete NestJS hexagonal module with all 4 layers — domain, application, infrastructure, presentation. Use when starting a new bounded context or feature module. Requires /api-setup-shared.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Adds a new domain error to an existing module — extends the module base error, sets error code and monitoring flag, and updates the exception filter mapping. Use when a command or query needs to throw a new business error. Requires /api-add-module.
Adds a new HTTP endpoint to an existing controller — request/response DTOs, Swagger decorators, and command/query wiring. Use after the module, entity, and command/query already exist. Requires /api-setup-shared and /api-add-module.
Creates a CQRS command + handler + in-memory test in a NestJS hexagonal module. Use when adding a write operation (state change) to a module. Command and handler live in the same file. Requires /api-setup-shared.
Creates a complete domain entity in a NestJS hexagonal module — entity, repository interface, test builder, unit tests, SQL repository, in-memory repository, mapper, and optionally domain events. Supports both standalone entities and AggregateRoot entities with domain event publishing. Use when adding a new aggregate to a module's domain layer.
Creates a domain event handler that reacts to events from another module (or the same module). Includes handler class and unit test. Use after domain events have been created with /api-add-domain-entity.
Creates a CQRS query + handler + integration test in a NestJS hexagonal module. Use when adding a read operation (data retrieval) to a module. Query and handler live in the same file. Handlers bypass the domain and repository layers entirely — direct PrismaService only. Requires /api-setup-shared.
| name | api-add-module |
| description | Scaffolds a complete NestJS hexagonal module with all 4 layers — domain, application, infrastructure, presentation. Use when starting a new bounded context or feature module. Requires /api-setup-shared. |
Full scaffold of a new NestJS hexagonal module following the 4-layer architecture.
Read the ## Configuration section in .claude/CLAUDE.md for {SHARED_ROOT} and {MODULE_ROOT}.
Verify shared base classes exist before starting:
{SHARED_ROOT}/cqrs/typed-command.ts{SHARED_ROOT}/cqrs/typed-query.ts{SHARED_ROOT}/errors/base-domain.error.ts{SHARED_ROOT}/errors/base-feature-exception.filter.tsIf any are missing, run /api-setup-shared first.
Create folder structure under {MODULE_ROOT}/{module-name}/:
application/commands/ application/queries/
domain/errors/
infrastructure/
presentation/controllers/ presentation/dto/ presentation/in-proc/
DI tokens — {module-name}.tokens.ts
Load references/tokens-template.md.
Domain errors — domain/errors/
Load references/domain-errors-template.md.
For entities: run /api-add-domain-entity.
Application module — application/{module-name}.module.ts
Load references/application-module-template.md.
Infrastructure layer — for each aggregate, run /api-add-domain-entity (steps 5–7).
Presentation layer — exception filter, controller, DTOs, optional in-proc facade Load references/presentation-template.md.
Root module — {module-name}.module.ts
Load references/root-module-template.md.
Register — add {ModuleName}Module to imports in the app root module.
schema.prisma and run prisma migrate dev.{SHARED_ROOT}/in-proc/) may differ per project — adjust accordingly.