MongoDB Data Model and Migration

When to use

Invoke when designing a new MongoDB data model, introducing a service persistence layer on MongoDB, evolving an existing document shape, reviewing index strategy, choosing or revising a shard key, or planning a production data migration.

Do not use for relational schemas (use postgres-schema-and-migration), analytics warehouses, graph databases, ORM- or ODM-only modeling discussions, or Mongo-as-event-source (change streams) integration.

Inputs

Required:

• Domain entities, relationships, and ownership boundaries from system-design.md and (if available) backend-architecture.md.
• Primary access patterns: read shapes, write shapes, hot keys, and transactional groupings.
• Approved data-architecture.md decisions on consistency posture, sharding, and replica topology.

Optional: