backend-dev-guidelines

Enforce Node.js, Express, and TypeScript microservice backend standards.

10|2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/bugrabilge/bilge-development-kit --skill backend-dev-guidelines-bugrabilge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-dev-guidelines
Source: https://github.com/bugrabilge/bilge-development-kit/tree/main/skills/backend-dev-guidelines
Command: npx skills add https://github.com/bugrabilge/bilge-development-kit --skill backend-dev-guidelines-bugrabilge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enforces opinionated, production-grade standards for backend development, ensuring consistency, reliability, and maintainability across Node.js, Express, and TypeScript microservices.

Core Features & Use Cases

  • Architectural Enforcement: Mandates layered architecture (Routes → Controllers → Services → Repositories).
  • Validation & Security: Integrates Zod for input validation and emphasizes error handling with Sentry.
  • Best Practices: Covers dependency injection, naming conventions, testing discipline, and observability.
  • Use Case: When starting a new microservice or refactoring an existing one, this Skill provides a strict blueprint to follow, preventing common pitfalls and ensuring high code quality from the start.

Quick Start

Apply the backend-dev-guidelines skill to ensure the new user service adheres to all architectural and coding standards.

Frequently Asked Questions about backend-dev-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a Node.js and Express microservice for maintainability?

To structure a maintainable Node.js and Express microservice, enforce a layered architecture routing requests from Routes to Controllers, then Services, and finally Repositories. This separation ensures predictable, observable backend systems.

What is the best way to validate input in TypeScript backend microservices?

The best way to validate input in TypeScript backend microservices is integrating Zod for schema validation. This enforces strict data checking and pairs with Sentry error tracking to maintain robust, reliable system boundaries.

Does this backend development approach require dependency injection?

Yes, this backend development approach requires dependency injection. It mandates dependency injection alongside the BaseController pattern to decouple components, ensuring your Node.js microservices remain highly testable and maintainable.

How do I implement a repository pattern with Prisma in Express?

To implement a repository pattern with Prisma in Express, encapsulate database interactions within dedicated repository classes. This abstracts data access away from your services, ensuring predictable data handling and strict architectural boundaries.

When should I enforce strict architectural doctrines in TypeScript backend systems?

You should enforce strict architectural doctrines in TypeScript backend systems when starting a new microservice or refactoring an existing one. This prevents common pitfalls and ensures high code quality, reliability, and observability from the start.