์Šคํ‚ฌ backend-dev-guidelines
โš™๏ธ

backend-dev-guidelines

์•ˆ์ „ โš™๏ธ ์™ธ๋ถ€ ๋ช…๋ น์–ด๐Ÿ”‘ ํ™˜๊ฒฝ ๋ณ€์ˆ˜๐Ÿ“ ํŒŒ์ผ ์‹œ์Šคํ…œ ์•ก์„ธ์Šค

Apply backend development best practices

๋˜ํ•œ ๋‹ค์Œ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค: DojoCodingLabs,Dimon94,sickn33,BrianDai22

Create consistent, maintainable backend services with proven Node.js/Express/TypeScript patterns. This skill provides architectural guidance, code templates, and security-aware patterns for microservices development.

์ง€์›: Claude Codex Code(CC)
๐Ÿ“Š 70 ์ ์ ˆํ•จ
1

์Šคํ‚ฌ ZIP ๋‹ค์šด๋กœ๋“œ

2

Claude์—์„œ ์—…๋กœ๋“œ

์„ค์ • โ†’ ๊ธฐ๋Šฅ โ†’ ์Šคํ‚ฌ โ†’ ์Šคํ‚ฌ ์—…๋กœ๋“œ๋กœ ์ด๋™

3

ํ† ๊ธ€์„ ์ผœ๊ณ  ์‚ฌ์šฉ ์‹œ์ž‘

ํ…Œ์ŠคํŠธํ•ด ๋ณด๊ธฐ

"backend-dev-guidelines" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Create a POST /posts endpoint with authentication

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Complete route definition with SSO middleware
  • BaseController with breadcrumb tracking
  • PostService with dependency injection
  • PostRepository with Prisma queries
  • Zod validation schema for post data
  • Error handling with Sentry capture

"backend-dev-guidelines" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Convert legacy callback code to async/await

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Updated service methods with try/catch
  • AsyncErrorWrapper utility usage
  • Sentry error capture integration
  • Promise.all() for parallel operations
  • Proper error propagation to controller

"backend-dev-guidelines" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Add input validation to existing endpoint

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Zod schema definition with type inference
  • Validation in controller before service call
  • 400 status code on validation failure
  • Error details in response
  • Test cases for invalid input

๋ณด์•ˆ ๊ฐ์‚ฌ

์•ˆ์ „
v4 โ€ข 1/17/2026

All 555 static findings are FALSE POSITIVES. This is a documentation/guide skill containing educational code examples. The detected patterns (shell commands, environment variables, path traversal, crypto algorithms) are in markdown code blocks demonstrating best practices and anti-patterns. The skill actively promotes secure coding - it teaches AGAINST vulnerabilities like path traversal and weak cryptography, not exploits them.

13
์Šค์บ”๋œ ํŒŒ์ผ
5,537
๋ถ„์„๋œ ์ค„ ์ˆ˜
3
๋ฐœ๊ฒฌ ์‚ฌํ•ญ
4
์ด ๊ฐ์‚ฌ ์ˆ˜

์œ„ํ—˜ ์š”์ธ

โš™๏ธ ์™ธ๋ถ€ ๋ช…๋ น์–ด (2)
๐Ÿ”‘ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ (2)
๐Ÿ“ ํŒŒ์ผ ์‹œ์Šคํ…œ ์•ก์„ธ์Šค (2)

ํ’ˆ์งˆ ์ ์ˆ˜

38
์•„ํ‚คํ…์ฒ˜
100
์œ ์ง€๋ณด์ˆ˜์„ฑ
87
์ฝ˜ํ…์ธ 
21
์ปค๋ฎค๋‹ˆํ‹ฐ
100
๋ณด์•ˆ
91
์‚ฌ์–‘ ์ค€์ˆ˜

๋งŒ๋“ค ์ˆ˜ ์žˆ๋Š” ๊ฒƒ

New Feature Implementation

Generate controller, service, and repository code following architectural patterns for new API endpoints.

Codebase Standardization

Establish consistent patterns across multiple microservices with BaseController and unifiedConfig usage.

Express API Development

Build Express routes with proper middleware, validation, and error tracking integration.

์ด ํ”„๋กฌํ”„ํŠธ๋ฅผ ์‚ฌ์šฉํ•ด ๋ณด์„ธ์š”

Create New Endpoint
Create a new /users/:id endpoint with UserController that extends BaseController, includes Zod validation, and proper error handling with Sentry.
Service Pattern
Generate a UserService with dependency injection pattern, including repository calls and async error handling wrapper.
Repository Pattern
Create a UserRepository pattern with PrismaService usage, transaction support, and query optimization examples.
Complete Feature
Generate complete feature with routes, BaseController, service with DI, repository layer, Zod validation schemas, and Jest tests.

๋ชจ๋ฒ” ์‚ฌ๋ก€

  • Use layered architecture: routes delegate to controllers, controllers call services, services use repositories.
  • Always extend BaseController for consistent error handling, breadcrumbs, and Sentry integration.
  • Validate all input with Zod schemas before business logic - reject invalid data early.

ํ”ผํ•˜๊ธฐ

  • Never put business logic in route handlers - delegate to controllers.
  • Never use process.env directly - use unifiedConfig for type safety and testing.
  • Never skip error handling - all async operations need try/catch with Sentry capture.

์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ

What architecture pattern does this skill use?
Layered architecture with routes โ†’ controllers โ†’ services โ†’ repositories separation of concerns.
Can this skill generate tests?
Yes, includes Jest unit and integration test patterns with mocking strategies.
Does this skill work with other frameworks?
Focused on Express/Node.js/TypeScript - patterns adapt to similar frameworks.
How does this skill handle errors?
BaseController provides handleError, handleSuccess, withTransaction, and Sentry integration.
Can I use this for existing codebases?
Yes, provides refactoring guides from legacy patterns to modern architecture.
What validation library is used?
Zod for runtime TypeScript validation with type inference from schemas.

๊ฐœ๋ฐœ์ž ์„ธ๋ถ€ ์ •๋ณด

์ž‘์„ฑ์ž

diet103

๋ผ์ด์„ ์Šค

MIT

์ฐธ์กฐ

main

ํŒŒ์ผ ๊ตฌ์กฐ