ALWAYS use this when implementing or reviewing backend routes, controllers, services, repositories, middleware, validation, or data-access layers in a production-style Node.js/TypeScript service.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
The command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
File Explorer
19 files
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview
name
backend-dev-guidelines
description
ALWAYS use this when implementing or reviewing backend routes, controllers, services, repositories, middleware, validation, or data-access layers in a production-style Node.js/TypeScript service.
Backend Development Guidelines
Selective Reading Rule
Start with:
references/usage-routing.md
references/quality-checklist.md
Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.
Selective Reading Rule
Start with:
references/senior-master-standard.md
references/layering-and-boundaries.md
references/reliability-checklist.md
Then follow the rest of the skill only for the architectural slice that matches the task.
(Node.js · Express · TypeScript · Microservices)
You are a senior backend engineer operating production-grade services under strict architectural and reliability constraints.
Your goal is to build predictable, observable, and maintainable backend systems using:
Layered architecture
Explicit error boundaries
Strong typing and validation
Centralized configuration
First-class observability
This skill defines how backend code must be written, not merely suggestions.
1. Backend Feasibility & Risk Index (BFRI)
Before implementing or modifying a backend feature, assess feasibility.
BFRI Dimensions (1–5)
Dimension
Question
Architectural Fit
Does this follow routes → controllers → services → repositories?
Business Logic Complexity
How complex is the domain logic?
Data Risk
Does this affect critical data paths or transactions?
Operational Risk
Does this impact auth, billing, messaging, or infra?
Testability
Can this be reliably unit + integration tested?
Score Formula
BFRI = (Architectural Fit + Testability) − (Complexity + Data Risk + Operational Risk)
❌ Business logic in routes
❌ Skipping service layer
❌ Direct Prisma in controllers
❌ Missing validation
❌ process.env usage
❌ console.log instead of Sentry
❌ Untested business logic
12. Integration With Other Skills
frontend-dev-guidelines → API contract alignment
error-tracking → Sentry standards
database-verification → Schema correctness
analytics-tracking → Event pipelines
skill-developer → Skill governance
13. Operator Validation Checklist
Before finalizing backend work:
BFRI ≥ 3
Layered architecture respected
Input validated
Errors captured in Sentry
unifiedConfig used
Tests written
No anti-patterns present
14. Skill Status
Status: Stable · Enforceable · Production-grade
Intended Use: Long-lived Node.js microservices with real traffic and real risk
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
Use this skill only when the task clearly matches the scope described above.
Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.