Skip to main content
skill CX Codex

416-frameworks-quarkus-mongodb-migrations-mongock — Quarkus skill

416-frameworks-quarkus-mongodb-migrations-mongock — a skill for setting up and verifying MongoDB migrations in Quarkus via Mongock. Adds @ChangeUnit classes, configures the quarkus-mongock extension, and validates migration order.

Apache-2.0 212 installs ★ 465 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code
Open on GitHub

What 416-frameworks-quarkus-mongodb-migrations-mongock does

The skill covers the full Mongock workflow in Quarkus: connecting the Quarkiverse quarkus-mongock extension, configuring quarkus.mongock.*, writing idempotent @ChangeUnit migrations with @Execution hooks and rollback logic. It includes rules for locks, transactions, and constraints on the default MongoDB client.

Before any change, the skill compiles via ./mvnw compile or mvn compile, then runs ./mvnw clean verify or mvn clean verify after applying changes. If compilation fails, the skill stops. Before adding the extension, it verifies the latest Quarkiverse Mongock release against the active Quarkus platform and MongoDB client version.

The skill also handles coordination with @415-frameworks-quarkus-mongodb and edge cases such as multiple MongoDB clients in the application.

What it helps with

  • add Mongock migrations to a Quarkus application
  • configure quarkus-mongock and automatic migration execution at startup
  • create and order @ChangeUnit classes with rollback support
  • verify idempotency and lock safety in migrations
  • test migrations using Quarkus tests with Dev Services

Example prompts for the agent

  • Add a Mongock migration to alter the users collection schema in Quarkus
  • Create a @ChangeUnit to fix data in the orders collection with rollback logic
  • Verify migration order and quarkus-mongock compatibility with the current Quarkus platform

How to install 416-frameworks-quarkus-mongodb-migrations-mongock

1Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code

2Manually: put the files in place

~/.claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 416-frameworks-quarkus-mongodb-migrations-mongock

How do I install 416-frameworks-quarkus-mongodb-migrations-mongock in Claude Code?

Run npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code, then open ~/.claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.md.

What does this skill do?

The skill adds and reviews MongoDB migrations via Mongock in Quarkus, configures the extension, writes @ChangeUnit classes, checks compatibility, and verifies via tests.

What validation does the skill perform before making changes?

The skill requires compilation before any change, verifies Quarkiverse Mongock compatibility with the active Quarkus version, and detects conflicts with multiple MongoDB clients.

Source text

SKILL.md · Apache-2.0
---
name: 416-frameworks-quarkus-mongodb-migrations-mongock
description: Use when you need to add or review Mongock MongoDB data migrations in a Quarkus application — including the Quarkiverse Mongock extension, Quarkus MongoDB client configuration, migrate-at-start, @ChangeUnit classes, lock/transaction settings, and Quarkus test verification. This should trigger for requests such as Add Mongock migrations in Quarkus; Configure quarkus-mongock; Review Quarkus MongoDB data migrations; Create Mongock change units for Quarkus MongoDB; Review Mongock migration ordering in a Quarkus service. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Quarkus - MongoDB migrations (Mongock)

Apply Mongock migration guidelines for Quarkus and Quarkus MongoDB client/Panache Mongo.

**What is covered in this Skill?**

- Quarkiverse `quarkus-mongock` extension and Quarkus MongoDB client setup
- `quarkus.mongock.*` configuration, including `migrate-at-start`
- Code-first `@ChangeUnit` migrations with `@Execution` and rollback hooks
- Locking, idempotency, transaction limits, and default-client constraints
- Quarkus tests with Dev Services or Testcontainers MongoDB
- Coordination with `@415-frameworks-quarkus-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 compile` or `mvn compile` before applying any change
- **SAFETY**: If compilation fails, stop immediately
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements
- **BEFORE APPLYING**: Read the reference for detailed rules and good/bad patterns
- **EXTENSION COMPATIBILITY**: Before adding `quarkus-mongock`, verify the latest Quarkiverse Mongock release and Quarkus extension catalog compatibility with the active Quarkus platform. If the latest extension targets a significantly older Quarkus version, stop and document the incompatibility instead of applying changes.
- **EDGE CASE**: If the application uses multiple MongoDB clients, verify Quarkiverse Mongock support before applying a default-client migration design

## When to use this skill

- Add Mongock migrations in Quarkus
- Configure quarkus-mongock
- Review Quarkus MongoDB data migrations
- Create Mongock change units for Quarkus MongoDB
- Review Mongock migration ordering in a Quarkus service

## Workflow

1. **Read references and inspect MongoDB setup**

Read `references/416-frameworks-quarkus-mongodb-migrations-mongock.md`, `references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md`, and `references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md`, then inspect `pom.xml`, Quarkus MongoDB configuration, and existing `@415-frameworks-quarkus-mongodb` persistence patterns.

2. **Verify extension compatibility and execution policy**

Verify the Quarkiverse `quarkus-mongock` release and Quarkus extension catalog compatibility before configuring MongoDB connection settings, migration scan behavior, and startup vs explicit `MongockFactory` execution.

3. **Apply framework-aligned migrations**

Implement/refactor `@ChangeUnit` classes with idempotent operations, explicit ordering, rollback hooks, and safe lock/transaction settings.

4. **Run verification and report results**

Execute build/tests, including Quarkus tests with Dev Services or Testcontainers MongoDB where feasible, and summarize outcomes and follow-up risks.

## Reference

For detailed guidance, examples, and constraints, see:

- [references/416-frameworks-quarkus-mongodb-migrations-mongock.md](references/416-frameworks-quarkus-mongodb-migrations-mongock.md)
- [references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md](references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md)
- [references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md](references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md)

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Similar skills

All skills for Backend and APIs →

From the same set123

The whole set →
808-regulations-eu-digital-markets-act 808-regulations-eu-digital-markets-act guides engineering reviews of Java systems subject to EU Digital Markets Act gatekeeper rules. CX Codex +1 213installs 802-regulations-dora 802-regulations-dora is a Claude Code skill that checks Java systems for DORA operational resilience readiness, including incidents, backups, continuity, and third-party ICT risk. CX Codex +1 213installs 803-regulations-gdpr 803-regulations-gdpr inspects Java enterprise backends for GDPR technical requirements and guides engineers on privacy controls prior to production. CX Codex +1 213installs 516-frameworks-micronaut-mongodb-migrations-mongock 516-frameworks-micronaut-mongodb-migrations-mongock is a Claude Code skill for setting up and checking Mongock MongoDB migrations in Micronaut. It covers runners, change units, and integration tests. CX Codex +1 213installs 801-regulations-eu-ai-act 801-regulations-eu-ai-act helps Java teams apply EU AI Act engineering controls to enterprise applications using LLMs, RAG, and AI agents before production deployment. CX Codex +1 212installs 805-regulations-eu-cyber-resilience-act The 805-regulations-eu-cyber-resilience-act skill reviews Java products and related components for engineering work tied to the EU Cyber Resilience Act. Use it when assessing a change or preparing a release. CX Codex +1 212installs 806-regulations-eu-data-act 806-regulations-eu-data-act is a Claude Code skill that checks Java services, APIs, and pipelines for EU Data Act controls before a data-sharing feature ships. CX Codex +1 212installs 500-frameworks-micronaut-create-project The 500-frameworks-micronaut-create-project skill scaffolds a Micronaut 4.x Maven project with SDKMAN-managed tools and checks the generated build. Use it when starting a Micronaut service. CX Codex +1 211installs

Project sponsors

Companies that keep this analytics open