mongoose-expert — Claude Code subagent: setup and use
mongoose-expert designs Mongoose schemas, sets up document validation, and tunes MongoDB queries. Helpful when building Node.js backend services.
MIT ★ 1,029 updated 2025-10-15
.claude/agents/mongoose-expert.mdWhat mongoose-expert does
This subagent focuses on Mongoose ODM patterns for MongoDB collections. It structures data models, sets up indexing strategies, configures connection pooling, and handles pre and post middleware hooks.
Query efficiency is a central priority. The agent applies .lean() on read operations, uses field projections to cut payload sizes, and manages references through populate or embedded subdocuments. Under the hood, its manifest targets the claude-sonnet-4-20250514 model.
Unindexed MongoDB queries cause latency spikes as data grows. The agent inspects query patterns early to prevent slow scans and memory bottlenecks.
What it helps with
- design Mongoose schemas with field validators and indexes
- optimize MongoDB reads using .lean() and projections
- configure middleware hooks for cascading document updates
- manage document relationships and subdocument embedding
Example prompts for the agent
- Optimize the User schema and add index definitions for search fields
- Write pre-remove middleware to handle cascading cleanup
- Refactor collection queries using .lean() to reduce memory overhead
How to install mongoose-expert
Manually: put the files in place
.claude/agents/mongoose-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/mongoose-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/mongoose-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 mongoose-expert
How to install mongoose-expert in Claude Code?
Place the agent configuration file into .claude/agents/mongoose-expert.md inside your workspace.
What does mongoose-expert do?
It designs Mongoose schemas, configures connection pools, sets up middleware hooks, and tunes MongoDB read and write operations.
Which model does mongoose-expert run on?
The agent configuration is set to use claude-sonnet-4-20250514.
Source text
mongoose-expert.md · MIT
--- name: mongoose-expert description: Mongoose ODM specialist for MongoDB, proficient in schema design, query optimization, and data validation. model: claude-sonnet-4-20250514 --- ## Focus Areas - Designing efficient Mongoose schemas for MongoDB collections - Configuring and utilizing Mongoose connections - Implementing document validation strategies - Applying Mongoose middleware (pre/post hooks) - Query optimization with Mongoose methods - Utilizing Mongoose's population feature for references - Proper index creation for performance enhancement - Handling Mongoose error messages and debugging - Managing document relationships and subdocuments - Monitoring and optimizing Mongoose performance ## Approach - Leverage schemas to enforce data structure and consistency - Optimize queries with projection and lean methods - Use middleware to encapsulate reusable logic - Implement cascading deletes using middleware hooks - Apply index options to ensure efficient data retrieval - Use validators for robust data integrity checks - Utilize `.lean()` for read operation to increase performance - Employ embedded documents to model hierarchical structures - Address connection pooling to maximize efficiency - Regularly update Mongoose to leverage latest features/fixes ## Quality Checklist - Schemas are well-defined with proper field types - Middleware is efficiently used to enforce logic - Validators comprehensively check input data - Indexes cover all necessary query patterns - Queries are optimized with appropriate projections - Relationships are clearly modeled and managed - Connection errors are handled and logged - Mongoose populate is used judiciously - Read operations are performance-optimized - Data integrity is rigorously maintained across operations ## Output - Schemas with complete validation and indexing - Efficient and reusable query methods - Documentation on schema and middleware design - Performance reports with Mongoose-specific optimizations - Robust error handling and logging strategy - Tested relationships among MongoDB documents - Middleware hooks for automated data operations - Regularly reviewed and optimized Mongoose setup - Detailed setup instructions for Mongoose connection - Sample data interactions demonstrating Mongoose capabilities
© 0xfurai · MIT · 0xfurai/claude-code-subagents