AI RULEBOOKSpring Boot 3 & Java 21 GitHub Copilot Instructions
Production-grade architectural rulebook for Spring Boot 3 & Java 21. Engineered to eliminate LLM hallucinations, enforce strict deterministic conventions, and prevent architectural drift across Cursor IDE, Claude Code CLI, and autonomous multi-agent pipelines.
.github/copilot-instructions.mdFailure Patterns Prevented for Spring Boot 3 & Java 21
Spring Boot 3 requires Java 17+ (ideally Java 21) and migrates all packages from javax.* to jakarta.*. AI models trained on legacy Java code constantly hallucinate deprecated javax.persistence imports, bulky Lombok boilerplate instead of Java Records, and legacy WebSecurityConfigurerAdapter classes.
- Invokes deprecated or removed APIs from older model training weights
- Generates conflicting configuration files and invalid imports
- Silently drops type-safety, boundaries, or transaction isolation
Code Standards: Anti-Pattern vs Verified Implementation
// Discouraged: Legacy javax namespace, verbose POJO with setters, mutable entity exposure
import javax.persistence.*; // Obsolete in Spring Boot 3!
public class BadOrderDTO {
private String customerId;
public void setCustomerId(String id) { this.customerId = id; }
}package com.example.demo.order;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Positive;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.math.BigDecimal;
public record CreateOrderRequest(
@NotBlank String customerId,
@Positive BigDecimal amount
) {}
public record OrderResponse(Long id, String customerId, BigDecimal amount) {}
@RestController
@RequestMapping("/api/v1/orders")
public class OrderController {
private final OrderService orderService;
public OrderController(OrderService orderService) {
this.orderService = orderService;
}
@PostMapping
public ResponseEntity<OrderResponse> create(@RequestBody CreateOrderRequest request) {
OrderResponse response = orderService.processOrder(request);
return ResponseEntity.ok(response);
}
}How to Install Spring Boot 3 & Java 21 GitHub Copilot Instructions via Terminal
Step 1: Open Project Directory & Verify Target Placement
Open your terminal and navigate to your project root folder where the .github/copilot-instructions.md file will reside. Ensure the file is placed at the exact path below relative to your project root so the AI engine automatically loads it:
Step 2: Fetch Rule File via Terminal Command
Run curl, PowerShell, or wget to stream the rule directly from the DevScratchpad raw API endpoint and write it to .github/copilot-instructions.md:
Terminal One-Liner Install
Run directly in your project root to stream and write this rule file with one command.
mkdir -p ".github" && curl -fsSL "https://www.devscratchpad.tech/api/raw/copilot-instructions/spring-boot-3" -o ".github/copilot-instructions.md"Step 3: Verify and Activate with AI Agent
Launch your AI coding assistant (Universal AI Assistants). The assistant will automatically discover .github/copilot-instructions.md in your repository and apply the architectural guardrails, type constraints, and verification protocols during code generation.
GitHub Copilot Instructions Generator
Inspect the complete specification manual, glob patterns, directory rules, and all available presets in our central directory.
Pair With Spring Boot 3 & Java 21 Client-Side Utilities
100% private, browser-based utilities to test, format, and inspect code generated by your AI rules.
cURL to JavaScript Fetch
Translate bash cURL commands into JavaScript fetch() API calls.
cURL to Python Requests
Translate bash cURL commands into Python `requests` code.
JSON Formatter & Validator
Format, validate, and minify JSON with interactive syntax highlighting and sorting.
HMAC Generator
Compute Hash-based Message Authentication Codes (HMAC) using SHA256, SHA512, etc.
Migrating from Legacy .cursorrules or CLAUDE.md?
Use our free, offline converter to transform monolithic rulebooks into modular Cursor .mdc, Claude SKILL.md, and Windsurf Cascade rules.
Technical FAQ: Spring Boot 3 & Java 21 AI Rulebooks
Does this rulebook support Java 21 virtual threads?
Yes, it guides configuration and usage of lightweight virtual threads (Project Loom) for high-concurrency Spring Boot 3 services.
Why does it ban javax.* packages?
Spring Boot 3 requires Jakarta EE 10 APIs; javax.persistence and javax.servlet cause immediate compilation failures.