Feature/goal renaming (#164)

jabrena · web-flow · commit c7b5fbb3d704 · 2025-07-08T18:50:19.000+02:00
* Minor change
diff --git a/.cursor/rules/100-java-checklist-guide.mdc b/.cursor/rules/100-java-checklist-guide.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java programming language and technical documentation
 
-## Instructions for AI
+## Goal
 
 Your task is to create a comprehensive step-by-step guide that follows the exact format and structure defined in the embedded template below.
 
diff --git a/.cursor/rules/110-java-maven-best-practices.mdc b/.cursor/rules/110-java-maven-best-practices.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Update the pom.xml based on the following rules about Maven best practices.
 
diff --git a/.cursor/rules/112-java-maven-documentation.mdc b/.cursor/rules/112-java-maven-documentation.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 When creating a README-DEV.md file for a Maven project, include ONLY the following sections with the specified Maven goals. Do NOT add any additional sections, explanations, or content beyond what is explicitly listed below.
 
diff --git a/.cursor/rules/121-java-object-oriented-design.mdc b/.cursor/rules/121-java-object-oriented-design.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Apply comprehensive guidelines for robust Java object-oriented design and refactoring. Follow core principles like SOLID, DRY, and YAGNI, implement best practices for class and interface design including favoring composition over inheritance and designing for immutability. Master encapsulation, inheritance, and polymorphism, and identify and refactor common object-oriented design code smells such as God Classes, Feature Envy, and Data Clumps to promote maintainable, flexible, and understandable code.
 
diff --git a/.cursor/rules/122-java-type-design.mdc b/.cursor/rules/122-java-type-design.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Type design thinking in Java applies typography principles to code structure and organization. Just as typography creates readable, accessible text, thoughtful type design in Java produces maintainable, comprehensible code.
 
diff --git a/.cursor/rules/123-java-general-guidelines.mdc b/.cursor/rules/123-java-general-guidelines.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 This document outlines general Java coding guidelines covering fundamental aspects such as naming conventions for packages, classes, methods, variables, and constants; code formatting rules including indentation, line length, brace style, and whitespace usage; standards for organizing import statements; best practices for Javadoc documentation; and comprehensive error and exception handling with a strong focus on security, including avoiding sensitive information exposure, catching specific exceptions, and secure resource management.
 
diff --git a/.cursor/rules/124-java-secure-coding.mdc b/.cursor/rules/124-java-secure-coding.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Apply secure coding practices to Java code to prevent common vulnerabilities and enhance application security.
 
diff --git a/.cursor/rules/125-java-concurrency.mdc b/.cursor/rules/125-java-concurrency.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Effective Java concurrency relies on understanding thread safety fundamentals, using `java.util.concurrent` utilities, and managing thread pools with `ExecutorService`. Key practices include implementing concurrent design patterns like Producer-Consumer, leveraging `CompletableFuture` for asynchronous tasks, and ensuring thread safety through immutability and safe publication. Performance aspects like lock contention and memory consistency must be considered. Thorough testing, including stress tests and thread dump analysis, is crucial. Modern Java offers virtual threads for enhanced scalability, structured concurrency for simplified task management, and scoped values for safer thread-shared data as alternatives to thread-locals.
 
@@ -1650,4 +1650,4 @@ class BadScopedValueUsage {
         System.out.println("Processing data...");
     }
 }
-```
+```
diff --git a/.cursor/rules/126-java-logging.mdc b/.cursor/rules/126-java-logging.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Effective Java logging involves selecting a standard framework (SLF4J with Logback/Log4j2), using appropriate log levels (ERROR, WARN, INFO, DEBUG, TRACE), and adhering to core practices like parameterized logging, proper exception handling, and avoiding sensitive data exposure. Configuration should be environment-specific with clear output formats. Security is paramount: mask sensitive data, control log access, and ensure secure transmission. Implement centralized log aggregation, monitoring, and alerting for proactive issue detection. Finally, logging behavior and its impact should be validated through comprehensive testing.
 
@@ -1382,4 +1382,4 @@ public class UntestableLogging {
         // is difficult. Developers might skip testing logging, leading to unverified log output.
     }
 }
-```
+```
diff --git a/.cursor/rules/131-java-unit-testing.mdc b/.cursor/rules/131-java-unit-testing.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Effective Java unit testing involves using JUnit 5 annotations and AssertJ for fluent assertions. Tests should follow the Given-When-Then structure with descriptive names for clarity. Each test must have a single responsibility, be independent, and leverage parameterized tests for data variations. Mocking dependencies with frameworks like Mockito is crucial for isolating the unit under test. While code coverage is a useful guide, the focus should be on meaningful tests for critical logic and edge cases. Test classes and methods should typically be package-private. Strategies for code splitting include small test methods and helper functions. Anti-patterns like testing implementation details, hard-coded values, and ignoring failures should be avoided. Proper state management involves isolated state and immutable objects, and error handling should include testing for expected exceptions and their messages.
 
