node-conventions

Standardize Node.js backend project structure and error handling patterns.

9|1|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/AratKruglik/antigravity-sdlc --skill node-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: node-conventions
Source: https://github.com/AratKruglik/antigravity-sdlc/tree/main/plugins/nodejs-plugin/skills/node-conventions
Command: npx skills add https://github.com/AratKruglik/antigravity-sdlc --skill node-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Node.js backend projects often drift in structure and patterns. This skill codifies a unified approach to project layout, configuration access, logging, routing, and error handling that improves maintainability and collaboration.

Core Features & Use Cases

  • Standard project layout guidance for Express, Fastify, and Koa backends, including where to place entry points, routes, controllers, services, and tests.
  • Configuration discipline: a single config module that reads from environment variables and feeds the application with a consistent set of runtime values.
  • Logging and error handling: reuse the project's chosen logger and implement framework-appropriate error handling patterns.
  • Use Case: when starting a new Node.js backend module, apply these conventions to ensure consistency and reduce onboarding time.

Quick Start

Create a new Node.js backend module that follows the prescribed project layout, config, and logging conventions.

Frequently Asked Questions about node-conventions

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

FAQPage Schema
What is the best way to standardize Node.js backend project structure across different frameworks?

Standardizing Node.js backend project structure involves applying a unified blueprint for file layout, configuration access, logging, and error handling. This approach enforces consistent placement of entry points, routes, controllers, and services across Express, Fastify, and Koa.

How do I organize routing and error handling conventions in an Express or Fastify backend?

Organize routing and error handling in Express or Fastify by implementing framework-specific error handling patterns and a shared file structure blueprint. This standardizes where routes, controllers, and services reside, ensuring maintainability and reducing onboarding time.

How do you manage configuration in a Node.js backend to ensure consistent runtime values?

Manage configuration in a Node.js backend by using a single config module that reads from environment variables. This module feeds the application a consistent set of runtime values, enforcing configuration discipline across the entire project.

Does this Node.js backend convention approach work with both Express and Fastify?

Yes, this Node.js backend convention approach works with Express, Fastify, and Koa. It provides standard project layout guidance and implements framework-appropriate error handling patterns tailored to each specific backend framework.

Why do Node.js backend projects need standardized logging and error handling patterns?

Node.js backend projects need standardized logging and error handling patterns to prevent structural drift and improve collaboration. Reusing the project's chosen logger and applying framework-specific error handling ensures long-term maintainability across teams.

When should I apply Node.js backend conventions to a new project module?

Apply Node.js backend conventions when starting a new module to ensure consistency and reduce onboarding time. Implementing the prescribed project layout, config module, and logging conventions early prevents structural drift as the backend grows.