backend-dev-guidelines

Enforce standardized Node.js Express TypeScript microservice architecture with layered structure.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/jieni777/opencode-config-backup --skill backend-dev-guidelines-jieni777
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-dev-guidelines
Source: https://github.com/jieni777/opencode-config-backup/tree/main/skills/backend-dev-guidelines
Command: npx skills add https://github.com/jieni777/opencode-config-backup --skill backend-dev-guidelines-jieni777

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backend teams often struggle with inconsistent patterns across services, leading to brittle code and hard maintenance. This Skill defines a strict set of backend development standards for Node.js + Express + TypeScript microservices to enforce architecture, quality, and observability.

Core Features & Use Cases

  • Layered architecture enforcement: Routes → Controllers → Services → Repositories.
  • Non-HTTP business logic separation with BaseController, DI, Prisma repositories, Zod validation, and unifiedConfig.
  • Observability and testing discipline including Sentry integration and test strategies.
  • Directory and naming conventions to improve consistency and onboarding.

Quick Start

Follow these guidelines when scaffolding a new backend service to implement the standard architecture and patterns.

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 scalable Node.js backend with TypeScript and Express?

To structure a scalable Node.js backend, enforce a layered architecture routing from Routes to Controllers, Services, and Repositories. This separation isolates non-HTTP business logic and standardizes patterns using BaseController and dependency injection.

What is the best way to standardize Node.js microservices architecture across multiple teams?

Standardizing Node.js microservices architecture involves enforcing strict directory naming conventions, mandatory SKILL.md documentation, and unified configuration. This ensures consistent observability with Sentry and reduces onboarding friction across backend teams.

How do I implement data validation and database repositories in an Express TypeScript project?

Implement data validation and database access by integrating Zod for request validation and Prisma for repository patterns. This enforces type safety and abstracts database operations within the Services layer of your Node.js backend.

Does this backend architecture standard require Sentry and Zod integration?

Yes, this backend architecture standard requires Sentry integration for observability and Zod for validation. It also mandates Prisma repositories, async error handling, and a unifiedConfig setup to maintain quality in Express TypeScript projects.

Why do I need a BaseController and dependency injection in my Node.js backend?

You need a BaseController and dependency injection to separate non-HTTP business logic from Express routes. This pattern enforces a standardized layered architecture, making your Node.js microservices less brittle and easier to maintain.

What testing and observability standards should I follow for Node.js Express microservices?

Node.js Express microservices should follow testing discipline strategies and integrate Sentry for error observability. These standards are enforced alongside async error handling to ensure reliability across your TypeScript backend services.