Skip to content

gracefullight/pkgs / .agents/skills/oma-backend

oma-backend

Unverified

Implement server APIs, authentication, and application data access. Schema modeling and query tuning use oma-db.

FileKindSize
SKILL.mdskill md9.9 KB
resources/checklist.mdmarkdown2.1 KB
resources/error-playbook.mdmarkdown3.9 KB
resources/examples.mdmarkdown1.9 KB
resources/execution-protocol.mdmarkdown2.3 KB
resources/orm-reference.mdmarkdown3.9 KB
stack/api-template.tsscript8.8 KB
stack/snippets.mdmarkdown12.2 KB
stack/stack.yamlconfig30 B
stack/tech-stack.mdmarkdown1006 B

stack/tech-stack.md

View on GitHub
# Backend Agent - Tech Stack Reference (Node.js)

## Primary Stack
- **Runtime**: Node.js 22+ / Bun 1.2+
- **Language**: TypeScript 5.x (strict mode)
- **Framework**: NestJS 11+ or Hono 4+
- **ORM**: Prisma 6+ or Drizzle ORM
- **Validation**: Zod
- **Database**: PostgreSQL 16+, Redis 7+
- **Auth**: jsonwebtoken, bcrypt
- **Testing**: Vitest, Supertest
- **Migrations**: Prisma Migrate or Drizzle Kit

## Architecture
```
src/
  modules/          # Feature modules (NestJS) or routes (Hono)
  common/           # Shared guards, pipes, interceptors
  prisma/           # Prisma client and schema
```

## Security Requirements
- Password hashing: bcrypt (cost factor 10-12)
- JWT: 15min access tokens, 7 day refresh tokens
- Rate limiting on auth endpoints
- Input validation with Zod schemas
- Parameterized queries via ORM (never raw string interpolation)

## Linter/Formatter
- **ESLint**: with @typescript-eslint
- **Prettier**: consistent formatting
- **Biome**: alternative all-in-one (lint + format)
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 321kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 321kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 321kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 321kUpdated Claude CodeCodexVerifiedInstall