Menu
Scaffold a complete new CRUD resource across shared contracts, API entity/repository/service/routes, migration, UI api client, and Jest test. Use when adding a new domain resource (e.g. budgets, goals) to the expense tracker.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Write a vault watcher `parse(email)` JS script from a sample bank/alert email, for the Gmail-to-transaction pipeline. Use when the user gives a sample email (or describes one) and wants a parseScript for a Vault Gmail Watcher.
Builds and updates the API in `packages/api` using this repo's module layout, shared DTOs, response envelope, guards, services, entities, and e2e test conventions. Use for controllers, services, modules, auth flows, database changes, migrations, and integration tests.
Use when building React applications in .tsx files. Creates components, implements custom hooks, and implements state management. Invoke for Server Components, Suspense boundaries, useActionState forms, performance optimization, or React 19 features.
Safely create, apply, and revert TypeORM migrations in packages/api. Use for any database schema change, entity field change, or when a migration fails locally or in deploy.
Write Jest unit tests for API services following this repo's mock/factory/AppError conventions. Use when adding or extending tests in packages/api/src/tests.
| name | scaffold-resource |
| description | Scaffold a complete new CRUD resource across shared contracts, API entity/repository/service/routes, migration, UI api client, and Jest test. Use when adding a new domain resource (e.g. budgets, goals) to the expense tracker. |
Adding one resource touches ~11 files across three packages. Follow this order exactly.
Read .agents/skills/backend-engineer/references/conventions.md first for the exact route/service/repository shapes.
packages/shared/src/contracts/<feature>.ts with Create<Feature>Input, Update<Feature>Input, <Feature>Dto.packages/shared/src/contracts/index.ts.npm run build:shared from the root. Skipping this leaves API/UI on stale types with no error.packages/api/src/entities/<Feature>.entity.ts — class named without Entity suffix, @Entity('<plural_table>'), extends BaseEntity, userId column for ownership.entities: [...] array in packages/api/src/data-source.ts (not auto-discovered).migration skill for the flow and rules.packages/api/src/repositories/<feature>.repository.ts — lazy private get repo(), injectable DataSource, methods findManyForUser / findOneForUser / createEntity / save, plus softDelete for deletion (preferred for user data).packages/api/src/repositories/index.ts — two edits: export const <feature>Repository = new <Feature>Repository(); and add the class to the export { ... } list.packages/api/src/services/<feature>.service.ts — constructor-injected repository defaulting to the singleton, AppError(message, statusCode) for expected failures (404 when findOneForUser misses), logger.info on mutations.packages/api/src/services/index.ts — same two edits as the repository barrel.packages/api/src/routes/<feature>/ with one file per action: get-<feature>s.route.ts, post-<feature>.route.ts, put-<feature>.route.ts, delete-<feature>.route.ts. Each: Router({ mergeParams: true }), Joi schema typed to the shared DTO, inline .validate(req.body) with replyError on error, asyncHandler wrap, reply via utilService. No try/catch.packages/api/src/routes/<feature>.routes.ts mounting the sub-routes.packages/api/src/index.ts: app.use('/api/users/:userId/<feature>s', requireAuth, <feature>Router);packages/ui/src/lib/api/ — either an existing <Feature>Api.ts if one fits, or a new <Feature>Api.ts (PascalCase, e.g. BudgetApi.ts) following the existing clients (AuthApi.ts, ProfileApi.ts, WizardApi.ts). Re-export it from packages/ui/src/lib/api/index.ts. Type params with the shared DTOs (Create<Feature>Input from @expense-tracker/shared), not inline object literals.packages/api/src/tests/<feature>.service.test.ts following the /write-service-test skill (or copy tags.service.test.ts's structure).npm run test:api -- <feature>.service and confirm green.npx prettier --write on every file touched.npm run dev:api boots and the new endpoints respond (401 without token proves mounting + guard).