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
.claude/agents/bullmq-expert.mdWhat 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/bullmq-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/bullmq-expert.mdCursor also reads .claude/agents/
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