spring-boot-4-conventions

spring-boot-4-conventions is a skill for Claude Code from loiane/specs-driven-development-spring-angular. It costs 50 tokens per session (3,332 once invoked), scanned A, original, MIT.

A set of recommended coding and project-structure conventions for Spring Boot 4 and Spring Framework 7 applications. Spring Boot is a Java framework for building web services and other applications.

In plain words
What is it for?
Use it when writing or reviewing controllers, services, configuration, HTTP clients, asynchronous code, or code using virtual threads in a Spring application.
Why use it?
It removes uncertainty about where code belongs and which modern Spring patterns to use. Consistent rules make features easier to find, review, and change.

Skill for Claude Code

Written for Claude Code: when-to-use in frontmatter.

Good fit Use it when writing or reviewing controllers, services, configuration, HTTP clients, asynchronous code, or code using virtual threads in a Spring application.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/loiane/specs-driven-development-spring-angular/spring-boot-4-conventions
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add loiane/specs-driven-development-spring-angular --skill spring-boot-4-conventions
Clone the repo
git clone --depth 1 https://github.com/loiane/specs-driven-development-spring-angular

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for spring-boot-4-conventions

README.md
[![agentmods](https://agentmods.dev/badge/skills/loiane/specs-driven-development-spring-angular/spring-boot-4-conventions/github.svg)](https://agentmods.dev/skills/loiane/specs-driven-development-spring-angular/spring-boot-4-conventions)
Your own site
<a href="https://agentmods.dev/skills/loiane/specs-driven-development-spring-angular/spring-boot-4-conventions"><img src="https://agentmods.dev/badge/skills/loiane/specs-driven-development-spring-angular/spring-boot-4-conventions/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for spring-boot-4-conventions

Your own site · 80×15
<a href="https://agentmods.dev/skills/loiane/specs-driven-development-spring-angular/spring-boot-4-conventions"><img src="https://agentmods.dev/badge/skills/loiane/specs-driven-development-spring-angular/spring-boot-4-conventions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 50 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,332 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00050 $0.03332
Opus 5.5 $0.00020 $0.01333
Sonnet 5.5 $0.00010 $0.00666
Haiku 4.5 $0.00005 $0.00333

Measured 1mo ago against content hash 2c1db1b4bec3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

spring-boot-4-conventions scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/spring-boot-4-conventions/SKILL.md · 243 lines

How it starts

The opening of the file, as written. The whole thing — 243 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Spring Framework 7 / Spring Boot 4 conventions

Java 25 + Spring Framework 7 + Spring Boot 4. Prefer the most modern idiom unless an ADR explains otherwise.

Defaults to apply

Package layout — by feature, not by layer

Top-level packages are bounded contexts / features, not technical layers. Inside a feature, split by visibility (api published, private impl hidden). For the private impl sub-packages, apply the following rule:

  • One class of a given type (single entity, single service, etc.) — keep it directly in the feature package (no sub-package).
  • Multiple classes of the same type — use a typed sub-package within the feature:
    • model/ — JPA entities
    • repository/ — Spring Data repositories
    • service/ — service classes / implementations
    • service/ — service implementations
  • Inside api/ — keep the controller (or service interface) at the api/ level; put all request/response DTO records in an api/dto/ sub-package.

All classes in the feature's private sub-packages (model, repository, service, internal) must be public (cross-package visibility is required when code spans multiple sub-packages). Cross-feature access is still forbidden and enforced by ArchUnit — public here means "visible within this feature", not "part of the published API".

The api/ sub-package is the only published surface. Other features depend only on <feature>.api.

com.example.checkout
├── giftcard/                    # feature/domain — one package per bounded context
│   ├── api/                     # published surface: controller, service interfaces, events
│   │   ├── GiftCardController.java
│   │   ├── GiftCardRedemptionService.java
│   │   ├── GiftCardRedeemed.java
│   │   ├── dto/                 # request/response DTOs always in api/dto/
│   │   │   ├── RedeemCommand.java
│   │   │   └── GiftCardRedemptionResponse.java
│   │   └── exception/           # domain exceptions thrown by this feature's services
│   │       └── InsufficientBalanceException.java
│   ├── model/                   # entities (multiple → typed sub-package)
│   │   ├── GiftCardEntity.java
│   │   └── GiftCardTransactionEntity.java
│   ├── repository/              # repositories (multiple → typed sub-package)
│   │   ├── GiftCardRepository.java
│   │   └── GiftCardTransactionRepository.java
│   └── service/                 # service implementations (multiple → typed sub-package)
│       └── GiftCardRedemptionServiceImpl.java
├── order/                       # another feature
│   ├── api/
│   │   └── dto/                 # DTOs always in api/dto/
│   │       └── OrderSummaryResponse.java
│   └── service/                 # single service impl — sub-package still used for consistency
│       └── OrderService.java
└── shared/                      # cross-cutting: error envelope, security config, time
    └── exception/               # GlobalExceptionHandler (@RestControllerAdvice)

Read the full file on GitHub · 243 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 243 lines · 50 tokens per session scan A 2c1db1b4bec3

Subscribe to this mod's changes

spring-boot-4-conventions is a skill published in the GitHub repository loiane/specs-driven-development-spring-angular (62 stars, last pushed 6d ago), licensed MIT. It adds 50 tokens to every session and 3,332 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

123-java-design-patterns

Use when you need to select, review, or implement Java design and integration patterns — including classic Java design patterns, REST API patterns, Kafka and event-driven patterns, database and persistence patterns, and cross-cutting integration patterns. This should trigger for requests such as Apply Java design…

jabrena/plinth · 89 tokens

125-java-concurrency

Use when you need to apply Java concurrency best practices — including thread safety fundamentals, ExecutorService thread pool management, concurrent design patterns like Producer-Consumer, asynchronous programming with CompletableFuture, immutability and safe publication, deadlock avoidance, virtual threads…

jabrena/plinth · 133 tokens

301-frameworks-spring-boot-core

Use when you need to review, improve, or build Spring Boot 4.0.x applications — including proper usage of @SpringBootApplication, component annotations (@Controller, @Service, @Repository), bean definition and scoping, configuration classes and @ConfigurationProperties (with @Validated), component scanning…

jabrena/plinth · 165 tokens

302-frameworks-spring-boot-rest

Use when you need to design, review, or improve REST APIs with Spring Boot — including HTTP methods, resource URIs, status codes, DTOs, versioning, deprecation and sunset headers, content negotiation (JSON and vendor media types), ISO-8601 instants in DTOs, pagination/sorting/filtering, Bean Validation at the…

jabrena/plinth · 177 tokens

300-frameworks-spring-boot-create-project

Use when you need to create a new Maven-based Spring Boot 4.0.x project using SDKMAN-managed Java and Spring Boot CLI tooling. This should trigger for requests such as Create a Spring Boot Maven project; Bootstrap Spring Boot project with SDKMAN; Generate a new Spring Boot service; Create Spring Boot 4 Maven project…

jabrena/plinth · 90 tokens

303-frameworks-spring-boot-validation

Use when you need to design, review, or improve validation in Spring Boot applications — including Bean Validation on request DTOs, @Valid/@Validated at API boundaries, constraint groups, custom constraints, @ConfigurationProperties validation, nested DTO validation, and consistent validation error handling. This…

jabrena/plinth · 113 tokens