# Java Scaffold

> Generates Quarkus project scaffolds with BCE architecture (Boundary-Control-Entity), Panache entities, RESTEasy Reactive endpoints, and LangChain4j AI services. Use this skill when creating new modules, entities, or REST endpoints in Quarkus projects.

- Skill: `mgoericke/java-scaffold` (Agent Skill, multi-file: 27 files)
- Install (CLI): `npx skillmds@latest add mgoericke/java-scaffold`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mgoericke/java-scaffold/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs, DevOps & Infra
- Author: mgoericke (https://skillmd.com/u/mgoericke)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mgoericke/java-scaffold

---


# Java Scaffold Skill

## Purpose
Generate runnable Quarkus project structures following the BCE pattern.

## Tech Stack
- **Quarkus** (current LTS), **Java 21** (Records, Pattern Matching, Sealed Classes)
- **RESTEasy Reactive** (not Classic)
- **Hibernate ORM with Panache** (Active Record or Repository)
- **Jackson** for JSON (`quarkus-rest-jackson`)
- **LangChain4j** via `quarkus-langchain4j-ollama` for AI services

## BCE Package Structure
```
src/main/java/de/example/module/
├── boundary/        # REST resources, WebSocket endpoints
├── control/         # Business services, AI services
├── entity/          # JPA entities, Records/DTOs, Value Objects
└── config/          # ConfigMappings, exception mappers
```

## Conventions
- Java Records for DTOs and API responses
- CDI (`@ApplicationScoped`, `@Inject`) instead of manual instantiation
- `@ConfigProperty` or `@ConfigMapping` for configuration
- `@ServerExceptionMapper` for error handling
- Logging via `@Inject Logger` or `Log.info()`

## Output
Generated code always includes:
1. All necessary imports
2. Matching `application.properties` configuration
3. Maven dependencies as a `<dependency>` block
4. Notes on required Dev Services or Ollama models