Skip to content

Commit bbbc013

Browse files
committed
Prepared the article to be reviewed online
1 parent 6be35c3 commit bbbc013

File tree

6 files changed

+159
-85
lines changed

6 files changed

+159
-85
lines changed

README.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -50,13 +50,9 @@ Adding AI tools in your Data Pipeline could offer new opportunties to offer more
5050

5151
## Getting started
5252

53-
New to this repository? Start with our [comprehensive guide](./documentation/GETTING-STARTED.md) for a quick introduction to setting up and using the Cursor rules.
53+
New to this repository? Start with our [comprehensive guide](./documentation/GETTING-STARTED.md) for a quick introduction to setting up and using the Cursor rules and later you could read about [how to integrate System prompts](./documentation/HOW-TO-USE.md) into your development workflow and maximize their effectiveness in your daily coding tasks. For full understanding about this project, follow this course about [Mastering System Prompts for Java](https://jabrena.github.io/cursor-rules-java/courses/system-prompts-java/index.html)
5454

55-
## How to use a System prompt in your development?
56-
57-
Learn [how to integrate System prompts](./documentation/HOW-TO-USE.md) into your development workflow and maximize their effectiveness in your daily coding tasks.
58-
59-
## How many System prompts include this repository?
55+
## How many System prompts for Java include this project?
6056

6157
Explore the [complete catalog of available System prompts](./CURSOR-RULES-JAVA.md) to discover the full range of capabilities and find the perfect rules for your specific use cases.
6258

docs/blog/2025/09/release-0.11.0.html

Lines changed: 66 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -93,43 +93,49 @@ <h1>What's new in Cursor rules for Java 0.11.0?</h1>
9393
<div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
9494
<article role="main" class="blog-post">
9595
<h2>What are Cursor rules for Java?</h2>
96-
<p>The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The <a href="https://github.com/jabrena/cursor-rules-java/blob/main/CURSOR-RULES-JAVA.md">available System prompts for Java</a> cover aspects like <code>Build system based on Maven</code>, <code>Design</code>, <code>Coding</code>, <code>Testing</code>, <code>Refactoring &amp; JMH Benchmarking</code>, <code>Performance testing with JMeter</code>, <code>Profiling with Async profiler/JDK tools</code> &amp; <code>Documentation</code> &amp; <code>Diagrams</code>.</p>
97-
<h2>What is new in this release?</h2>
98-
<p>In this release, the project has released several features:</p>
99-
<p><strong>Improvements in System prompts:</strong></p>
96+
<p>The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The <a href="https://github.com/jabrena/cursor-rules-java/blob/main/CURSOR-RULES-JAVA.md">available System prompts for Java</a> cover areas such as <code>Build system based on Maven</code>, <code>Design</code>, <code>Coding</code>, <code>Testing</code>, <code>Refactoring &amp; JMH Benchmarking</code>, <code>Performance testing with JMeter</code>, <code>Profiling with async-profiler/JDK tools</code>, <code>Documentation</code>, and <code>Diagrams</code>.</p>
97+
<h2>What's new in this release?</h2>
98+
<p>In this release, the project introduces several updates:</p>
10099
<ul>
101-
<li>Decoupled specifialized behaviours like <code>behaviour-consultative-interaction</code> from System prompts.</li>
102-
<li>Added specialized behaviours to combine with Pure System prompts.</li>
103-
<li>Added support for <code>UML State machine diagrams</code> in <code>@170-java-documentation</code>.</li>
104-
</ul>
105-
<p><strong>Improvements in the project:</strong></p>
106-
<ul>
107-
<li>Added Website based on JBake</li>
108-
<li>Added Initial support for AGENTS.md</li>
109-
</ul>
110-
<p><strong>Improvements about Support:</strong></p>
111-
<ul>
112-
<li>Added a course about How to use <code>System prompts for Java</code></li>
100+
<li><strong>Improvements in system prompts:</strong></li>
101+
<li>Decoupled the specialized behavior <code>behaviour-consultative-interaction</code> from some system prompts.</li>
102+
<li>Added specialized behaviors (<code>behaviour-consultative-interaction</code> and <code>behaviour-progressive-learning</code>) that can be combined with pure system prompts.</li>
103+
<li>Added support for <code>UML state machine diagrams</code> in <code>@170-java-documentation</code>.</li>
104+
<li>Updated <code>@161-java-profiling-detect</code> to add support for<code>Async-profiler 4.1</code> and the latest <code>JFR features</code> included in <code>Java 25</code> and earlier.</li>
105+
<li><strong>Project improvements:</strong></li>
106+
<li>Published a dedicated website about System prompts for Java to communicate releases, articles, and courses with the help of JBake.</li>
113107
</ul>
114108
<p>Let's explain one by one the different features released.</p>
115-
<h2> Why decouple Pure System prompts from Specialized behaviours?</h2>
116-
<p>During the previous months, the System prompts helped Sofware engineers using the <code>consultative-interaction</code> technique in order to use the System prompts in a way that the execution show a set of alternatives and the software engineer take the decision to update the code in a dynamic way.</p>
117-
<p>With this idea, we had until <code>v0.10.0</code> this syntax:</p>
118-
<pre><code>Interactive User prompt: Review my code to show several alternatives to apply Java Generics with the cursor rule @128-java-generics
119-
User Prompt: Apply Java Generics in the class with @128-java-generics without any question
109+
<h2> Why decouple Pure System prompts from specialized behaviors?</h2>
110+
<p>In previous months, the system prompts evolved to present refactoring alternatives using the <code>consultative-interaction technique</code> and then apply the user's decision. However, that design coupled the system prompt with a specific specialized behavior.</p>
111+
<p>With this approach, until <code>v0.10.0</code> we used this syntax:</p>
112+
<p><strong>Interactive user prompt:</strong></p>
113+
<pre><code>Review my code to show several alternatives to apply Java Generics
114+
with the cursor rule @128-java-generics
120115
</code></pre>
121-
<p><a href="https://github.com/jabrena/cursor-rules-java/blob/0.10.0/CURSOR-RULES-JAVA.md">https://github.com/jabrena/cursor-rules-java/blob/0.10.0/CURSOR-RULES-JAVA.md</a></p>
122-
<p>But from <code>v0.11.0</code>, you have a better and clean syntax:</p>
123-
<pre><code>User Prompt with Consultative Interactive Behaviour: Improve the class/classes added in the context applying the system prompt @128-java-generics with the behaviour @behaviour-consultative-interaction
124-
User Prompt with Training behaviour: Create a course about @128-java-generics.md using the behavior @behaviour-progressive-learning.md and put the course here
125-
User Prompt: Improve the class/classes added in the context applying the system prompt @128-java-generics
116+
<p><strong>User prompt:</strong></p>
117+
<pre><code>Apply Java Generics in the class with @128-java-generics
118+
without any question
126119
</code></pre>
127-
<p><a href="https://github.com/jabrena/cursor-rules-java/blob/0.11.0/CURSOR-RULES-JAVA.md">https://github.com/jabrena/cursor-rules-java/blob/0.11.0/CURSOR-RULES-JAVA.md</a></p>
128-
<p><img src="/cursor-rules-java/images/workflow.png" alt="" /></p>
129-
<p>but what happen if you System prompts with <code>Data pipelines</code>?</p>
130-
<p><img src="/cursor-rules-java/images/data-pipeline-workflow.png" alt="" /></p>
131-
<p>In this situations, it is better provide <code>Pure System prompts</code>.</p>
132-
<p>What Pure system prompts does exist in the project?</p>
120+
<hr />
121+
<p>But now, starting with <code>v0.11.0</code>, you have a cleaner syntax:</p>
122+
<p><strong>User prompt with consultative interactive behavior:</strong></p>
123+
<pre><code>Improve the classes provided in the context by applying
124+
the system prompt @128-java-generics
125+
with the behavior @behaviour-consultative-interaction
126+
</code></pre>
127+
<p><strong>User prompt with training behavior:</strong></p>
128+
<pre><code>Create a course for @128-java-generics.md
129+
using the behavior @behaviour-progressive-learning.md
130+
and place the course here
131+
</code></pre>
132+
<p><strong>User prompt:</strong></p>
133+
<pre><code>Improve the classes provided in the context
134+
by applying the system prompt @128-java-generics
135+
</code></pre>
136+
<p>Further information: <a href="https://github.com/jabrena/cursor-rules-java/blob/0.11.0/CURSOR-RULES-JAVA.md">https://github.com/jabrena/cursor-rules-java/blob/0.11.0/CURSOR-RULES-JAVA.md</a></p>
137+
<p>With this evolution, software engineers now can combine pure system prompts and specialized behaviors in <code>16^3 = 4096</code> combinations by design.</p>
138+
<p><strong>Pure system prompts:</strong></p>
133139
<ul>
134140
<li><a href="https://github.com/jabrena/cursor-rules-java/blob/main/.cursor/rules/100-java-cursor-rules-list.md"><code>@100-java-cursor-rules-list</code></a></li>
135141
<li><a href="https://github.com/jabrena/cursor-rules-java/blob/main/.cursor/rules/110-java-maven-best-practices.md"><code>@110-java-maven-best-practices</code></a></li>
@@ -148,17 +154,39 @@ <h2> Why decouple Pure System prompts from Specialized behaviours?</h2>
148154
<li><a href="https://github.com/jabrena/cursor-rules-java/blob/main/.cursor/rules/143-java-functional-exception-handling.md"><code>@143-java-functional-exception-handling</code></a></li>
149155
<li><a href="https://github.com/jabrena/cursor-rules-java/blob/main/.cursor/rules/144-java-data-oriented-programming.md"><code>@144-java-data-oriented-programming</code></a></li>
150156
</ul>
151-
<p>What Specialized behaviour does exist?</p>
157+
<p><strong>Specialized behaviors:</strong></p>
152158
<ul>
153-
<li>Default behaviour</li>
159+
<li>Default behavior</li>
154160
<li><a href="https://github.com/jabrena/cursor-rules-java/blob/main/.cursor/rules/behaviour-consultative-interaction.md"><code>@behaviour-consultative-interaction</code></a></li>
155161
<li><a href="https://github.com/jabrena/cursor-rules-java/blob/main/.cursor/rules/behaviour-progressive-learning.md"><code>@behaviour-progressive-learning</code></a></li>
156162
</ul>
157-
<p>Now, you have <code>16^3=4096</code> alternatives to interact with them by design.</p>
158-
<h2>Added UML State machine diagrams to understand better complex Dependencies.</h2>
163+
<p>With this design change applied into the different system prompts, you can use them in your <code>Data pipelines</code> for different use cases such as <code>automatic coding</code>, <code>code refactoring</code>, <code>continuous profiling</code>, and more.</p>
164+
<p><img src="/cursor-rules-java/images/data-pipeline-workflow.png" alt="" /></p>
165+
<h2>New UML state machine diagrams for better understanding in complex dependencies.</h2>
166+
<p>Sometimes you need to use complex dependencies in your projects, like Apache Kafka clients, and the team may not be strong enough in the early stages. If you don't have much experience with them, a good practice is to run a spike and review how the client works under the hood to mitigate risks.</p>
167+
<p>During the spike, you may need to visualize internal aspects of the clients, so why not generate a <code>UML state machine diagram</code> to gain more insights.</p>
168+
<p><strong>Examples:</strong></p>
169+
<pre><code>Create UML class diagrams with @171-java-diagrams without any questions from
170+
https://github.com/jabrena/kafka/tree/trunk/clients/src/main/java/org/apache/kafka/clients/producer
171+
</code></pre>
172+
<p><strong>Result:</strong></p>
159173
<p><img src="/cursor-rules-java/images/0.11.0-uml-state-machine-diagram-example.png" alt="" /></p>
160-
<h2>Do you still have doubts about the project?</h2>
161-
<p>If you feel stuck using this project or you have any doubts, you could attend the following talks at Devoxx BE in October:</p>
174+
<p>With this visualization, you can see whether something is missing in your Java integration.</p>
175+
<h2>Profiling improvements</h2>
176+
<p>In this release, the script <code>profile-java-process.sh</code>, included in <code>@161-java-profiling-detect</code>, was updated to include the latest release (v4.1) of the popular profiling tool Async-profiler. In addition, the script added new JFR options available in Java 25 and earlier.</p>
177+
<p><img src="/cursor-rules-java/images/0.11.0-profiling-menu.png" alt="" /></p>
178+
<p>In recent months, I have been inspired by the work of outstanding engineers in this field: <a href="https://x.com/forked_franz">Francesco Nigro</a>, <a href="https://x.com/jerrinot">Jaromir Hamala</a>, and <a href="https://x.com/parttimen3rd">Johannes Bechberger</a>. I highly recommend following them.</p>
179+
<h2>A new website</h2>
180+
<p>In recent releases, the project published an article summarizing its evolution and shared it across channels like Twitter, Reddit, and LinkedIn. To unify the source of truth, and leveraging <a href="https://docs.github.com/es/pages">GitHub Pages</a>, the project now has <a href="https://jabrena.github.io/cursor-rules-java/index.html">a dedicated website</a>.</p>
181+
<p>The website includes information about releases, technical articles you can apply in your projects, and courses.</p>
182+
<p><strong>What courses were created in this release?</strong></p>
183+
<ul>
184+
<li><a href="https://jabrena.github.io/cursor-rules-java/courses/system-prompts-java/index.html">Learn to use System prompts for Java</a></li>
185+
<li><a href="https://jabrena.github.io/cursor-rules-java/courses/java-generics/index.html">Learn to improve your development with Java Generics</a></li>
186+
<li><a href="https://jabrena.github.io/cursor-rules-java/courses/profile-memory-leak/index.html">Learn how to detect memory leaks with System prompts</a></li>
187+
</ul>
188+
<h2>Do you still have questions about the project?</h2>
189+
<p>If you feel stuck using this project or have questions, you can attend the following talks at Devoxx BE in October:</p>
162190
<ul>
163191
<li><a href="https://devoxx.be/app/talk/4715/the-power-of-cursor-rules-in-java-enterprise-development">https://devoxx.be/app/talk/4715/the-power-of-cursor-rules-in-java-enterprise-development</a></li>
164192
<li><a href="https://devoxx.be/app/talk/4708/101-cursor-ai-learning-to-use-for-java-enterprise-projects/">https://devoxx.be/app/talk/4708/101-cursor-ai-learning-to-use-for-java-enterprise-projects/</a></li>

docs/feed.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<feed xmlns='http://www.w3.org/2005/Atom' xml:lang='en'>
33
<id>https://jabrena.github.io/cursor-rules-java/</id>
44
<title>Cursor Rules for Java</title>
5-
<updated>2025-09-27T17:31:24+0200</updated>
5+
<updated>2025-09-27T20:05:34+0200</updated>
66
<link rel="alternate" type="text/html" href="https://jabrena.github.io/cursor-rules-java/" />
77
<link rel='self' type='application/atom+xml' href='https://jabrena.github.io/cursor-rules-java//feed.xml' />
88
<entry>
@@ -12,7 +12,7 @@
1212
<link rel="alternate" type="text/html" href="https://jabrena.github.io/cursor-rules-java//blog/2025/09/release-0.11.0.html" />
1313
<updated>2025-09-29T00:00:00+0200</updated>
1414
<summary>What are Cursor rules for Java?
15-
The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The available System prompts for Java cover aspects like Build system based on Maven, Design, Coding, Testing, Refactoring &amp;amp; JMH Benchmarking, Performance testing with JMeter, Profiling with Async profiler/JDK tools &amp;am...</summary>
15+
The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The available System prompts for Java cover areas such as Build system based on Maven, Design, Coding, Testing, Refactoring &amp;amp; JMH Benchmarking, Performance testing with JMeter, Profiling with async-profiler/JDK tools, D...</summary>
1616
</entry>
1717
<entry>
1818
<id>https://jabrena.github.io/cursor-rules-java//blog/2025/09/mastering-memory-leak-detection-comprehensive-course.html</id>

docs/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ <h3 class="post-title"><a href="blog/2025/09/release-0.11.0.html">What&apos;s ne
123123
<div class="post-entry-container">
124124
<div class="post-entry">
125125
What are Cursor rules for Java?
126-
The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The available System prompts for Java cover aspects like Build system based on Maven, Design, Coding, Testing, Refactoring &amp; JMH Benchmarking, Performance testing with JMeter, Profiling with Async profiler/JDK tools &am...
126+
The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The available System prompts for Java cover areas such as Build system based on Maven, Design, Coding, Testing, Refactoring &amp; JMH Benchmarking, Performance testing with JMeter, Profiling with async-profiler/JDK tools, D...
127127
<p></p>
128128
<a href="blog/2025/09/release-0.11.0.html" class="post-read-more">[Read More]</a>
129129
</div>

docs/tags/blog.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ <h2 class="post-title"><a href="../blog/2025/09/release-0.11.0.html">What&apos;s
9393
<div class="post-entry-container">
9494
<div class="post-entry">
9595
What are Cursor rules for Java?
96-
The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The available System prompts for Java cover aspects like Build system based on Maven, Design, Coding, Testing, Refactoring &amp; JMH Benchmarking, Performance testing with JMeter, Profiling with Async profiler/JDK tools &am...
96+
The project provides a collection of System prompts for Java Enterprise development that help software engineers in their daily programming work. The available System prompts for Java cover areas such as Build system based on Maven, Design, Coding, Testing, Refactoring &amp; JMH Benchmarking, Performance testing with JMeter, Profiling with async-profiler/JDK tools, D...
9797
<p></p>
9898
<a href="../blog/2025/09/release-0.11.0.html" class="post-read-more">[Read More]</a>
9999
</div>

0 commit comments

Comments
 (0)