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.