Improving the README (#160)

* Improving the README

Author: jabrena

README.md

@@ -3,6 +3,8 @@
 ## Stargazers over time
 [![Stargazers over time](https://starchart.cc/jabrena/cursor-rules-java.svg?variant=light)](https://starchart.cc/jabrena/cursor-rules-java)
 
+[![CI Builds](https://github.com/jabrena/cursor-rules-java/actions/workflows/maven.yaml/badge.svg)](https://github.com/jabrena/cursor-rules-java/actions/workflows/maven.yaml)
+
 ## Motivation
 
 Modern Java IDEs, such as **Cursor AI**, provide ways to customize how the `Agent model` behaves using reusable and scoped instructions. In cursor, the way to do it is named `Cursor rule` and you could see it as a `System prompt` if you use a generic term. This repository provides a collection of Cursor rules designed for Java development.
@@ -11,17 +13,32 @@ Modern Java IDEs, such as **Cursor AI**, provide ways to customize how the `Agen
 
 A system prompt is a set of instructions given to an AI model that defines how it should behave, what role it should take on, and what guidelines it should follow when responding to users. Think of it as the "operating manual" that shapes the AI's personality, capabilities, and boundaries.
 
-[Further information](./docs/cursor-interaction-sequence.png)
-
 ## How to use the Cursor rules?
 
 Using the Cursor rules is straightforward: simply `drag and drop` the cursor rule that you need into the chat textbox where you are typing your `User prompt`.
 
 ⚠️ Currently, the cursor rules are released with the [manual scope](https://docs.cursor.com/context/rules#rule-type) on purpose by design to mitigate potential negative performance impact in communications with **The Cursor platform**.
 
+Review the following [sequence diagram](./docs/cursor-interaction-sequence.png) to understand the technical details.
+
+## What is the structure of a System prompt?
+
+Attending the documentation from [Google Gemini](https://drive.google.com/file/d/1AbaBYbEa_EbPelsT40-vj64L-2IwUJHy/view), [Anthropic Claude](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/overview) & [OpenAI ChatGPT](https://chatgpt.com/share/686d1066-9e40-800b-ac7f-cc8df7e4c7d0), a prompt should be structured in the following way:
+
+- Metadata
+- Role
+- Context (Optional)
+- Goal
+- Constraints (Optional)
+- Examples (Optional)
+- Output format (Optional)
+- Safeguards (Optional)
+
+With this structure in mind, the project use a XML Schema to define the way that all System prompts are generated for Cursor AI. If you feel interested, you could review [the Schema](./generator/src/main/resources/pml.xsd). All non interactive Cursor rules are generated by XML to enforce consistency in the output and easy maintenance.
+
 ## Cursor Rules
 
-Read the generated list of cursor rules for Java [here](./CURSOR-RULES-JAVA.md)
+Read the generated list of cursor rules for Java [here](./CURSOR-RULES-JAVA.md). The set of cursor rules cover aspects like, Build system based on Maven, Design, Coding, Testing, Refactoring, Performance with Jmeter & Profiling with Async Profiler.
 
 ## Getting started
 
@@ -70,10 +87,6 @@ Java use JEPS as the vehicle to describe the new features to be added in the lan
 
 - [JEPS List](./docs/All-JEPS.md)
 
-## What is the structure of a Cursor rule?
-
-Review the [template](./docs/000-cursor-rule-template.md) for details.
-
 ## Contribute
 
 If you have new ideas to improve any of the current Cursor rules or add a new one, please fork the repo and send a PR.