Skip to main content
skill CX Codex

516-frameworks-micronaut-mongodb-migrations-mongock skill

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.

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

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

What 516-frameworks-micronaut-mongodb-migrations-mongock does

The skill helps select a Mongock runner and driver, connect them through Micronaut beans, and configure migration scan packages. It covers @ChangeUnit work such as execution order, idempotent operations, rollback hooks, locks, and transaction limits. Integration checks can use @MicronautTest with Testcontainers MongoDB.

Before changing Mongock or MongoDB migrations, the skill requires ./mvnw compile or mvn compile; a compile failure means stop. After the changes, it calls for ./mvnw clean verify or mvn clean verify. That compile gate matters: if a Micronaut-compatible runner cannot be used, the skill directs the agent to use a standalone runner bean or job and document the trade-off. Its workflow also reads the reference files and inspects the project’s MongoDB configuration.

What it helps with

  • configure a Mongock runner and driver in a Micronaut app
  • create ordered @ChangeUnit migrations with rollback hooks
  • review migration idempotency and lock settings
  • test MongoDB migrations with Testcontainers
  • inspect migration ordering and startup execution

Example prompts for the agent

  • Add Mongock migrations to this Micronaut app, starting with a compile check.
  • Review these @ChangeUnit classes for ordering and idempotency, then test with Testcontainers MongoDB.
  • Wire the Mongock runner through Micronaut beans and explain whether a standalone runner job is needed.

How to install 516-frameworks-micronaut-mongodb-migrations-mongock

1Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 516-frameworks-micronaut-mongodb-migrations-mongock -a claude-code

2Manually: put the files in place

~/.claude/skills/516-frameworks-micronaut-mongodb-migrations-mongock/SKILL.md

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

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

Questions about 516-frameworks-micronaut-mongodb-migrations-mongock

How do I install 516-frameworks-micronaut-mongodb-migrations-mongock in Claude Code?

Run npx skills add jabrena/plinth --skill 516-frameworks-micronaut-mongodb-migrations-mongock -a claude-code. The skill file is at ~/.claude/skills/516-frameworks-micronaut-mongodb-migrations-mongock/SKILL.md.

What does 516-frameworks-micronaut-mongodb-migrations-mongock do?

It guides Mongock setup and MongoDB migration changes in Micronaut, including @ChangeUnit design and migration execution. It also covers integration checks using Testcontainers MongoDB.

What if compilation fails before a migration change?

Stop before making the change. The skill requires the project to compile first.

Source text

SKILL.md · Apache-2.0
---
name: 516-frameworks-micronaut-mongodb-migrations-mongock
description: Use when you need to add or review Mongock MongoDB data migrations in a Micronaut application — including Mongock runner/driver selection, Micronaut bean wiring, migration scan packages, @ChangeUnit classes, lock/transaction settings, and Testcontainers verification. This should trigger for requests such as Add Mongock migrations in Micronaut; Review Micronaut MongoDB data migrations; Configure Mongock change units with Micronaut Data MongoDB; Create Mongock change units for Micronaut MongoDB; Review Mongock migration ordering in a Micronaut service. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Micronaut - MongoDB migrations (Mongock)

Apply Mongock migration guidelines for Micronaut and Micronaut Data MongoDB.

**What is covered in this Skill?**

- Mongock runner/driver selection for Micronaut projects
- Micronaut bean wiring for MongoDB client access and controlled migration execution
- Code-first `@ChangeUnit` migrations with `@Execution` and rollback hooks
- Locking, idempotency, transaction limits, and startup/runtime trade-offs
- Integration tests with `@MicronautTest` and Testcontainers MongoDB
- Coordination with `@515-frameworks-micronaut-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
- **EDGE CASE**: If a Micronaut-specific Mongock runner is unavailable or incompatible, use an explicit standalone runner bean/job and document that trade-off

## When to use this skill

- Add Mongock migrations in Micronaut
- Review Micronaut MongoDB data migrations
- Configure Mongock change units with Micronaut Data MongoDB
- Create Mongock change units for Micronaut MongoDB
- Review Mongock migration ordering in a Micronaut service

## Workflow

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

Read `references/516-frameworks-micronaut-mongodb-migrations-mongock.md`, `references/516-frameworks-micronaut-mongodb-migrations-mongock-antipatterns.md`, and `references/516-frameworks-micronaut-mongodb-migrations-mongock-parallel-change.md`, then inspect `pom.xml`, Micronaut MongoDB configuration, and existing `@515-frameworks-micronaut-mongodb` persistence patterns.

2. **Choose runner, driver, and execution policy**

Select compatible Mongock coordinates, wire the runner through Micronaut beans, configure migration scan packages, and decide startup vs controlled-job 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 `@MicronautTest` with Testcontainers MongoDB where feasible, and summarize outcomes and follow-up risks.

## Reference

For detailed guidance, examples, and constraints, see:

- [references/516-frameworks-micronaut-mongodb-migrations-mongock.md](references/516-frameworks-micronaut-mongodb-migrations-mongock.md)
- [references/516-frameworks-micronaut-mongodb-migrations-mongock-antipatterns.md](references/516-frameworks-micronaut-mongodb-migrations-mongock-antipatterns.md)
- [references/516-frameworks-micronaut-mongodb-migrations-mongock-parallel-change.md](references/516-frameworks-micronaut-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 →
804-regulations-eu-nis2 804-regulations-eu-nis2 reviews Java applications for NIS2 cybersecurity risk-management controls in essential entities, critical-sector services, and managed providers. Works from sanitized evidence inventory only. CX Codex +1 215installs 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 416-frameworks-quarkus-mongodb-migrations-mongock 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. CX Codex +1 212installs 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

Project sponsors

Companies that keep this analytics open