-
Notifications
You must be signed in to change notification settings - Fork 67
Expand file tree
/
Copy pathrelease-0.14.0.html
More file actions
289 lines (266 loc) · 15.9 KB
/
release-0.14.0.html
File metadata and controls
289 lines (266 loc) · 15.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
<title>What's new in Cursor rules for Java 0.14.0? - Skills & Agents for Java</title>
<meta name="author" content="" />
<meta name="description" content="">
<link rel="alternate" type="application/atom+xml" href="../../../feed.xml" title="Skills & Agents for Java"/>
<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css" />
<link rel="stylesheet" href="../../../css/bootstrap.min.css">
<link rel="stylesheet" href="../../../css/bootstrap-social.css" />
<link rel="stylesheet" href="../../../css/main.css" />
<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lora:400,700,400italic,700italic" />
<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800" />
<link rel="stylesheet" href="../../../css/asciidoctor.css">
<link rel="stylesheet" href="../../../css/prettify.css">
<link rel="icon" type="image/png" href="../../../images/java-icon.png">
</head>
<body>
<nav class="navbar navbar-default navbar-fixed-top navbar-custom">
<div class="container-fluid">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#main-navbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="../../../index.html">Skills & Agents for Java</a>
</div>
<div class="collapse navbar-collapse" id="main-navbar">
<ul class="nav navbar-nav navbar-right">
<li><a href="https://forms.gle/TpNXENjmu45wuXoi6" target="_blank">Share feedback</a></li>
<li class="navlinks-container">
<a class="navlinks-parent" href="javascript:void(0)">Conferences</a>
<div class="navlinks-children">
<a href="https://jabrena.github.io/cursor-rules-java/codemotion-madrid-2026/index.html" target="_blank">Codemotion Madrid 2026</a>
<a href="https://jabrena.github.io/cursor-rules-java/dvbe25/index.html" target="_blank">Devoxx BE 2025</a>
<a href="https://jabrena.github.io/101-cursor/" target="_blank">WJAX-2025</a>
</div>
</li>
<li class="navlinks-container">
<a class="navlinks-parent" href="javascript:void(0)">Courses</a>
<div class="navlinks-children">
<a href="../../../courses/system-prompts-java/index.html">System prompts for Java</a>
<a href="../../../courses/java-generics/index.html">Java Generics</a>
<a href="../../../courses/profile-memory-leak/index.html">Memory Leak Profiling</a>
</div>
</li>
<li><a href="../../../archive.html">Archive</a></li>
<li><a href="https://jabrena-github-io.translate.goog/cursor-rules-java/?_x_tr_sl=en&_x_tr_tl=cn&_x_tr_hl=en-US&_x_tr_pto=wapp">Translate</a></li>
</ul>
</div>
</div>
</nav>
<header class="header-section">
<div class="intro-header no-img">
<div class="container">
<div class="row">
<div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
<div class="post-heading">
<h1>What's new in Cursor rules for Java 0.14.0?</h1>
<span class="post-meta">
<i class="fa fa-calendar-o"></i>
2026-04-13
<i class="fa fa-pencil"></i>
Juan Antonio Breña Moral
</span>
<span class="blog-tags">
<i class="fa fa-tags"></i>
<a href="../../../tags/blog.html">blog</a>
</span>
</div>
</div>
</div>
</div>
</div>
</header>
<div class="container">
<div class="row">
<div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
<article role="main" class="blog-post">
<h2>What are Cursor rules for Java?</h2>
<p>A curated collection of <code>Skills</code> and <code>Agents</code> to be used in modern <code>SDLC</code> workflows for Java Enterprise development.</p>
<p>Thanks to our community members in <code>Singapore</code>, <code>Chengdu</code>, <code>Hanoi</code>, <code>Copenhagen</code>, and <code>Quito</code>. 👋👋👋</p>
<h2>What's new in this release?</h2>
<h3>Rules support dropped in favor of Skills</h3>
<p>It is a bit weird to explain that the project is named <code>Cursor rules for Java</code>, but one of the changes in this minor release is to drop support for Rules.</p>
<p><strong>Why were Cursor rules dropped?</strong></p>
<p>Until this release, the project maintained three very different deliverables: Rules, Skills, and Agents. <code>Rules</code> and <code>Skills</code> both guide model behaviour in broadly similar ways, but Rules were Cursor’s approach while <code>Skills</code> have recently become the standard, so consolidating on a single solution makes more sense. <strong>On the other hand</strong>, maintaining a single generator (<code>skills-generator</code>) made it possible to improve how skills are packaged, which was somewhat constrained when both <code>rules-generator</code> and <code>skills-generator</code> existed.</p>
<pre><code class="language-bash">skill-name/
├── SKILL.md # Required: metadata + instructions
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
├── assets/ # Optional: templates, resources
└── ... # Any additional files or directories
</code></pre>
<p><strong>Source:</strong> <a href="https://agentskills.io/specification">https://agentskills.io/specification</a></p>
<p>If you followed the various ADRs published at <a href="https://github.com/jabrena/cursor-rules-java/tree/main/documentation/adr">https://github.com/jabrena/cursor-rules-java/tree/main/documentation/adr</a>, you may recall that when more than 10 rules were active in memory, Cursor (and similar tools at the time) did not run reliably, and you could hit the following issue:</p>
<p><img src="/cursor-rules-java/images/2026/4/your-message-is-too-long.png" alt="" /></p>
<p>If you are interested in this issue with older models, you can review it here: <a href="https://github.com/jabrena/cursor-rules-sandbox/blob/main/docs/message-too-long.md">https://github.com/jabrena/cursor-rules-sandbox/blob/main/docs/message-too-long.md</a></p>
<p>So we changed the metadata included in the <code>System prompts/Rules</code> to address that issue and to use the rules in a manual workflow, as described here: <a href="https://github.com/jabrena/cursor-rules-java/blob/main/documentation/adr/ADR-002-configure-cursor-rules-manual-scope.md">https://github.com/jabrena/cursor-rules-java/blob/main/documentation/adr/ADR-002-configure-cursor-rules-manual-scope.md</a></p>
<p>Users could still use the <code>System prompts/Rules</code> in this way:</p>
<p><img src="/cursor-rules-java/images/2026/4/manual-trigger.png" alt="" /></p>
<p>But now you can do the same with Skills. You can add the Skill you want to the context explicitly, or leave it to the AI tool to use or skip depending on the context—so you can achieve the same outcomes with Skills as you could with system prompts in the past.</p>
<p>On the main branch, a few resources about <code>System-prompts/rules</code> remain:</p>
<ul>
<li>All rules from v0.13.0: <a href="https://github.com/jabrena/cursor-rules-java/tree/main/.cursor/rules">https://github.com/jabrena/cursor-rules-java/tree/main/.cursor/rules</a></li>
<li>Getting Started: <a href="https://github.com/jabrena/cursor-rules-java/blob/main/documentation/GETTING-STARTED-SYSTEM-PROMPTS.md">https://github.com/jabrena/cursor-rules-java/blob/main/documentation/GETTING-STARTED-SYSTEM-PROMPTS.md</a></li>
</ul>
<p>That usage is <code>deprecated</code> in favor of <code>Skills</code> and will be removed in the coming months; the recommendation is to review <a href="https://github.com/jabrena/cursor-rules-java?tab=readme-ov-file#deliverables">the new documentation</a> and adapt.</p>
<p>You can still download the last generated rules from release 0.13.0 if needed: <a href="https://github.com/jabrena/cursor-rules-java/releases/tag/0.13.0">https://github.com/jabrena/cursor-rules-java/releases/tag/0.13.0</a></p>
<p>Now that the serious part is out of the way, let's continue with the article.</p>
<h3>Improvements in the Agile process</h3>
<p>When you create a <code>User Story</code>, the flow not only generates the usual structure plus acceptance criteria in <code>Gherkin</code> format; it also reviews the user story as a whole using <code>INVEST</code>. INVEST is an acronym used in Agile to evaluate the quality of a user story, ensuring it is <code>Independent</code>, <code>Negotiable</code>, <code>Valuable</code>, <code>Estimable</code>, <code>Small</code>, and <code>Testable</code>.</p>
<p><strong>Skills:</strong></p>
<ul>
<li><code>@014-agile-user-story</code></li>
</ul>
<h3>Improvements in the planning process</h3>
<p>It is tedious to copy issue details from your issue tracker into the context of whichever AI tool you use. With that in mind, you can now access assigned issues more easily if you work with <code>GitHub Issues</code> or <code>Jira</code>. Those <code>Skills</code> combine well with <code>@014-agile-user-story</code> to turn the classic <code>Anemic one line User Story</code> into something richer.</p>
<p>Once the information is <code>ready for development</code>, you can convert it into a <code>Change</code> or <code>Delta</code> using <code>OpenSpec</code>.</p>
<p><img src="/cursor-rules-java/images/2026/4/issue-to-openspec.png" alt="" /></p>
<h4>How does OpenSpec work?</h4>
<p>OpenSpec is a spec-driven change workflow: you capture what you want and how you will verify it before (or alongside) changing code and generators.</p>
<p>The scaffolding for any project using OpenSpec looks like this:</p>
<pre><code class="language-bash">openspec/
└── changes/
└── add-profile-filters/
├── proposal.md
├── tasks.md
└── specs/profile/spec.md
└── specs/
config.yaml
</code></pre>
<p>Commands you will use often:</p>
<pre><code class="language-bash">openspec init
openspec list
openspec status --change <change-id>
openspec show <change-name>
openspec new change <change-name>
openspec validate --all
openspec archive <change-name>
</code></pre>
<p>Further information about OpenSpec: <a href="https://openspec.dev/">https://openspec.dev/</a></p>
<h4>When to use OpenSpec in daily work?</h4>
<p>If you pick up a user story from any issue-tracking tool and it relates to a service you know well, you can use the following workflow directly:</p>
<pre><code class="language-bash">User story > Create a Change in OpenSpec > Implement with Java Agents
</code></pre>
<p><img src="/cursor-rules-java/images/2026/4/implement-openspec-change.png" alt="" /></p>
<p>But if you are less sure about the assigned user story, invest more time in the analysis phase:</p>
<pre><code class="language-bash">User story > Create a Plan > Enhance the plan > Convert into multiple Changes in OpenSpec > Implement with Java Agents
</code></pre>
<p>Some factors to consider:</p>
<ul>
<li>Design incremental Deltas</li>
<li>Review the tests</li>
<li>Use TDD. (Consider TCR)</li>
<li>Do not execute all changes at once. Finish one and review for potential technical debt.</li>
</ul>
<p><strong>Skills:</strong></p>
<ul>
<li><code>@042-planning-openspec</code></li>
<li><code>@043-planning-github-issues</code></li>
<li><code>@044-planning-jira</code></li>
</ul>
<h3>Improvements in the Implementation phase</h3>
<h4>Improvements in Maven</h4>
<p>Now it is easier to update your <code>pom.xml</code> with <code>@114-java-maven-search</code>. On the other hand, the Maven-related skills are gradually gaining popularity.</p>
<p><a href="https://skills.sh/?q=maven">https://skills.sh/?q=maven</a></p>
<p><strong>Skills</strong></p>
<ul>
<li><code>@114-java-maven-search</code></li>
</ul>
<h3>Reinforced REST API development with new technologies</h3>
<p>In the previous release, the project added Agents to implement plans. In this release, you can apply changes in a more granular way, or keep using Plans when the change is small. You can review your REST contracts with <code>@701-technologies-openapi</code>, reinforce your integration tests with <code>@702-technologies-wiremock</code>, and—most significantly for testing—use the new black-box testing capabilities with <code>@703-technologies-fuzzing-testing</code> based on <code>CATS</code>.</p>
<p>You can run black-box tests against your development environment using your <code>OpenAPI</code> specification.</p>
<p><img src="/cursor-rules-java/images/2026/4/cats.png" alt="" /></p>
<p>Further information about CATS: <a href="https://github.com/Endava/cats">https://github.com/Endava/cats</a></p>
<p><strong>Skills</strong></p>
<ul>
<li><code>@701-technologies-openapi</code></li>
<li><code>@702-technologies-wiremock</code></li>
<li><code>@703-technologies-fuzzing-testing</code></li>
</ul>
<h3>Skill inventory</h3>
<p>In version <code>v0.14.0</code>, the project ships <code>68 Skills</code>.</p>
<p>You can install the <code>Skills</code> easily with:</p>
<pre><code class="language-bash">npx skills add jabrena/cursor-rules-java --all --agent cursor
npx skills add jabrena/cursor-rules-java --all --agent claude-code
</code></pre>
<p>Once you have the skills installed, you can install the <code>Agents</code> with:</p>
<pre><code>@003-agents-installation Install Agents in Cursor
@003-agents-installation Install Agents in Claude
</code></pre>
<h2>What is the next step?</h2>
<p>In the next release, the project will be renamed to reflect its evolution, and a few Skills will be refactored using notes from <a href="https://tessl.io/registry">Tessl</a>.</p>
<h2>Do you still have questions about the project?</h2>
<p>If you feel stuck using this project or have questions, you can attend the following workshop at <code>Codemotion Madrid 2026</code>:</p>
<p><a href="https://conferences.codemotion.com/madrid/"><img src="/cursor-rules-java/images/2026/3/codemotion-madrid-2026.jpg" alt="" /></a></p>
<p><a href="https://conferences.codemotion.com/madrid/workshop/">https://conferences.codemotion.com/madrid/workshop/</a></p>
</article>
</div>
</div>
</div>
<footer>
<div class="container beautiful-jekyll-footer">
<div class="row">
<div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
<ul class="list-inline text-center footer-links">
<li>
<a href="https://twitter.com/juanantoniobm" title="Twitter">
<span class="fa-stack fa-lg">
<i class="fa fa-circle fa-stack-2x"></i>
<i class="fa fa-twitter fa-stack-1x fa-inverse"></i>
</span>
</a>
</li>
<li>
<a href="https://github.com/jabrena/cursor-rules-java" title="GitHub">
<span class="fa-stack fa-lg">
<i class="fa fa-circle fa-stack-2x"></i>
<i class="fa fa-github fa-stack-1x fa-inverse"></i>
</span>
</a>
</li>
<li>
<a href="../../../feed.xml" title="RSS">
<span class="fa-stack fa-lg">
<i class="fa fa-circle fa-stack-2x"></i>
<i class="fa fa-rss fa-stack-1x fa-inverse"></i>
</span>
</a>
</li>
</ul>
<p class="copyright text-muted">
© Juan Antonio Breña Moral, 2026 |
Baked with <a href="http://jbake.org">JBake v2.7.0</a>
</p>
<p class="theme-by text-muted">
Theme by <a href="https://github.com/Yamane/beautiful-jbake/" target="_blank">beautiful-jbake</a>
adapted from <a href="http://deanattali.com/beautiful-jekyll/" target="_blank">beautiful-jekyll</a>
</p>
</div>
</div>
</div>
</footer>
<script src="../../../js/jquery-1.11.2.min.js"></script>
<script src="../../../js/bootstrap.min.js"></script>
<script src="../../../js/prettify.js"></script>
<script src="../../../js/run_prettify.js"></script>
<script src="../../../js/main.js"></script>
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-13CV90H4J4"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-13CV90H4J4');
</script>
</body>
</html>