316-frameworks-spring-mongodb-migrations-mongock
Manage MongoDB schema migrations in Spring Boot using Mongock, including @ChangeUnit creation and verification.
Install
mkdir -p .claude/skills/316-frameworks-spring-mongodb-migrations-mongock && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11672" && unzip -o skill.zip -d .claude/skills/316-frameworks-spring-mongodb-migrations-mongock && rm skill.zipInstalls to .claude/skills/316-frameworks-spring-mongodb-migrations-mongock
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use when you need to add or review Mongock MongoDB data migrations in a Spring Boot application — including Maven coordinates, Spring Data MongoDB drivers, migration scan packages, @ChangeUnit classes, lock/transaction settings, and Testcontainers verification. This should trigger for requests such as Add Mongock migrations in Spring Boot; Review Spring MongoDB data migrations; Configure Mongock change units for Spring Data MongoDB. Part of cursor-rules-java projectKey capabilities
- →Add Mongock migrations to Spring Boot applications
- →Review existing Spring MongoDB data migrations
- →Configure Mongock change units for Spring Data MongoDB
- →Implement code-first @ChangeUnit migrations with rollback hooks
- →Verify migrations using MongoDB-backed integration tests
How it works
This skill applies Mongock migration guidelines to Spring Boot and Spring Data MongoDB projects, covering dependency setup, change unit implementation, and verification. It ensures migrations are idempotent and transactionally safe.
Inputs & outputs
When to use 316-frameworks-spring-mongodb-migrations-mongock
- →Add Mongock migrations to Spring Boot
- →Review Spring MongoDB data migrations
- →Configure Mongock change units
- →Validate migration ordering
About this skill
Spring - MongoDB migrations (Mongock)
Apply Mongock migration guidelines for Spring Boot and Spring Data MongoDB.
What is covered in this Skill?
- Mongock BOM, Spring Boot runner, and Spring Data MongoDB driver coordinates
mongock.migration-scan-packageconfiguration and startup execution- Code-first
@ChangeUnitmigrations with@Executionand rollback hooks - Locking, idempotency, transaction limits, and forward-only rollout discipline
- Optional MongoDB-backed integration tests using only project-approved, pinned, or already-available container images when the user permits external runtime dependencies
- Coordination with
@315-frameworks-spring-mongodb
Scope: Apply recommendations based on the reference rules and good/bad examples.
Constraints
Compile before Mongock or MongoDB migration changes; verify after changes.
- MANDATORY: Run
./mvnw compileormvn compilebefore applying any change - SAFETY: If compilation fails, stop immediately
- VERIFY: Run
./mvnw clean verifyormvn clean verifyafter applying improvements - BEFORE APPLYING: Read the reference for detailed rules and good/bad patterns
- EDGE CASE: If the project Spring Data MongoDB version is not compatible with the selected Mongock driver, stop and ask whether to pin/upgrade Mongock or use a lower driver generation
- EXTERNAL RUNTIME GATE: Do not pull or execute Docker images for MongoDB verification unless the user explicitly approves and the image is pinned, policy-approved, or already present in the project configuration
When to use this skill
- Add Mongock migrations in Spring Boot
- Review Spring MongoDB data migrations
- Configure Mongock change units for Spring Data MongoDB
- Create Mongock change units for Spring Boot MongoDB
- Review Mongock migration ordering in a Spring service
Workflow
- Read references and inspect MongoDB setup
Read references/316-frameworks-spring-mongodb-migrations-mongock.md, references/316-frameworks-spring-mongodb-migrations-mongock-antipatterns.md, and references/316-frameworks-spring-mongodb-migrations-mongock-parallel-change.md, then inspect pom.xml, Spring Boot version, dependency management, MongoDB configuration, existing full-context tests, and existing @315-frameworks-spring-mongodb persistence patterns.
- Choose runner, driver, and execution policy
Select Mongock coordinates compatible with the active Spring Data MongoDB generation, configure migration scan packages, and decide startup vs controlled-job execution.
- Apply framework-aligned migrations
Implement/refactor @ChangeUnit classes with idempotent operations, explicit ordering, rollback hooks, and safe lock/transaction settings.
- Run verification and report results
Execute build/tests. Run MongoDB-backed migration checks only when the project already defines an approved MongoDB test runtime or the user explicitly approves a pinned container image. If generic @SpringBootTest smoke tests do not provide MongoDB, disable Mongock only for those tests with mongock.enabled=false. Summarize outcomes and follow-up risks.
Reference
For detailed guidance, examples, and constraints, see:
When not to use it
- →When the project's Spring Data MongoDB version is incompatible with the selected Mongock driver
- →When the user does not approve pulling or executing Docker images for MongoDB verification
Limitations
- →Requires successful compilation before applying changes
- →MongoDB-backed integration tests require user approval for external runtime dependencies
- →Incompatible Spring Data MongoDB and Mongock versions require user decision
How it compares
This skill provides a structured workflow and specific guidelines for Mongock migrations in Spring, ensuring compatibility and best practices, unlike ad-hoc manual migration development.
Compared to similar skills
316-frameworks-spring-mongodb-migrations-mongock side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| 316-frameworks-spring-mongodb-migrations-mongock (this skill) | 0 | 2mo | No flags | Intermediate |
| jpa-patterns | 3 | 5mo | No flags | Intermediate |
| database-migration | 3 | 2mo | No flags | Advanced |
| create-migration | 1 | 4mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by jabrena
View all by jabrena →You might also like
jpa-patterns
affaan-m
JPA/Hibernate patterns for entity design, relationships, query optimization, transactions, auditing, indexing, pagination, and pooling in Spring Boot.
database-migration
wshobson
Execute database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback procedures. Use when migrating databases, changing schemas, performing data transformations, or implementing zero-downtime deployment strategies.
create-migration
owid
Create a new database migration file for the OWID MySQL database. Use when the user needs to create a database schema change or migration.
alwib-backend
Tsuev
Develop and maintain the Alwib NestJS backend in `backend/`. Use when implementing or refactoring modules, controllers, services, DTO validation, Swagger docs, authentication/authorization flows, Prisma schema and migrations, and backend lint/test flows.
prisma-v7
develsvai
`web/`의 Prisma 7 설정과 generated client import 규칙을 맞추기 위한 스킬이다. 스키마 변경, migration, import 패턴 정리, Prisma 타입 사용 시 적용한다.
nestjs-database
li-lance
Implement data access patterns, Scaling, Migrations, and ORM selection in NestJS. Use when implementing TypeORM/Prisma repositories, migrations, or database patterns in NestJS. (triggers: **/*.entity.ts, prisma/schema.prisma, TypeOrmModule, PrismaService, MongooseModule, Repository)