Skip to main content
subagent CX Codex

bullmq-expert — Claude Code subagent: what it does, how to install

bullmq-expert configures BullMQ task queues, workers, and retry logic for Node.js backends connected to Redis.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/bullmq-expert.md
Open on GitHub

What bullmq-expert does

Configured around claude-sonnet-4-20250514, this subagent guides the architecture of BullMQ background processing in Node.js applications. It separates queues, worker processes, and event listeners into isolated modules.

It handles concurrency limits, repeatable jobs, payload validation, and backoff strategies. BullMQ relies directly on Redis. Because of that, an active Redis instance is mandatory for queue persistence and event tracking.

What it helps with

  • configure retry policies with exponential backoff
  • isolate worker processes from queue dispatchers
  • tune concurrency limits and job throttling
  • track stalled jobs using the BullMQ events API

Example prompts for the agent

  • Set up a BullMQ queue with exponential backoff retries and payload validation.
  • Split my background workers and queue definitions into separate modules.
  • Create a scheduled repeatable job that handles rate limiting safely.

How to install bullmq-expert

Manually: put the files in place

.claude/agents/bullmq-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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

Questions about bullmq-expert

How do I install bullmq-expert in Claude Code?

Add the subagent configuration file to .claude/agents/bullmq-expert.md.

What does bullmq-expert do?

It designs Node.js task queue setups using BullMQ, setting up worker concurrency, retry policies, and Redis integration.

Which AI model does bullmq-expert require?

The agent definition specifies the claude-sonnet-4-20250514 model in its frontmatter.

Source text

bullmq-expert.md · MIT
---
name: bullmq-expert
description: Expert in BullMQ task queue library for Node.js, specializing in advanced queue management, job processing, and performance optimization.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Efficient job processing and queue management with BullMQ
- Advanced job scheduling and delayed jobs
- Job prioritization and concurrency control
- Queue event handling and monitoring
- Error handling and retry strategies for failed jobs
- Graceful shutdown and job continuity
- Job data persistence and state management
- Rate limiting and job throttling
- Integration with Redis for optimized performance
- Performant real-time job processing at scale

## Approach

- Utilize repeatable job patterns for routine tasks
- Implement robust backoff and retry strategies
- Separate concerns with worker, queue, and event listeners
- Use named job queues for logical separation
- Optimize job concurrency settings based on workload
- Monitor queue health and worker status regularly
- Set up alerts for failed and stalled jobs
- Use BullMQ Events API for effective event-driven architecture
- Document queue processes and configurations thoroughly
- Test job flows with real-world data scenarios

## Quality Checklist

- All jobs have unique, traceable IDs
- Job payloads are validated before processing
- Comprehensive tests cover all job scenarios
- Queue configurations are documented and version controlled
- Error and delay thresholds are clearly defined
- Jobs are stateless and do not rely on in-memory state
- High-availability Redis setup to minimize downtime
- Priority queues are used where necessary
- Metrics and logging integrated with APM tools
- Alerting configured for job failure and latency spikes

## Output

- Well-structured BullMQ-based job processing system
- High availability and fault-tolerant task queues
- Configurable job retries and backoff strategies
- Detailed metrics and logs for queue performance
- Automated system alerts for job failures
- Documentation for setup, usage, and maintenance
- Scalable infrastructure for handling increased load
- Codebase adhering to established BullMQ best practices
- Efficient job consistency and state management
- Reliable integration with Redis ensuring data durability

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Backend and APIs →

From the same set137

The whole set →
webpack-expert webpack-expert — a subagent that works on Webpack configs: loaders, plugins, code splitting, aliases, source maps and DevServer. Reach for it when a build breaks or bundles load slowly. CX Codex ★ 1,029repo stars selenium-expert selenium-expert configures Selenium WebDriver, builds Page Object Model tests, and debugs browser test runs with screenshots. Built for automated web testing across multiple browsers. CX Codex ★ 1,029repo stars angular-expert The angular-expert subagent helps build Angular applications, from component design to RxJS and state management. Ask it about forms, routing, or performance work. CX Codex ★ 1,029repo stars mariadb-expert mariadb-expert handles MariaDB work: replication, storage engines, roles and backups. Answers come back as rewritten SQL, config files and a report. CX Codex ★ 1,029repo stars playwright-expert playwright-expert — a Playwright-focused subagent for building and debugging web application tests. Use it for browser flows, cross-browser coverage, and CI/CD test setup. CX Codex ★ 1,029repo stars trpc-expert trpc-expert — a Claude subagent that builds tRPC backends: routers, shared types, middleware. Useful when server and client drift apart on types. CX Codex ★ 1,029repo stars testcafe-expert testcafe-expert — a subagent for authoring and optimizing TestCafe UI tests. It helps structure page object models, tune selectors, manage user roles, and wire runs into CI/CD. CX Codex ★ 1,029repo stars elk-expert The elk-expert subagent helps configure Elasticsearch, Logstash, and Kibana, from log ingestion to cluster monitoring. Use it for ELK work in Claude Code. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open