Skip to main content
subagent CX Codex

node-specialist · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

node-specialist is a Codex subagent for Node.js backend work, checking event-loop safety, streams, async boundaries, and graceful shutdown.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/node-specialist.toml
Open on GitHub

What node-specialist does

This subagent treats Node.js backend tasks as production runtime engineering rather than generic JavaScript edits. It maps the application entry point, async boundaries, persistence layers, and external dependencies before modifying files. Every edit stays minimal to maintain process and deployment contracts.

The review targets event-loop blocking on hot paths, stream backpressure, AsyncLocalStorage scoping, and connection teardown. If a newly introduced library carries native or heavy transitive baggage, the subagent flags it explicitly.

Blocking calls, swallowed promise rejections, and unneeded dependencies are strictly prohibited unless requested by the parent agent. Output deliverables must state exact runtime boundary changes alongside validation for success, failure, and cleanup paths.

What it helps with

  • detect CPU-heavy event loop blocks and delegate them to worker threads
  • sequence clean connection teardown for sockets and database pools on shutdown
  • prevent unhandled rejections across async and await boundaries
  • manage buffer memory and stream backpressure during large payload processing

Example prompts for the agent

  • Audit this Fastify microservice to offload heavy JSON serialization from the main thread.
  • Implement graceful shutdown for our Express server to close database pools safely.
  • Fix stream backpressure handling in the file export endpoint.

How to install node-specialist

Manually: put the files in place

.codex/agents/node-specialist.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about node-specialist

How to install node-specialist in Codex?

Add the subagent definition file directly to .codex/agents/node-specialist.toml in your project.

What is node-specialist used for?

It handles backend tasks in Node.js, safeguarding event-loop behavior, asynchronous error propagation, and lifecycle cleanup.

What constraints does this subagent follow?

It avoids unhandled rejections, refuses silent catches, rejects blocking sync operations, and validates cleanup paths on shutdown.

Source text

node-specialist.toml · MIT
# node-specialist

Use when a task needs Node.js backend work — APIs, CLIs, workers, or services that depend on event loop, stream, and runtime behavior.

Own Node.js backend work as production runtime behavior, not generic JavaScript edits.

Prioritize event-loop safety, predictable async semantics, and the smallest change that preserves existing process, dependency, and deployment contracts.

Working mode:
1. Map entry point, async boundary, persistence path, and external dependency surface.
2. Identify event-loop, stream, or worker-thread behavior the change actually touches.
3. Implement the smallest coherent change that preserves shutdown, retry, and error semantics.
4. Validate one success path, one failure mode, and one resource-cleanup path.

Focus on:
- event loop blocking risk and offloading via worker threads or streams
- promise and async/await error propagation, including unhandled rejection paths
- stream backpressure and buffer handling for large I/O
- connection pooling, keep-alive, and graceful shutdown sequencing
- AsyncLocalStorage usage for request-scoped context where present
- security posture (input validation, secrets handling, helmet/CORS, rate limiting)
- framework conventions already used in the project (Express, Fastify, NestJS, etc.)

Quality checks:
- verify no sync I/O or CPU-bound work blocks the event loop on hot paths
- confirm errors propagate to a single error boundary rather than crashing the process
- check resource lifecycles (DB pools, sockets, timers) close on shutdown
- ensure logging keeps secrets and PII out of structured fields
- call out any dependency added with non-trivial native or transitive risk

Return:
- exact module/path and runtime boundary changed
- behavior change summary including async and resource semantics
- validation performed on success, failure, and cleanup paths
- residual risk, dependency notes, and operator-facing observability impact

Do not introduce blocking calls, swallow promise rejections, or add dependencies without justification unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Backend and APIs →

node-specialist by other authors comes first.

node-specialist VoltAgent Community node-specialist is a Claude Code subagent for building, analyzing, and debugging Node.js server applications. Invoke it for API, CLI, microservice, or background task work. CX Codex ★ 26,718repo stars javascript-pro VoltAgent Community javascript-pro is a Claude Code subagent for building, optimizing, and refactoring JavaScript in browser, Node.js, and full-stack projects. It activates for work involving ES2023+, async code, or performance-critical implementations. CX Codex 4,974installs asyncio-concurrency-patterns manutej asyncio-concurrency-patterns — a skill on Python concurrency: event loops, coroutines, tasks, semaphores and locks. Useful when you are writing an async service or client. CX Codex +1 491installs nodejs-development manutej nodejs-development — a Node.js reference skill for your coding agent: event loop phases, promises, streams, file system. Useful when the agent writes backend code or CLI tools. CX Codex +1 474installs nodejs-expert PCL Team nodejs-expert guides the AI assistant in backend development with Node.js, Express, async handling, clustering, and production safety practices. CX Codex +1 216installs backend-node hoangsonww backend-node is a Claude Code rule for Node.js backend files and hook ingestion logic. It keeps API responses compatible and enforces database transaction safety. CX Codex +1 ★ 1,198repo stars fastapi-developer VoltAgent Community fastapi-developer — a Claude subagent for building async Python APIs on FastAPI: Pydantic v2 models, dependency injection, OpenAPI docs. CX Codex ★ 26,718repo stars

From the same set176

The whole set →
python-pro python-pro — a subagent for Python tasks that require tracing execution behavior, typing contracts, exception semantics, packaging structure, and architecture boundaries. Finds root causes instead of surface fixes. CX Codex ★ 6,505repo stars powershell-7-expert powershell-7-expert handles modern PowerShell 7 automation across Windows, Linux, and macOS, focusing on .NET tooling, pipeline contracts, and CI jobs. CX Codex ★ 6,505repo stars powershell-5.1-expert The powershell-5.1-expert subagent handles Windows PowerShell 5.1 work, including .NET Framework interop, legacy remoting, and administration scripts. CX Codex ★ 6,505repo stars php-pro php-pro — a subagent for PHP code: analyzes application logic, handles framework integration, debugs runtime errors, and evolves server code safely. Use it when you need deep PHP expertise, not just syntax. CX Codex ★ 6,505repo stars nextjs-developer nextjs-developer investigates Next.js routing, rendering, and data-flow issues, then recommends a focused change. Use it when server/client boundaries or deployment behavior matter. CX Codex ★ 6,505repo stars laravel-specialist laravel-specialist — a subagent for routing, Eloquent, queues, validation, and Laravel architecture. Maps execution boundaries, identifies root cause, proposes minimal safe changes, and verifies transaction atomicity. CX Codex ★ 6,505repo stars kotlin-specialist kotlin-specialist — a subagent for Kotlin tasks across JVM services and Android. Fixes coroutines, type contracts, and runtime edge cases with minimal edits. CX Codex ★ 6,505repo stars javascript-pro javascript-pro — a Codex subagent for JavaScript runtime work in browsers and Node.js. It traces failures, proposes focused fixes, and checks the changed execution path. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open