chore(release): finalize 0.16.0

CHANGELOG.md

@@ -5,6 +5,55 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.16.0] 2026-06-22
+
+### Added
+
+- **Skills**:
+  - Command inventory and installation workflows for embedded project commands and agents (`@001-commands-inventory`, `@004-commands-installation`, `@005-agents-installation`) (#790, #791)
+  - Architecture design exploration and expanded diagram support, including bounded-context and deployment diagram generation (`@034-architecture-design-exploration`, `@033-architecture-diagrams`) (#819, #820, #822, #852)
+  - Java design patterns, Gatling performance testing, Spring Modulith, and SDKMAN project starter skills for Spring Boot, Quarkus, and Micronaut (`@123-java-design-patterns`, `@152-java-performance-gatling`, `@305-frameworks-spring-boot-modulith`, `@300-frameworks-spring-boot-create-project`, `@400-frameworks-quarkus-create-project`, `@500-frameworks-micronaut-create-project`) (#762, #763, #764, #781)
+  - Mongock migration skills for Spring Boot, Quarkus, and Micronaut (`@316-frameworks-spring-mongodb-migrations-mongock`, `@416-frameworks-quarkus-mongodb-migrations-mongock`, `@516-frameworks-micronaut-mongodb-migrations-mongock`) (#761)
+  - Technology guidance for SQL, MongoDB/NoSQL modeling, and Docker containers (`@704-technologies-sql`, `@705-technologies-nosql-mongodb`, `@706-technologies-containers-docker`) (#773, #776, #778, #838)
+  - Regulation engineering review skills for the EU AI Act, DORA, GDPR, EU NIS2, Cyber Resilience Act, EU Data Act, Digital Services Act, Digital Markets Act, and Digital Omnibus (`@801`-`@809`) (#830, #853, #862, #864, #865, #866, #867, #868)
+
+- **Agents & commands**:
+  - Tech Lead, Java Performance, and default non-Java agents, plus updated architect, business analyst, and framework coder responsibilities (#807, #815)
+  - Embedded command suite for ADRs, diagrams, plans, specs, feature branches, issues, worktrees, design exploration, issue implementation, profiling, benchmarking, and alignment review (#790, #814)
+
+- **Examples**:
+  - Kafka, MongoDB, and PostgreSQL Sakila infrastructure examples (#845, #849)
+  - Maven multi-module acceptance fixture and deployment diagram examples (#850, #852)
+
+- **CI & validation**:
+  - Snyk agent scan validation in the Maven workflow (#841)
+  - Skill acceptance prompt inventory for changed generated skills
+
+### Changed
+
+- **PML & generators**:
+  - Separated local skill generation from release publishing and added runtime resource packaging (#777, #803)
+  - Added command index generation and tests alongside the existing skill index workflow (#790, #791)
+  - Split large skill references into modular files for architecture diagrams, Maven dependencies, Maven plugins, and object-oriented design (#784, #786, #802, #819)
+  - Aligned skill versions and refreshed generated local output for the 0.16.0 cycle (#782)
+
+- **Agents**:
+  - Reworked command routing around specialized agents and replaced coordinator-centered delegation with Tech Lead, Java, framework, performance, and non-Java agent flows (#807, #814, #815, #834)
+
+- **Documentation & website**:
+  - Added five-minute getting-started guidance, skill portal links, validation guidance, project references, and focused README navigation (#833, #835, #836, #851)
+  - Moved workflow documentation into guides and normalized Chinese documentation suffixes from `_CN` to `_ZH` (#797, #798)
+  - Published and generated the 0.15.0 release article and supporting site assets (#752)
+  - Clarified project limitations and human PR policy (#799, #842)
+
+### Removed
+
+- **Agents & commands**:
+  - Removed the legacy `robot-coordinator` agent and replaced the narrow `kill-port-8820` command with a generic `kill-port` command (#807, #790)
+
+- **Documentation**:
+  - Removed `README_CN.md` after migrating Chinese documentation to `README_ZH.md` (#797)
+
 ## [0.15.0] 2026-06-01
 
 ### Added

documentation/MAINTENANCE.md

@@ -8,7 +8,7 @@ Some **User prompts** designed to help in the maintenance of this repository.
 
 ```bash
 # Maven command to update the maven version to next minor version
-./mvnw versions:set -DnewVersion=0.16.0-SNAPSHOT
+./mvnw versions:set -DnewVersion=0.16.0
 ./mvnw versions:commit
 
 #Bump to a new snapshot
@@ -28,20 +28,19 @@ Can you analyze the last Java version, Java 26 from @All-JEPS.md if exist some J
 Review that the list doesn´t any broken link to @/.cursor with .md files
 
 # Prompt to provide a release changelog
-Can you update the current changelog for 0.15.0 comparing git commits in relation to 0.14.0 tag. Use  @https://keepachangelog.com/en/1.1.0/  rules
+Can you update the current changelog for 0.16.0 comparing git commits in relation to 0.15.0 tag. Use  @https://keepachangelog.com/en/1.1.0/  rules
 
 #Bump to a new snapshot
-@resources/ update version to 0.15.0-SNAPSHOT and pom.xml, maven modules and finally regenerate local skills with ./mvnw clean install -pl skills-generator
+@resources/ update version to 0.16.0 and pom.xml, maven modules and finally regenerate local skills with ./mvnw clean install -pl skills-generator
 
-@skills-generator/src/main/resources/skill-references/assets/agents/robot-java-coder.md @skills-generator/src/main/resources/skill-references/assets/agents/robot-java-micronaut-coder.md @skills-generator/src/main/resources/skill-references/assets/agents/robot-java-quarkus-coder.md @skills-generator/src/main/resources/skill-references/assets/agents/robot-java-spring-boot-coder.md review @CHANGELOG.md if it is possible to add new capabilities added in this release
 ```
 
 ## Release process
 
 - [ ] Update CHANGELOG.md
 - [ ] Remove SNAPSHOT from .xml, .md & pom.xml
 - [ ] Last review in docs (Manual)
-- [ ] Review git changes for hidden issues (Manual) https://github.com/jabrena/cursor-rules-java/compare/0.12.0...feature/release-0130
+- [ ] Review git changes for hidden issues (Manual) https://github.com/jabrena/cursor-rules-java/compare/0.15.0...feature/release-0160
 - [ ] Verify if all features were tested propertly
 - [ ] Review if Agents need to add more Skills
 - [ ] Review Skill validation output
@@ -84,7 +83,7 @@ Update @pom.xml with the new version 0.15.0-SNAPSHOT Regenerate local skills wit
 
 ## Tagging process
 git tag --list
-git tag 0.15.0
+git tag 0.16.0
 git push --tags
 ```
 
@@ -99,5 +98,5 @@ review if exist a new id in @skills-generator/src/main/resources/skills.xml to r
 ## Improve skills
 
 ```
-solving the problem with the skill, did you learn something that it didn´t work as expected or something to improve in the skill? 
+solving the problem with the skill, did you learn something that it didn´t work as expected or something to improve in the skill?
 ```

documentation/guides/PROJECT-REFERENCES.md

@@ -47,6 +47,7 @@ This page collects talks, articles, reference links, skill portals, and related
 
 - [AGENTS.md](https://agents.md/)
 - [Agent Skills](https://agentskills.io/home)
+- [AAIF](https://aaif.io/)
 - [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)
 - [OpenSpec](https://openspec.dev/)
 

documentation/guides/PROJECT-REFERENCES_ES.md

@@ -47,6 +47,7 @@ Esta página reúne charlas, artículos, enlaces de referencia, portales de skil
 
 - [AGENTS.md](https://agents.md/)
 - [Agent Skills](https://agentskills.io/home)
+- [AAIF](https://aaif.io/)
 - [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)
 - [OpenSpec](https://openspec.dev/)
 

documentation/guides/PROJECT-REFERENCES_ZH.md

@@ -47,6 +47,7 @@
 
 - [AGENTS.md](https://agents.md/)
 - [Agent Skills](https://agentskills.io/home)
+- [AAIF](https://aaif.io/)
 - [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)
 - [OpenSpec](https://openspec.dev/)
 

examples/skills/installers/.gitkeep

@@ -0,0 +1 @@
+

examples/skills/inventory/.gitkeep

@@ -0,0 +1 @@
+

pom.xml

@@ -7,7 +7,7 @@
 
     <groupId>info.jab</groupId>
     <artifactId>cursor-rules-java</artifactId>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <packaging>pom</packaging>
     <name>cursor-rules-java</name>
     <description>A curated collection of Skills and Agents to be used in modern SDLC workflows for Java Enterprise development.</description>

site-generator/pom.xml

@@ -8,7 +8,7 @@
     <parent>
         <groupId>info.jab</groupId>
         <artifactId>cursor-rules-java</artifactId>
-        <version>0.16.0-SNAPSHOT</version>
+        <version>0.16.0</version>
     </parent>
 
     <artifactId>cursor-rules-java-site</artifactId>

skills-generator/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>info.jab</groupId>
         <artifactId>cursor-rules-java</artifactId>
-        <version>0.16.0-SNAPSHOT</version>
+        <version>0.16.0</version>
     </parent>
 
     <groupId>info.jab.pml</groupId>

skills-generator/src/main/resources/skill-indexes/001-skill.xml

@@ -4,7 +4,7 @@
       id="001-commands-inventory">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Use when you need to generate a checklist document with embedded commands inventory, following the embedded template exactly and producing INVENTORY-COMMANDS-JAVA.md in the project root. This should trigger for requests such as Create embedded commands inventory checklist; Generate INVENTORY-COMMANDS-JAVA.md; Use @001-commands-inventory.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/002-skill.xml

@@ -4,7 +4,7 @@
       id="002-agents-inventory">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Use when you need to generate a checklist document with embedded agents inventory, following the embedded template exactly and producing INVENTORY-AGENTS-JAVA.md in the project root. This should trigger for requests such as Create embedded agents inventory checklist; Generate INVENTORY-AGENTS-JAVA.md; Use @002-agents-inventory.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/003-skill.xml

@@ -4,28 +4,30 @@
       id="003-skills-inventory">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
-    <description>Use when you need to generate a checklist document with Java system prompts, following the embedded template exactly and producing INVENTORY-SKILLS-JAVA.md in the project root. This should trigger for requests such as Create Java system prompts checklist; Generate INVENTORY-SKILLS-JAVA.md; Use @003-skills-inventory.</description>
+    <description>Use when you need to generate a checklist document with Java system prompts from skills.xml, following the embedded section template and producing INVENTORY-SKILLS-JAVA.md. This should trigger for requests such as Create Java system prompts checklist; Generate INVENTORY-SKILLS-JAVA.md; Use @003-skills-inventory.</description>
   </metadata>
 
   <title>Create a Checklist with all Java steps to use with system prompts for Java</title>
   <goal><![CDATA[
-Create a comprehensive step-by-step checklist document for Java system prompts by following the embedded template exactly.
+Create a comprehensive step-by-step checklist document for Java system prompts by following the embedded section template and deriving rows from `skills-generator/src/main/resources/skills.xml`.
 
 **What is covered in this Skill?**
 
-- Exact-template checklist generation
+- Inventory-driven checklist generation
 - Output file creation as `INVENTORY-SKILLS-JAVA.md`
-- Strict adherence to listed steps and cursor rules
+- Strict coverage of every effective skill id declared in `skills.xml`
 ]]></goal>
 
   <constraints>
-    <constraints-description>Follow the template exactly without adding or removing steps, sections, or rules.</constraints-description>
+    <constraints-description>Follow the template sections exactly and use `skills.xml` as the single source of truth for skill rows.</constraints-description>
     <constraint-list>
-      <constraint>**DO NOT** create additional steps beyond what the template defines</constraint>
-      <constraint>**DO NOT** add cursor rules not explicitly listed in the template</constraint>
-      <constraint>**ONLY** use exact wording and structure from the embedded template</constraint>
+      <constraint>**DO NOT** create additional sections beyond what the template defines</constraint>
+      <constraint>**DO NOT** add skill rows absent from `skills.xml`</constraint>
+      <constraint>**DO NOT** omit any skill declared in `skills.xml`</constraint>
+      <constraint>**ONLY** use the `skillId` attribute as the generated skill id when it exists</constraint>
+      <constraint>**ONLY** use the single `reference-list/reference` value as the generated skill id when `skillId` is absent</constraint>
       <constraint>**EDGE CASE**: If the user goal is ambiguous, stop and ask a clarifying question before editing files or running project-wide commands</constraint>
       <constraint>**EDGE CASE**: If required context, files, credentials, or tools are missing, report the blocker explicitly and ask whether to proceed with setup or fallback guidance</constraint>
       <constraint>**EDGE CASE**: If requested changes conflict with project constraints or safety boundaries, explain the conflict and ask for user confirmation on the preferred trade-off</constraint>
@@ -42,22 +44,23 @@ Create a comprehensive step-by-step checklist document for Java system prompts b
 
   <steps>
     <step number="1">
-      <step-title>Read the embedded template</step-title>
-      <step-content>Read `references/003-skills-inventory.md` before generating output and use it as the single source of truth.</step-content>
+      <step-title>Read the template and inventory source</step-title>
+      <step-content>Read `references/003-skills-inventory.md` and `skills-generator/src/main/resources/skills.xml` before generating output.</step-content>
       <step-constraints>
         <step-constraint-list>
           <step-constraint>Do not use cached or remembered template content</step-constraint>
-          <step-constraint>Preserve exact section and checklist structure from the reference</step-constraint>
+          <step-constraint>Preserve exact section structure from the reference</step-constraint>
+          <step-constraint>Use `skillId` when present; otherwise use the single reference name</step-constraint>
         </step-constraint-list>
       </step-constraints>
     </step>
     <step number="2">
       <step-title>Generate inventory document</step-title>
-      <step-content>Create `INVENTORY-SKILLS-JAVA.md` in the project root using the exact wording and order from the reference template.</step-content>
+      <step-content>Create `INVENTORY-SKILLS-JAVA.md` at the requested output path, or in the project root when no explicit path is requested, with one row for every effective skill id declared in `skills.xml`.</step-content>
     </step>
     <step number="3">
-      <step-title>Validate template fidelity</step-title>
-      <step-content>Verify that no extra steps or rules were added, and that all expected sections from the reference are present in the generated file.</step-content>
+      <step-title>Validate inventory coverage</step-title>
+      <step-content>Verify that the generated file contains every effective skill id from `skills.xml`, contains no extra skill rows, and preserves all expected sections from the reference.</step-content>
     </step>
   </steps>
 </prompt>

skills-generator/src/main/resources/skill-indexes/004-skill.xml

@@ -5,7 +5,7 @@
       interactive="true">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Use when you need to install the embedded project commands into command directories (.github/commands, .claude/commands, .cursor/command, .codex/commands), selecting the destination interactively and copying the embedded command definitions from project assets. This should trigger for requests such as Install embedded commands; Bootstrap .cursor/command; Bootstrap .claude/commands; Copy project commands; Install project command suite.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/005-skill.xml

@@ -5,7 +5,7 @@
       interactive="true">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Use when you need to install the embedded robot agents into either .cursor/agents or .claude/agents, selecting the destination interactively and copying the embedded agent definitions from project assets. This should trigger for requests such as Install embedded agents; Bootstrap .cursor/agents; Bootstrap .claude/agents; Copy robot agents.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/012-skill.xml

@@ -5,7 +5,7 @@
       interactive="true">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Guides the creation of agile epics with comprehensive definition including business value, success criteria, and breakdown into user stories. Use when the user wants to create an agile epic, define large bodies of work, break down features into user stories, or document strategic initiatives. This should trigger for requests such as Create an agile epic; Write an epic; I need to create an epic; Define an epic; Epic definition.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/013-skill.xml

@@ -5,7 +5,7 @@
       interactive="true">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Guides the creation of detailed agile feature documentation from an existing epic. Use when the user wants to split an epic into feature files, derive features with scope and acceptance criteria, or plan feature documentation for stakeholders or engineering. This should trigger for requests such as Create features from an epic; Split epic into features; Feature files from epic; Derive features from epic.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/014-skill.xml

@@ -5,7 +5,7 @@
       interactive="true">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Guides the creation of agile user stories and Gherkin feature files. Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files. This should trigger for requests such as Create a user story; Write a user story; I need to write a user story.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/030-skill.xml

@@ -5,7 +5,7 @@
       interactive="true">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Use when you need to generate Architecture Decision Records (ADRs) for a Java project through an interactive, conversational process that systematically gathers context, stakeholders, options, and outcomes to produce well-structured ADR documents. This should trigger for requests such as Generate ADR; Create Architecture Decision Record; Document architecture decision; Architecture Decision Record for Java.</description>
   </metadata>

skills-generator/src/main/resources/skill-indexes/031-skill.xml

@@ -5,7 +5,7 @@
       interactive="true">
   <metadata>
     <author>Juan Antonio Breña Moral</author>
-    <version>0.16.0-SNAPSHOT</version>
+    <version>0.16.0</version>
     <license>Apache-2.0</license>
     <description>Facilitates conversational discovery to create Architectural Decision Records (ADRs) for functional requirements covering CLI, REST/HTTP APIs, or both. Use when the user wants to document command-line or HTTP service architecture, capture functional requirements, create ADRs for CLI or API projects, or design interfaces with documented decisions. This should trigger for requests such as Create ADR for functional requirements; Document functional requirements; Capture functional requirements; Generate functional requirements in an ADR.</description>
   </metadata>