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.
์คํฌ ZIP ๋ค์ด๋ก๋
Claude์์ ์ ๋ก๋
์ค์ โ ๊ธฐ๋ฅ โ ์คํฌ โ ์คํฌ ์ ๋ก๋๋ก ์ด๋
ํ ๊ธ์ ์ผ๊ณ ์ฌ์ฉ ์์
ํ ์คํธํด ๋ณด๊ธฐ
"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
๋ณด์ ๊ฐ์ฌ
์์ 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.
์ํ ์์ธ
โ๏ธ ์ธ๋ถ ๋ช ๋ น์ด (2)
๐ ํ๊ฒฝ ๋ณ์ (2)
๐ ํ์ผ ์์คํ ์ก์ธ์ค (2)
ํ์ง ์ ์
๋ง๋ค ์ ์๋ ๊ฒ
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 a new /users/:id endpoint with UserController that extends BaseController, includes Zod validation, and proper error handling with Sentry.
Generate a UserService with dependency injection pattern, including repository calls and async error handling wrapper.
Create a UserRepository pattern with PrismaService usage, transaction support, and query optimization examples.
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?
Can this skill generate tests?
Does this skill work with other frameworks?
How does this skill handle errors?
Can I use this for existing codebases?
What validation library is used?
๊ฐ๋ฐ์ ์ธ๋ถ ์ ๋ณด
์์ฑ์
diet103๋ผ์ด์ ์ค
MIT
๋ฆฌํฌ์งํ ๋ฆฌ
https://github.com/diet103/claude-code-infrastructure-showcase/tree/main/.claude/skills/backend-dev-guidelines์ฐธ์กฐ
main
ํ์ผ ๊ตฌ์กฐ
๐ resources/
๐ async-and-errors.md
๐ complete-examples.md
๐ configuration.md
๐ database-patterns.md
๐ middleware-guide.md
๐ routing-and-controllers.md
๐ services-and-repositories.md
๐ testing-guide.md
๐ SKILL.md