# Junit5 Extensions

> Use when Codex needs to create, review, or debug JUnit 5 extensions, custom annotations, lifecycle callbacks, parameter resolvers, or reusable execution hooks.

- Skill: `jovd83/junit5-extensions` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add jovd83/junit5-extensions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jovd83/junit5-extensions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jovd83 (https://skillmd.com/u/jovd83)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jovd83/junit5-extensions

---


# JUnit 5 Extensions

## 1. Confirm That an Extension Is Warranted

1. Use helpers, builders, or local fixtures first.
2. Create an extension only when the behavior is cross-cutting and repeated.
3. Read [references/extension-patterns.md](references/extension-patterns.md) before adding a new extension.
4. Read [references/lifecycle-and-state.md](references/lifecycle-and-state.md) before storing state or coordinating multiple callbacks.

## 2. Implement Deliberately

1. Choose the smallest relevant callback or resolver interface.
2. Keep state explicit and scoped safely.
3. Keep extension behavior testable and unsurprising.
4. Prefer explicit registration when discoverability matters.
5. Keep meta-annotations small and intention-revealing.

## 3. Validate

1. Add focused tests for the extension itself.
2. Verify lifecycle ordering and failure behavior.
3. Avoid hidden global behavior that changes unrelated tests.
4. Read [references/extension-testing.md](references/extension-testing.md) when the extension has multiple callbacks or parameter rules.

## 4. Troubleshooting

1. Problem: The extension hides too much setup.
   Fix: Move local test setup back into the test class and keep only the true cross-cutting concern in the extension.
2. Problem: Parameter resolution is ambiguous.
   Fix: Narrow the supported parameter types or add clearer registration boundaries.
3. Problem: The extension works only when tests run in a certain order.
   Fix: Remove hidden shared state and verify callback scope explicitly.