fix: address Quarkus PR review blockers

skills/java-coding-standards/SKILL.md

@@ -8,15 +8,7 @@ origin: ECC
 
 Standards for readable, maintainable Java (17+) code in Spring Boot and Quarkus services.
 
-## Framework Detection
-
-Before applying standards, determine the framework from the build file:
-
-- Build file contains `quarkus` → apply **[QUARKUS]** conventions
-- Build file contains `spring-boot` → apply **[SPRING]** conventions
-- Neither detected → apply shared conventions only
-
-## When to Activate
+## When to Use
 
 - Writing or reviewing Java code in Spring Boot or Quarkus projects
 - Enforcing naming, immutability, or exception handling conventions
@@ -25,6 +17,16 @@ Before applying standards, determine the framework from the build file:
 - Structuring packages and project layout
 - **[QUARKUS]**: Working with CDI scopes, Panache entities, or reactive pipelines
 
+## How It Works
+
+### Framework Detection
+
+Before applying standards, determine the framework from the build file:
+
+- Build file contains `quarkus` → apply **[QUARKUS]** conventions
+- Build file contains `spring-boot` → apply **[SPRING]** conventions
+- Neither detected → apply shared conventions only
+
 ## Core Principles
 
 - Prefer clarity over cleverness
@@ -33,6 +35,12 @@ Before applying standards, determine the framework from the build file:
 - Consistent naming and package structure
 - **[QUARKUS]**: Favor build-time over runtime processing; avoid runtime reflection where possible
 
+## Examples
+
+The sections below show concrete Spring Boot, Quarkus, and shared Java examples
+for naming, immutability, dependency injection, reactive code, exceptions,
+project layout, logging, configuration, and tests.
+
 ## Naming
 
 ```java