Merge pull request #1 from jabrena/feature/evolution-1

Evolution 1 for Java rules

Author: jabrena

.cursor/rules/01-java.md .cursor/rules/01-java.mdc.cursor/rules/01-java.md renamed to .cursor/rules/01-java.mdc

@@ -1,4 +1,11 @@
+---
+description: General java rules
+globs: .java
+alwaysApply: true
+---
+
 # AI Developer Profile
+
 ai_persona:
   role: Senior Java Developer
   principles:
@@ -12,6 +19,7 @@ ai_persona:
     - DDD
 
 # Technical Stack
+
 tech_stack:
   framework: Spring Boot
   build_tool: Maven
@@ -25,4 +33,4 @@ tech_stack:
     - JQwik
     - JMH
   language: English
-  code_comments: English
+  code_comments: English

.cursor/rules/02-effective-java.md .cursor/rules/02-effective-java.mdc.cursor/rules/02-effective-java.md renamed to .cursor/rules/02-effective-java.mdc

@@ -1,3 +1,9 @@
+---
+description: Extension to java rules from the book Effective Java
+globs: .java
+alwaysApply: true
+---
+
 # Development Guidelines
 effective_java_notes:
   chapter_2:
@@ -132,4 +138,4 @@ effective_java_notes:
       - "Consider using a custom serialized form"
       - "Write readObject methods defensively"
       - "For instance control, prefer enum types to readResolve"
-      - "Consider serialization proxies instead of serialized instances"
+      - "Consider serialization proxies instead of serialized instances"

.cursor/rules/03-concurrency.md

@@ -0,0 +1,17 @@
+---
+description: Extension to java rules for Concurrency objects
+globs: .java
+alwaysApply: true
+---
+
+# concurrency_guidelines:
+
+  -  Use thread-safe data structures
+  -  Use thread-safe collections
+  -  Use thread-safe classes
+  -  Use thread-safe methods
+  -  Use thread-safe objects
+  -  Use thread-safe variables
+  -  Use thread-safe methods
+  -  Use thread-safe objects
+  -  Use thread-safe variables

.cursor/rules/03-concurrency.mdc

@@ -0,0 +1,15 @@
+---
+description: Extension to java rules for Functional programming
+globs: .java
+alwaysApply: true
+---
+
+# functional_programming_guidelines:
+
+  - Try to use immutable objects
+  - Try to not mutate the state of the objects
+  - Try to use pure functions
+  - Try to use functional interfaces
+  - Try to use lambda expressions
+  - Try to use streams
+  - Try to use functional programming paradigms

.cursor/rules/04-functional-programming.md

@@ -0,0 +1,18 @@
+---
+description: Extension to java rules when develop features for Modern Java
+globs: .java
+alwaysApply: true
+---
+
+# Data oriented programming pillars:
+
+  -  Separate code from data
+  -  Represent data with generic data structures
+  -  Data should be immutable
+  -  Use pure functions to manipulate data
+  -  Keep data flat and denormalized
+  -  Keep data generic until it needs to be specific
+  -  Data integrity is maintained through validation functions
+  -  Data access should be flexible and generic
+  -  Data transformation should be explicit and traceable
+  -  Data flow should be unidirectional

.cursor/rules/04-functional-programming.mdc

@@ -1 +1,2 @@
-.DS_Store
+.DS_Store
+tmp

.cursor/rules/05-data-oriented-programming.md

@@ -1,17 +1,25 @@
 # Java Cursor AI rules
 
-A collection of cursor rules for Java space
+A collection of Cursor rules for Java space.
+
+![](./docs/cursor-settings.png)
 
 ## Rules
 
-- [Java](.cursor/rules/01-java.md)
-- [Effective Java](.cursor/rules/02-effective-java.md)
-- [Concurrency](.cursor/rules/03-concurrency.md)
-- [Functional Programming](.cursor/rules/04-functional-programming.md)
-- [Data oriented programming](.cursor/rules/05-data-oriented-programming.md)
-- [Spring boot](.cursor/rules/06-spring-boot.md)
+- [Java](.cursor/rules/01-java.mdc)
+- [Effective Java](.cursor/rules/02-effective-java.mdc)
+- [Concurrency](.cursor/rules/03-concurrency.mdc)
+- [Functional Programming](.cursor/rules/04-functional-programming.mdc)
+- [Data oriented programming](.cursor/rules/05-data-oriented-programming.mdc)
+- [Spring boot](.cursor/rules/06-spring-boot.mdc)
 
 ## References
 
 - https://www.cursor.com/
-- https://docs.cursor.com/context/rules-for-ai
+- https://docs.cursor.com/context/rules-for-ai
+- https://docs.cursor.com/context/%40-symbols/%40-cursor-rules
+
+### Articles
+
+- https://dev.to/dpaluy/mastering-cursor-rules-a-developers-guide-to-smart-ai-integration-1k65
+- https://www.instructa.ai/en/blog/how-to-use-cursor-rules-in-version-0-45