Name: backend
Author: agarciadk

Instruction file imported from agarciadk/finora (.github/instructions/backend.instructions.md). Copyright stays with the author.

Backend conventions (apps/api)

Before making changes here, read .ai-context/01-architecture.md (backend stack, Prisma, CI/CD) and .ai-context/02-auth-security.md (auth/JWT/cookies, guards, throttling, soft delete, audit log) — this file only surfaces them automatically for this folder, it does not replace them. Also check .ai-context/04-gotchas.md (Prisma/PrismaService proxy, DTO whitelisting, route declaration order) before touching services, DTOs or the Prisma schema. If any of these files are missing or unreadable, proceed using best judgment based on visible code conventions and note the missing context in your response.

Validation

Run the relevant commands for what you touched before considering a backend change done (see root README.md for the full list). If any command fails, fix the underlying issue before proceeding; do not report the task as complete until all relevant commands pass.

pnpm --filter @finora/api lint and pnpm build
pnpm --filter @finora/api test (Jest unit specs, alongside src/**/*.spec.ts)
pnpm --filter @finora/api test:e2e when the change modifies a controller, route, DTO, or guard (i.e., anything that alters the request/response contract)

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

{ "ocm": "1", "id": "agarciadk-finora-backend-instructions", "kind": "skill", "name": "backend", "description": "Use when working on apps/api (NestJS, Prisma, PostgreSQL, authentication, API conventions, backend tests).", "publisher": "agarciadk", "version": "1.0.0", "capabilities": { "domains": [ "coding", "legal" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use when working on apps/api (NestJS, Prisma, PostgreSQL, authentication, API conventions, backend tests)." ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/agarciadk/finora", "path": ".github/instructions/backend.instructions.md", "ref": "77ad811293d40e0d4f6c4ddb3e5727c70b3b42a6", "url": "https://github.com/agarciadk/finora/blob/77ad811293d40e0d4f6c4ddb3e5727c70b3b42a6/.github/instructions/backend.instructions.md", "key": "agarciadk/finora/.github/instructions/backend.instructions.md" }, "applies_to": "apps/api/**" }, "instructions": "# Backend conventions (apps/api)\n\nBefore making changes here, read `.ai-context/01-architecture.md` (backend stack, Prisma, CI/CD) and `.ai-context/02-auth-security.md` (auth/JWT/cookies, guards, throttling, soft delete, audit log) — this file only surfaces them automatically for this folder, it does not replace them. Also check `.ai-context/04-gotchas.md` (Prisma/`PrismaService` proxy, DTO whitelisting, route declaration order) before touching services, DTOs or the Prisma schema. If any of these files are missing or unreadable, proceed using best judgment based on visible code conventions and", "cost": { "context_tokens": 308 } }

backend

About

Backend conventions (apps/api)

Validation

Use it

Manifest

Reviews