@@ -775,4 +775,4 @@ public class UserValidationPoorTest {
         assertThat(validator.isValidEmailFormat("test@example.com")).isTrue(); // No invalid formats, no nulls
     }
 }
-```
+```
diff --git a/.cursor/rules/141-java-refactoring-with-modern-features.mdc b/.cursor/rules/141-java-refactoring-with-modern-features.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Refactor Java code to use modern Java features (Java 8+) including lambda expressions, Stream API, Optional, java.time API, and other modern constructs for improved code readability, maintainability, and performance. Apply type design thinking principles to create clear, well-structured code that communicates intent effectively.
 
@@ -1120,4 +1120,4 @@ public class OldMultiLineStringExample {
         System.out.println("Mixed Style (potentially confusing indentation):\n" + mixedStyle);
     }
 }
-```
+```
diff --git a/.cursor/rules/142-java-functional-programming.mdc b/.cursor/rules/142-java-functional-programming.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Apply functional programming principles in Java development, emphasizing immutability, pure functions, and type safety through functional interfaces and modern Java features.
 
diff --git a/.cursor/rules/143-java-data-oriented-programming.mdc b/.cursor/rules/143-java-data-oriented-programming.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Java Data-Oriented Programming emphasizes separating code (behavior) from data structures, which should ideally be immutable (e.g., using records). Data manipulation should occur via pure functions that transform data into new instances. It's often beneficial to keep data structures flat and denormalized (using IDs for references) where appropriate, and to start with generic data representations (like `Map<String, Object>`) converting to specific types only when necessary. Data integrity is ensured through pure validation functions. Flexible, generic data access layers facilitate working with various data types and storage mechanisms. All data transformations should be explicit, traceable, and composed of clear, pure functional steps.
 
diff --git a/generator/src/main/resources/cursor-rules.xsl b/generator/src/main/resources/cursor-rules.xsl
@@ -115,7 +115,7 @@ Description: </xsl:text>        <xsl:value-of select="normalize-space(example-de
     <xsl:template match="goal">
         <xsl:text>
 
-## Instructions for AI
+## Goal
 
 </xsl:text>
         <xsl:call-template name="trim-goal-content">
diff --git a/generator/src/test/resources/100-java-checklist-guide.mdc b/generator/src/test/resources/100-java-checklist-guide.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java programming language and technical documentation
 
-## Instructions for AI
+## Goal
 
 Your task is to create a comprehensive step-by-step guide that follows the exact format and structure defined in the embedded template below.
 
diff --git a/generator/src/test/resources/110-java-maven-best-practices.mdc b/generator/src/test/resources/110-java-maven-best-practices.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Update the pom.xml based on the following rules about Maven best practices.
 
diff --git a/generator/src/test/resources/112-java-maven-documentation.mdc b/generator/src/test/resources/112-java-maven-documentation.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 When creating a README-DEV.md file for a Maven project, include ONLY the following sections with the specified Maven goals. Do NOT add any additional sections, explanations, or content beyond what is explicitly listed below.
 
diff --git a/generator/src/test/resources/121-java-object-oriented-design.mdc b/generator/src/test/resources/121-java-object-oriented-design.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Apply comprehensive guidelines for robust Java object-oriented design and refactoring. Follow core principles like SOLID, DRY, and YAGNI, implement best practices for class and interface design including favoring composition over inheritance and designing for immutability. Master encapsulation, inheritance, and polymorphism, and identify and refactor common object-oriented design code smells such as God Classes, Feature Envy, and Data Clumps to promote maintainable, flexible, and understandable code.
 
diff --git a/generator/src/test/resources/122-java-type-design.mdc b/generator/src/test/resources/122-java-type-design.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Type design thinking in Java applies typography principles to code structure and organization. Just as typography creates readable, accessible text, thoughtful type design in Java produces maintainable, comprehensible code.
 
diff --git a/generator/src/test/resources/123-java-general-guidelines.mdc b/generator/src/test/resources/123-java-general-guidelines.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 This document outlines general Java coding guidelines covering fundamental aspects such as naming conventions for packages, classes, methods, variables, and constants; code formatting rules including indentation, line length, brace style, and whitespace usage; standards for organizing import statements; best practices for Javadoc documentation; and comprehensive error and exception handling with a strong focus on security, including avoiding sensitive information exposure, catching specific exceptions, and secure resource management.
 
diff --git a/generator/src/test/resources/124-java-secure-coding.mdc b/generator/src/test/resources/124-java-secure-coding.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Apply secure coding practices to Java code to prevent common vulnerabilities and enhance application security.
 
diff --git a/generator/src/test/resources/125-java-concurrency.mdc b/generator/src/test/resources/125-java-concurrency.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Effective Java concurrency relies on understanding thread safety fundamentals, using `java.util.concurrent` utilities, and managing thread pools with `ExecutorService`. Key practices include implementing concurrent design patterns like Producer-Consumer, leveraging `CompletableFuture` for asynchronous tasks, and ensuring thread safety through immutability and safe publication. Performance aspects like lock contention and memory consistency must be considered. Thorough testing, including stress tests and thread dump analysis, is crucial. Modern Java offers virtual threads for enhanced scalability, structured concurrency for simplified task management, and scoped values for safer thread-shared data as alternatives to thread-locals.
 
