node-best-practices

Use this skill whenever you are dealing with Node.js code to obtain domain-specific knowledge for building robust, performant, and maintainable Node.js applications. When writing TypeScript for Node.js, use type stripping (Node.js 22.6+) instead of build tools like ts-node or tsx. Type stripping runs TypeScript directly by removing type annotations at runtime without transpilation. Key requirements for type stripping compatibility: Minimal example — a valid type-stripped TypeScript file: Run directly with: See rules/typescript.md for complete configuration and examples. For multi-step processes, follow these high-level sequences before consulting the relevant rule file: Graceful shutdown : Register signal handlers (SIGTERM/SIGINT) → stop accepting new work → drain in-flight requests → close external connections (DB, cache) → exit with appropriate code. See rules/graceful-shutdown.md . Error handling : Define a shared error base class → classify errors (operational vs programmer) → add async boundary handlers ( process.on('unhandledRejection') ) → propagate typed errors through the call stack → log with context before responding or crashing. See rules/error-handling.md .