Website: https://jabrena.github.io/cursor-rules-java/
Support the project: Sponsor to pay tokens
Deprecation notice: Current System prompts/rules are deprecated and will be removed in v0.16.0. If you still use them, review the release 0.14.0 article.
An opinionated AI-native workflow for evolving modern Java Enterprise SDLC practices through reusable Skills, Agents, Commands & MCP servers.
It helps you answer the Five whys when your team needs to evolve a Java-based product or service:
| QUESTION | ROLE | AREA | SUPPORT |
|---|---|---|---|
| WHAT / WHEN | PO, BA, EA, SA, TL | Agile & Planning | User Stories, GitHub Issues & Jira |
| WHY | EA, SL, TL | Architecture | ADRs & UML / C4 / ER Diagrams |
| HOW | SA, TL, SWE | Spec-Driven | AI Plan mode & OpenSpec |
| HOW | TL, SWE | Java development | Build system based on Maven, Design, Coding, Testing, Observability, Refactoring & JMH Benchmarking, Performance testing with JMeter, Profiling with Async profiler/OpenJDK tools, Documentation, Spring Boot, Quarkus, Micronaut, OpenAPI, WireMock & AGENTS.md |
Once the idea is clear, you can implement it in a structured way:
The project generates a set of deliverables at the end of any iteration.
| Inventory | Installation | Getting Started |
|---|---|---|
| 1. Commands | @004-commands-installation Install Commands in project |
Commands |
| 2. Agents | @005-agents-installation Install Agents in Cursor/Claude |
Agents |
| 3. Skills | npx skills add jabrena/cursor-rules-java --all --agent cursor |
Skills |
This project is compatible with any tool that supports Commands, Agents, Skills, MCP Servers and AGENTS.md.
Learn to use this project following the quick guide Getting Started in 5 minutes.
Every push runs the following validation checks in CI Builds to keep documentation and generated skills correct, consistent, and secure:
| Name | Purpose |
|---|---|
| 1. MarkdownValidator | Protects the documentation layer by catching Markdown parsing drift and remote link failures before skill-specific checks run. |
| 2. skill-check | Confirms every generated skill follows the expected packaging contract, complementing scanners that focus on behavior or security risk. |
| 3. cisco-ai-skill-scanner by Cisco | Adds behavior-oriented security coverage by looking for risky skill flows that structural validation cannot see. |
| 4. SkillSpector by NVIDIA | Provides an independent static quality and security review, useful for comparing findings against the other scanners. |
| 5. Snyk Agent Scan by SNYK | Focuses on agent-skill supply-chain and prompt-risk signals, adding another security perspective alongside Cisco and SkillSpector. |
From the outset, be aware that results from interactions with these Skills and agents are not deterministic because of how the models behave, but you can mitigate that with clear goals and validation checkpoints.
Some interactive skills require Premium models for interactive use; otherwise they follow a fixed sequence of steps.
Models can generate code, but they cannot execute it against your local data. To bridge that gap, some Skills include scripts you run locally.
This project supports software engineering work; it does not replace engineering judgment. A software engineer must review, guide, and validate AI-generated decisions, code, and outcomes before they are used.
Use caution when a problem involves corporate databases or other sensitive organizational data. Before granting an AI-assisted workflow access, assess authorization, privacy, data leakage, retention, and unintended modification risks. Apply least-privilege access, human review, validation, and monitoring. See OWASP GenAI Data Security Risks & Mitigations 2026 and the The EU Artificial Intelligence Act.
See CONTRIBUTING.md for conventions, generator workflows, tests, and how to open a pull request.
- Review the ADR index for the complete list.
- Review the CHANGELOG for further details.
Java uses JEPs (JDK Enhancement Proposals) to describe new language and platform features. This repository tracks which JEPs could improve the Skills and guidance here.
Talks, articles, reference links, skill portals, and related projects live in Project references.
Developed by humans with support from Cursor and Codex, with ❤️ from Madrid