@@ -1650,4 +1650,4 @@ class BadScopedValueUsage {
         System.out.println("Processing data...");
     }
 }
-```
+```
diff --git a/generator/src/test/resources/126-java-logging.mdc b/generator/src/test/resources/126-java-logging.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Effective Java logging involves selecting a standard framework (SLF4J with Logback/Log4j2), using appropriate log levels (ERROR, WARN, INFO, DEBUG, TRACE), and adhering to core practices like parameterized logging, proper exception handling, and avoiding sensitive data exposure. Configuration should be environment-specific with clear output formats. Security is paramount: mask sensitive data, control log access, and ensure secure transmission. Implement centralized log aggregation, monitoring, and alerting for proactive issue detection. Finally, logging behavior and its impact should be validated through comprehensive testing.
 
@@ -1382,4 +1382,4 @@ public class UntestableLogging {
         // is difficult. Developers might skip testing logging, leading to unverified log output.
     }
 }
-```
+```
diff --git a/generator/src/test/resources/131-java-unit-testing.mdc b/generator/src/test/resources/131-java-unit-testing.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Effective Java unit testing involves using JUnit 5 annotations and AssertJ for fluent assertions. Tests should follow the Given-When-Then structure with descriptive names for clarity. Each test must have a single responsibility, be independent, and leverage parameterized tests for data variations. Mocking dependencies with frameworks like Mockito is crucial for isolating the unit under test. While code coverage is a useful guide, the focus should be on meaningful tests for critical logic and edge cases. Test classes and methods should typically be package-private. Strategies for code splitting include small test methods and helper functions. Anti-patterns like testing implementation details, hard-coded values, and ignoring failures should be avoided. Proper state management involves isolated state and immutable objects, and error handling should include testing for expected exceptions and their messages.
 
@@ -775,4 +775,4 @@ public class UserValidationPoorTest {
         assertThat(validator.isValidEmailFormat("test@example.com")).isTrue(); // No invalid formats, no nulls
     }
 }
-```
+```
diff --git a/generator/src/test/resources/141-java-refactoring-with-modern-features.mdc b/generator/src/test/resources/141-java-refactoring-with-modern-features.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Refactor Java code to use modern Java features (Java 8+) including lambda expressions, Stream API, Optional, java.time API, and other modern constructs for improved code readability, maintainability, and performance. Apply type design thinking principles to create clear, well-structured code that communicates intent effectively.
 
@@ -1120,4 +1120,4 @@ public class OldMultiLineStringExample {
         System.out.println("Mixed Style (potentially confusing indentation):\n" + mixedStyle);
     }
 }
-```
+```
diff --git a/generator/src/test/resources/142-java-functional-programming.mdc b/generator/src/test/resources/142-java-functional-programming.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Apply functional programming principles in Java development, emphasizing immutability, pure functions, and type safety through functional interfaces and modern Java features.
 
diff --git a/generator/src/test/resources/143-java-data-oriented-programming.mdc b/generator/src/test/resources/143-java-data-oriented-programming.mdc
@@ -9,7 +9,7 @@ alwaysApply: false
 
 You are a Senior software engineer with extensive experience in Java software development
 
-## Instructions for AI
+## Goal
 
 Java Data-Oriented Programming emphasizes separating code (behavior) from data structures, which should ideally be immutable (e.g., using records). Data manipulation should occur via pure functions that transform data into new instances. It's often beneficial to keep data structures flat and denormalized (using IDs for references) where appropriate, and to start with generic data representations (like `Map<String, Object>`) converting to specific types only when necessary. Data integrity is ensured through pure validation functions. Flexible, generic data access layers facilitate working with various data types and storage mechanisms. All data transformations should be explicit, traceable, and composed of clear, pure functional steps.
 

Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ alwaysApply: false`
`9`	`9`
`10`	`10`	`You are a Senior software engineer with extensive experience in Java software development`
`11`	`11`
`12`		`-## Instructions for AI`
	`12`	`+## Goal`
`13`	`13`
`14`	`14`	Effective Java concurrency relies on understanding thread safety fundamentals, using `java.util.concurrent` utilities, and managing thread pools with `ExecutorService`. Key practices include implementing concurrent design patterns like Producer-Consumer, leveraging `CompletableFuture` for asynchronous tasks, and ensuring thread safety through immutability and safe publication. Performance aspects like lock contention and memory consistency must be considered. Thorough testing, including stress tests and thread dump analysis, is crucial. Modern Java offers virtual threads for enhanced scalability, structured concurrency for simplified task management, and scoped values for safer thread-shared data as alternatives to thread-locals.
`15`	`15`
`@@ -1650,4 +1650,4 @@ class BadScopedValueUsage {`
`1650`	`1650`	`System.out.println("Processing data...");`
`1651`	`1651`	`}`
`1652`	`1652`	`}`
`1653`		-```
	`1653`	+```