К основному содержанию
плагин

piomin-spring-boot-template — плагин для Claude Code

Плагин piomin-spring-boot-template превращает Claude Code в среду разработки Spring Boot 4.x / Java 21+. Шесть агентов и восемь скиллов направляют Claude следовать best practices для REST API, JPA, безопасности, тестирования и Kubernetes.

Apache-2.0 ★ 1 467 обновлён 2026-10-21

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install piomin-spring-boot-template@claude-community
Открыть на GitHub

Что делает piomin-spring-boot-template

Плагин поставляется с шестью агентами: spring-boot-engineer для построения приложений с многоуровневой архитектурой, code-reviewer для проверки кода и конвенций, kubernetes-specialist для развёртывания на K8s, devops-engineer для CI/CD, docker-expert для оптимизации образов и security-engineer для Spring Security и OWASP.

Восемь скиллов кодифицируют правила проекта: без Lombok, только конструкторная инъекция, RestClient для синхронных запросов, Testcontainers с @ServiceConnection, Jakarta Persistence, Maven с группой pl.piomin.services. Плагин покрывает Spring Cloud, OpenTelemetry, виртуальные потоки Java 21, Kubernetes ConfigMap/Secret, cert-manager с mTLS, Paketo Buildpacks и Skaffold для локальной разработки.

После установки достаточно описать, что нужно построить — Claude выберет подходящих агентов и активирует релевантные скиллы автоматически. Можно также вызвать нужный скилл или агента явно через слэш-команду или упоминание.

Какие задачи решает

  • Генерировать REST API с PostgreSQL по Spring Boot best practices
  • Проверить код на соответствие конвенциям и Spring Security
  • Развернуть приложение на Kubernetes с OTLP, ConfigMap и graceful shutdown
  • Собрать multi-stage Dockerfile с Paketo Buildpacks
  • Написать интеграционные тесты с Testcontainers и MockMvc

Примеры запросов агенту

  • Построй REST API для управления заказами с PostgreSQL и JPA
  • /spring-boot-template:jpa-patterns — покажи, как избежать N+1 и проблем с lazy loading
  • @agent-spring-boot-template:kubernetes-specialist — помоги развернуть приложение на K8s с Prometheus и mTLS

Как установить piomin-spring-boot-template

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install piomin-spring-boot-template@claude-community

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о piomin-spring-boot-template

Как установить piomin-spring-boot-template в Claude Code?

Выполни /plugin marketplace add anthropics/claude-plugins-community, затем /plugin install piomin-spring-boot-template@claude-community. Или клонируй репозиторий и запусти Claude с флагом --plugin-dir /path/to/claude-ai-spring-boot.

Что делает piomin-spring-boot-template?

Плагин наделяет Claude Code знанием о Spring Boot 4.x, Java 21+, современных паттернах (JPA, тестирование, безопасность) и облачных технологиях (Kubernetes, OpenTelemetry, GraalVM). Шесть агентов решают конкретные задачи: от кода до развёртывания.

Какие конвенции кодирования плагин навязывает?

Скилл conventions требует: без Lombok, конструкторная инъекция, RestClient вместо RestTemplate, Testcontainers с @ServiceConnection, Jakarta Persistence, Maven с pl.piomin.services, Docker Compose для локальных зависимостей.

Исходный текст

SKILL.md · Apache-2.0
# Spring Boot Plugin for Claude Code (v1.0)

A Claude Code plugin with production-ready skills and agents for building Spring Boot 4.x / Java 21+ applications. Install the plugin and start generating your app — the skills and agents guide Claude to follow best practices for REST APIs, JPA, security, testing, cloud-native deployment, and Kubernetes.

## Installation

Install from Anthropic marketplace

```bash
claude plugin install spring-boot-template@piomin
```

Or install directly from repository

``` 
claude plugin marketplace add https://github.com/piomin/claude-ai-spring-boot.git
claude plugin install spring-boot-template@piomin
```

To test locally during development:

```bash
claude --plugin-dir /path/to/claude-ai-spring-boot
```

## What's Included

### Agents (`agents/`)

Specialized agents that Claude Code can invoke for specific tasks:

| Agent | Purpose |
|-------|---------|
| `spring-boot-engineer` | Build Spring Boot 4.x apps with layered architecture |
| `code-reviewer` | Review code for correctness, security, Spring Boot conventions |
| `kubernetes-specialist` | K8s deployments, probes, ConfigMap/Secret, Prometheus, Skaffold |
| `devops-engineer` | CI/CD pipelines, Paketo Buildpacks, Skaffold |
| `docker-expert` | Multi-stage Dockerfiles, Paketo Buildpacks, image optimization |
| `security-engineer` | Spring Security, OWASP, input validation, SSL Bundles |

### Skills (`skills/`)

Reusable knowledge that Claude loads contextually:

