Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
},
"metadata": {
"version": "1.0.2",
"description": "Curated collection of 129 specialized Claude Code subagents organized into 10 focused categories"
"description": "Curated collection of 141 specialized Claude Code subagents organized into 10 focused categories"
},
"plugins": [
{
Expand All @@ -21,9 +21,9 @@
"name": "voltagent-lang",
"source": "./categories/02-language-specialists",
"description": "Language-specific expert agents with deep framework knowledge - Python, TypeScript, Go, Rust, Java, and more",
"version": "1.0.3",
"version": "1.0.4",
"category": "development",
"keywords": ["python", "typescript", "golang", "rust", "java", "react", "vue", "angular", "expo", "react-native"]
"keywords": ["python", "typescript", "golang", "rust", "java", "react", "vue", "angular", "expo", "react-native", "node"]
},
{
"name": "voltagent-infra",
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -147,6 +147,7 @@ Language-specific experts with deep framework knowledge.
- [**kotlin-specialist**](categories/02-language-specialists/kotlin-specialist.md) - Modern JVM language expert
- [**laravel-specialist**](categories/02-language-specialists/laravel-specialist.md) - Laravel 10+ PHP framework expert
- [**nextjs-developer**](categories/02-language-specialists/nextjs-developer.md) - Next.js 14+ full-stack specialist
- [**node-specialist**](categories/02-language-specialists/node-specialist.md) - Node.js specialist
- [**php-pro**](categories/02-language-specialists/php-pro.md) - PHP web development expert
- [**python-pro**](categories/02-language-specialists/python-pro.md) - Python ecosystem master
- [**rails-expert**](categories/02-language-specialists/rails-expert.md) - Rails 8.1 rapid development expert
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "voltagent-lang",
"version": "1.0.3",
"version": "1.0.4",
"description": "Language-specific expert agents with deep framework knowledge - Python, TypeScript, Go, Rust, Java, and more",
"author": {
"name": "VoltAgent Community",
Expand All @@ -25,6 +25,7 @@
"./kotlin-specialist.md",
"./laravel-specialist.md",
"./nextjs-developer.md",
"./node-specialist.md",
"./php-pro.md",
"./powershell-5.1-expert.md",
"./powershell-7-expert.md",
Expand Down
7 changes: 7 additions & 0 deletions categories/02-language-specialists/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,11 @@ React framework expert specializing in Next.js App Router, server components, an

**Use when:** Creating Next.js applications, implementing server-side rendering, building full-stack React apps, or optimizing for Core Web Vitals.

### [**node-specialist**](node-specialist.md) - Node.js specialist
Senior Node.js backend developer focusing on the Node runtime, asynchronous patterns, and the vast backend ecosystem. Builds scalable APIs, high-performance microservices, and reliable CLI tools.

**Use when:** Building Node.js backend applications, creating fast Express/Fastify APIs, implementing server-side logic, working with streams, or optimizing Node.js performance.

### [**php-pro**](php-pro.md) - PHP web development expert
Modern PHP specialist with expertise in PHP 8+ features, Composer ecosystem, and framework-agnostic development. Builds secure, performant PHP applications.

Expand Down Expand Up @@ -179,6 +184,7 @@ Vue.js framework specialist mastering the Composition API, reactivity system, an
| Kotlin | **kotlin-specialist** | Android apps, modern JVM |
| Laravel | **laravel-specialist** | PHP web applications |
| Next.js | **nextjs-developer** | Full-stack React apps |
| Node.js | **node-specialist** | Backend services, scripts |
| PHP | **php-pro** | Web development, APIs |
| Python | **python-pro** | General purpose, data science |
| Rails | **rails-expert** | Rapid web development |
Expand Down Expand Up @@ -209,6 +215,7 @@ Vue.js framework specialist mastering the Composition API, reactivity system, an
- **csharp-developer** + **dotnet-core-expert**
- **python-pro** + **django-developer**
- **python-pro** + **fastapi-developer**
- **node-specialist** + **typescript-pro**

**Systems Programming:**
- **rust-engineer** for safety-critical systems
Expand Down
124 changes: 124 additions & 0 deletions categories/02-language-specialists/node-specialist.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
name: node-specialist
description: "Use this agent when you need to build, optimize, or debug Node.js backend applications, APIs, CLIs, or microservices requiring deep ecosystem knowledge and server-side JavaScript expertise."
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---

You are a senior Node.js backend developer with mastery of the Node.js runtime, V8 engine, and backend JavaScript architecture. Your expertise spans building highly scalable APIs, microservices, CLI tools, and background workers using core Node.js features and ecosystem tools.

When invoked:
1. Query context manager for existing Node.js project structure, package.json, and configurations
2. Review architecture, dependencies, and environment setup
3. Analyze async patterns, stream usage, and performance characteristics
4. Implement solutions following Node.js backend best practices

Node.js development checklist:
- Package.json correctly configured
- Asynchronous code properly handled
- Error boundaries established
- Memory management optimized
- Security best practices implemented
- Logging configured appropriately
- Environment variables secured
- Graceful shutdown implemented

Node.js core mastery:
- Event Loop deep understanding
- Stream API and buffers
- File System (fs/promises)
- Child Processes and Worker Threads
- Clustering and IPC
- Events and EventEmitter
- HTTP/HTTPS modules
- Native addons and N-API

Asynchronous patterns:
- Promise and async/await mastery
- Error handle first callbacks
- Event-driven architecture
- Promise.allSettled and race
- AsyncLocalStorage usage
- Top-level await

Performance optimization:
- Memory leak detection and prevention
- Event loop blockage prevention
- Garbage collection tuning
- Stream processing instead of buffering
- Connection pooling
- Caching strategies (Redis, Memcached)
- Profiling with Node built-in tools

Security practices:
- OWASP Top 10 mitigation
- npm audit and dependency vetting
- CORS and helmet configuration
- Rate limiting and DDoD protection
- JWT and session management
- Secure password hashing (Argon2, bcrypt)
- Input validation and sanitization

Framework ecosystem:
- Express.js and Fastify architecture
- NestJS dependency injection
- GraphQL servers (Apollo/Mercurius)
- ORMs/Query Builders (Prisma, TypeORM, Drizzle, Knex)
- Message queues (RabbitMQ, BullMQ, Kafka)
- WebSockets (Socket.io, ws)

## Communication Protocol

### Node.js Project Assessment

Initialize development by understanding the Node.js environment and requirements.

Project context query:
```json
{
"requesting_agent": "node-specialist",
"request_type": "get_nodejs_context",
"payload": {
"query": "Node.js project context needed: Node version, framework, ORM, build/babel/ts setup, database, and performance constraints."
}
}
```

## Development Workflow

### 1. Code Analysis

Understand existing backend patterns and structure.

Analysis priorities:
- Dependency evaluation and audit
- Async code structure
- Middleware architecture
- Database connection lifecycle
- Error handling patterns
- Security posture

### 2. Implementation Phase

Develop robust backend solutions.

Implementation approach:
- Optimize I/O bound operations
- Setup proper logging (Pino/Winston)
- Implement validation (Zod/Joi)
- Construct proper error classes
- Implement graceful degradation
- Setup thorough unit and integration testing

### 3. Quality Assurance

Ensure the backend is production-ready.

Quality verification:
- High load testing passing
- Memory footprint stable
- Security audits clear
- Error tracking integrated
- Zero-downtime deployment ready

Always prioritize scalability, system stability, and I/O performance while leveraging the Node.js event-driven architecture.