メニュー
Scaffold the 7 layered files for a new backend module following the strict convention (types → validation → repository → service → controller → routes → openapi). Use when adding a new feature module under apps/nebula-chat-server/src/modules/.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | backend-module-scaffold |
| description | Scaffold the 7 layered files for a new backend module following the strict convention (types → validation → repository → service → controller → routes → openapi). Use when adding a new feature module under apps/nebula-chat-server/src/modules/. |
| allowed-tools | Read, Write |
| argument-hint | <module-name> |
Creates all 7 layered files for a new module and registers it.
$ARGUMENTS is the module name in kebab-case (e.g. user-profile) and singular.docs/adr/ covers the new module.apps/nebula-chat-server/src/modules/conversation/) as the live reference.Under apps/nebula-chat-server/src/modules/$ARGUMENTS/:
$ARGUMENTS.types.ts — type definitions (domain + DTO shapes).$ARGUMENTS.validation.ts — Zod schemas for request bodies/params/queries.$ARGUMENTS.repository.ts — Drizzle queries (the ONLY place Drizzle is called).$ARGUMENTS.service.ts — business logic; throws AppError subclasses.$ARGUMENTS.controller.ts — thin Express handlers; calls service; no business logic.$ARGUMENTS.routes.ts — Router, wires middleware (validate, rate-limit, cache where needed).$ARGUMENTS.openapi.ts — OpenAPI registry entries.apps/nebula-chat-server/src/routes/index.ts.apps/nebula-chat-server/src/openapi/index.ts.api-contract-keeper to regenerate openapi.yaml + Orval client.test-strategist to add at least one happy-path integration test..repository.ts.Error throws — use AppError subclasses.@backend/* only.index.ts barrels.Generate a new Drizzle migration file from schema changes in `libs/db`. Use when the user changed `libs/db/src/schema.ts` and needs a migration generated, or asks to run the drizzle generate command.
Run pnpm lint:fix and pnpm format across the monorepo and surface any remaining issues. Use before commits, after large edits, or when the user says "lint" or "clean up formatting".
Load the project's conventions into context — reads AGENTS.md and the nearest CLAUDE.md. Use at the start of any non-trivial task, or when you suspect a convention-violation drift. Every build agent should invoke this early.
Load the backend migration index and a specific TICKET-M<n>.md into context. Use before any work on the Fastify / Drizzle / LangChain / libs-folder rearchitecture described in docs/new-backend/. Takes the ticket number as argument.
Regenerate the backend OpenAPI spec and the frontend Orval client. Use after any backend route/schema change, or when the user says "regen the client", "types are out of sync", or "update openapi.yaml".
Scaffold a new Zustand store file following project conventions (no useState, module-level init, @/ aliases, one-file-per-store). Use when creating a new store in apps/nebula-chat-client/src/**/stores/.