| Skill | What it teaches |
|-------|-----------------|
| `conventions` | Mandatory project rules: No Lombok, constructor injection, RestClient, testing standards |
| `spring-boot` | Core Spring Boot development with 5 reference guides (web, data, security, cloud, testing) |
| `code-quality` | Clean code principles, API contracts, null safety, exception handling |
| `design-patterns` | Classic patterns (Factory, Builder, Strategy) + enterprise (Saga, Outbox, CQRS) |
| `testing-patterns` | JUnit 5, Mockito, MockMvc, RestTestClient, Testcontainers with @ServiceConnection |
| `java-modern` | Java 21+ features: records, sealed classes, pattern matching, virtual threads |
| `jpa-patterns` | JPA/Hibernate pitfalls (N+1, lazy loading), Hibernate 6/7, optimistic locking |
| `logging-patterns` | Structured JSON logging, SLF4J, MDC, AI-friendly formats |

### Key Conventions

The plugin enforces these rules via the `conventions` skill:

- **No Lombok** — explicit constructors, getters/setters, `LoggerFactory.getLogger()`
- **Constructor injection** — no `@Autowired` on fields
- **RestClient** over RestTemplate/WebClient for blocking HTTP calls
- **RestTestClient** with `@AutoConfigureRestTestClient` for integration tests
- **Testcontainers** with `@ServiceConnection` (not `@DynamicPropertySource`)
- **Jakarta Persistence** (not `javax.persistence`)
- **Maven** with `pl.piomin.services` group ID
- **CI pipeline** — auto-detected from existing project config
- **Docker Compose** for local dependencies

### Cloud-Native Coverage

The `cloud.md` reference covers:

- Spring Cloud (Config Server, Eureka, Gateway, Resilience4j, LoadBalancer)
- Distributed tracing with OpenTelemetry (OTLP) and Micrometer Observation API
- Virtual Threads, HTTP Interface Clients (`@HttpExchange`), GraalVM Native Image
- Kubernetes: ConfigMap/Secret with `envFrom`, Prometheus annotations, startup/liveness/readiness probes, `preStop` hook, graceful shutdown
- TLS: cert-manager (Ingress TLS + pod-level mTLS), SSL Bundles with hot reload
- Config Tree for reading mounted secrets from files
- Paketo Buildpacks via `spring-boot:build-image`
- Skaffold for local K8s development loop

## Usage

After installing, describe what you want to build — Claude will use the skills and agents automatically:

```bash
cd my-project
claude
> "Build a REST API for managing orders with PostgreSQL"
```

You can also invoke skills and agents directly:

```bash
# Invoke a skill
> /spring-boot-template:jpa-patterns

# Use an agent
> @agent-spring-boot-template:code-reviewer
```

## Directory Structure

```
.
├── .claude-plugin/
│   └── plugin.json
├── agents/
│   ├── code-reviewer.md
│   ├── devops-engineer.md
│   ├── docker-expert.md
│   ├── kubernetes-specialist.md
│   ├── security-engineer.md
│   └── spring-boot-engineer.md
├── skills/
│   ├── conventions/SKILL.md
│   ├── code-quality/SKILL.md
│   ├── design-patterns/SKILL.md
│   ├── java-modern/SKILL.md
│   ├── jpa-patterns/SKILL.md
│   ├── logging-patterns/SKILL.md
│   ├── spring-boot/
│   │   ├── SKILL.md
│   │   └── references/
│   │       ├── cloud.md
│   │       ├── data.md
│   │       ├── security.md
│   │       ├── testing.md
│   │       └── web.md
│   └── testing-patterns/SKILL.md
├── README.md
└── LICENSE
```

## Blog Post

You can find a detailed explanation of this plugin in the post: [Claude Code Template for Spring Boot](https://piotrminkowski.com/2026/03/24/claude-code-template-for-spring-boot/).

## License

Apache License 2.0

© piomin · Apache-2.0 · piomin/claude-ai-spring-boot

Похожие плагины

Все плагины по теме «Бэкенд и API» →
spring-boot-engineer https://github.com/Jeffallan Скилл spring-boot-engineer разворачивает архитектуру Spring Boot 3.x, контроллеры, репозитории Spring Data JPA и правила Spring Security 6. Пригодится при сборке REST API, реактивных сервисов и микросервисов на Java. CX Codex +1 8 900установок spring-boot-patterns decebals Скилл spring-boot-patterns для Claude Code задаёт структуру и шаблоны Spring Boot-проекта: контроллеры, сервисы, репозитории. Направляет агента при написании нового кода и разборе чужого. CX Codex +1 375установок spring-boot-crud-patterns giuseppe-trisciuoglio Скилл spring-boot-crud-patterns собирает полный CRUD-слой для сервисов на Spring Boot 3: агрегаты, JPA-репозитории, DTO и REST-контроллеры по feature-архитектуре. CX Codex +1 4 100установок spring-boot-development manutej Скилл spring-boot-development для ИИ-агента, который подсказывает, как писать Spring Boot: авто-конфигурация, внедрение зависимостей, REST-контроллеры, Spring Data и Spring Security. CX Codex +1 537установок spring-boot-backend-development-expert Giuseppe Trisciuoglio Субагент spring-boot-backend-development-expert для Claude по бэкенду на Spring Boot: реализует фичи, раскладывает код по Clean Architecture и пишет тесты к тому, что сделал. CX Codex ★ 372звёзд репо java-spring-boot pluginagentmarketplace Скилл java-spring-boot помогает создавать бэкенд на Spring Boot 3: настраивать REST API, аутентификацию через Spring Security, доступ к базам через Spring Data и мониторинг Actuator. CX Codex +1 11 800установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой