# Build Reliable Node.js Backends

Backend changes often become inconsistent across routing, business logic, data access, validation, and monitoring. This skill supplies structured Node.js patterns for reliable implementation and review.

## Install

```bash
npx skillstore add sickn33/backend-dev-guidelines
```

## Metadata

- Status: approved
- Slug: sickn33-backend-dev-guidelines
- Skillstore revision: r2
- Version status: missing
- Tree hash: e616484cdf674a4f98429b9f853e47c34a8511064f1e512e2f43f21f4f6cd81d
- Author: sickn33
- GitHub username: sickn33
- License: MIT
- Repository: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/backend-dev-guidelines
- Ref: 5a26d1d61d694db29af9b138c661c1981076d9df
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: env\_access, filesystem, network, external\_commands
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/sickn33-backend-dev-guidelines
- Manifest: https://skillstore.pages.dev/api/skills/sickn33-backend-dev-guidelines/manifest

## Capabilities

- Assesses backend changes with a feasibility and risk index.
- Structures Express applications into routes, controllers, services, repositories, and middleware.
- Applies Prisma repository, transaction, query optimization, and testing patterns.
- Defines Zod schemas, validation middleware, typed DTOs, and error responses.
- Adds Sentry instrumentation, async error handling, audit context, and focused tests.

## Use Cases

- Design a New API Feature: Plan routes, validation, service logic, repository access, error handling, and tests before implementation.
- Review Backend Architecture: Identify layer violations, missing validation, direct database access, weak error boundaries, and testing gaps.
- Standardize a Service Team: Establish shared conventions for configuration, dependency injection, monitoring, naming, repositories, and pull request review.

## Prompt Templates

### Plan a Backend Endpoint

```
Plan a [method] [path] endpoint for [goal]. Include layers, validation, errors, persistence, and tests.
```

### Review a Backend Change

```
Review [files or diff] against these backend guidelines. List behavioral risks, architecture violations, security concerns, and missing tests.
```

### Design a Transactional Workflow

```
Design [workflow] using Express, Prisma, and Zod. Define transaction boundaries, idempotency, error mapping, observability, and integration tests.
```

### Refactor a Legacy Feature

```
Refactor [feature] into routes, controllers, services, and repositories. Preserve behavior, add Zod validation, transaction boundaries, Sentry context, and focused tests.
```

## Limitations

- Focuses on Node.js, Express, TypeScript, Prisma, Zod, and Sentry.
- Provides guidance and examples but does not run migrations, tests, or deployments.
- Requires project-specific review for authorization, privacy, performance, and compliance.
- Assumes existing abstractions such as BaseController, PrismaService, and unifiedConfig.

## Best Practices

- Describe the existing architecture, dependencies, and acceptance criteria.
- Provide relevant routes, schemas, models, errors, and test conventions.
- Validate generated changes with project tests, security review, and runtime checks.

## Anti Patterns

- Do not request a complete rewrite without behavioral constraints.
- Do not place business logic, validation, and database calls directly in routes.
- Do not adopt telemetry or configuration examples without reviewing secret and privacy handling.

## Security Audit

- Audited at: 2026-08-14T09:39:22.747\+00:00
- Summary: All 219 static alerts are false positives caused by Markdown examples, relative imports, placeholders, and TypeScript syntax. Semantic review found overbroad Sentry collection, plaintext development secrets, and direct client exposure of internal error messages.

## Stats

- Views: 135
- Downloads: 7
- Favorites: 0
- Popularity score: 0