Skip to content

Commit 81b047f

Browse files
authored
docs(release): prepare 0.14.0 changelog updates (#650)
* docs(release): prepare 0.14.0 changelog updates Capture 0.14.0 release notes from commits since 0.13.0 and align maintenance guidance with the new release workflow. Made-with: Cursor * chore(release): set version 0.14.0 and regenerate skills Made-with: Cursor * feat(skills): add inventory skills and AGENTS-JAVA.md output Made-with: Cursor * refactor(skills-generator): migrate inventory files from JSON to XML Made-with: Cursor
1 parent 7705c79 commit 81b047f

296 files changed

Lines changed: 988 additions & 533 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

AGENTS-JAVA.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Embedded Agents Inventory
2+
3+
## Goal
4+
5+
Provide a quick checklist of the embedded agents available for installation in this repository.
6+
7+
## Embedded agents
8+
9+
| Agent | Primary purpose |
10+
| --- | --- |
11+
| `robot-business-analyst` | Analyze requirements, user stories, and implementation plans. |
12+
| `robot-coordinator` | Coordinate Java enterprise implementation flow across specialized coders. |
13+
| `robot-java-coder` | Implement framework-agnostic Java changes and refactors. |
14+
| `robot-micronaut-coder` | Implement Micronaut-specific code and architecture changes. |
15+
| `robot-quarkus-coder` | Implement Quarkus-specific code and architecture changes. |
16+
| `robot-spring-boot-coder` | Implement Spring Boot-specific code and architecture changes. |
17+
18+
## Installation target options
19+
20+
- `.cursor/agents`
21+
- `.claude/agents`

CHANGELOG.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.14.0] 2026-04-12
9+
10+
### Added
11+
12+
- **Skills**:
13+
- `@001-skills-inventory` checklist skill that emits `SKILLS-JAVA.md` in the project root using the embedded system-prompts template
14+
- `@002-agents-inventory` checklist skill that emits `AGENTS-JAVA.md` with the embedded agents table and installation targets
15+
- `@003-agents-installation` interactive installer that copies the six embedded robot agents into `.cursor/agents` or `.claude/agents`
16+
- Add INVEST validation to agile user-story workflow in `@014-agile-user-story` (#633)
17+
- Maven Central search guidance skill (`@114-java-maven-search`) (#605)
18+
- OpenSpec adoption for project change management in `@042-planning-openspec` (#620, #621, #616)
19+
- GitHub issue management workflow support`@043-planning-github` (#607)
20+
- Jira planning support and guidance improvements in `@044-planning-jira` (#631, #641, #642)
21+
- OpenAPI guidance skill `@701-technologies-openapi` (#635)
22+
- WireMock guidance skill `@702-technologies-wiremock` (#636)
23+
- Fuzz testing skill `@703-technologies-fuzzing-testing` and CATS example coverage (#634, #646)
24+
- Cursor and Claude plugin support documentation/workflow (#622)
25+
26+
- **Rules:**
27+
- Created an ADR to drop support for Rules in favor of Skills.
28+
29+
- **Examples:**
30+
- Reduce CI Pipeline times, removing non essential examples
31+
832
## [0.13.0] 2026-03-30
933

1034
### Added
@@ -326,6 +350,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
326350

327351
- Added initial cursor rules (Java, Effective Java, Concurrency, Functional programming, Data-Oriented programming & Spring Boot)
328352

353+
[0.14.0]: https://github.com/jabrena/cursor-rules-java/compare/0.13.0...0.14.0
329354
[0.13.0]: https://github.com/jabrena/cursor-rules-java/compare/0.12.0...0.13.0
330355
[0.12.0]: https://github.com/jabrena/cursor-rules-java/compare/0.11.0...0.12.0
331356
[0.11.0]: https://github.com/jabrena/cursor-rules-java/compare/0.10.0...0.11.0

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Read [AGENTS.md](./AGENTS.md) for the full contributor guide (tech stack, bounda
1212
The unified `skills-generator` module holds all XML sources and Java code used to build **agent skills** under `skills/`.
1313

1414
- [System prompt XML files](./skills-generator/src/main/resources/system-prompts/) use the PML Schema ([pml.xsd](https://jabrena.github.io/pml/schemas/0.5.0/pml.xsd)). They are transformed with [CursorRulesGenerator.java](./skills-generator/src/main/java/info/jab/pml/CursorRulesGenerator.java) and [system-prompts.xsl](./skills-generator/src/main/resources/system-prompts.xsl) when producing reference content for skills.
15-
- [Skill summaries and inventory](./skills-generator/src/main/resources/) (`skills/`, `skill-inventory.json`) drive `SKILL.md` generation.
15+
- [Skill summaries and inventory](./skills-generator/src/main/resources/) (`skills/`, `skill-inventory.xml`) drive `SKILL.md` generation.
1616

1717
If you have the idea to contribute, review the whole process in detail:
1818

@@ -22,7 +22,7 @@ If you have the idea to contribute, review the whole process in detail:
2222
npx skill-check skills # Validate generated skills
2323
```
2424

25-
Keep `skill-inventory.json` aligned with `skills/` and `system-prompts/` when adding or changing skills.
25+
Keep `skill-inventory.xml` aligned with `skills/` and `system-prompts/` when adding or changing skills.
2626

2727
When you feel confident with the process, fork the repository and try to create new XML documents. Models will help you because an XML file is more rigid than natural language and it has `a common vocabulary` to create prompts.
2828

SKILLS-JAVA.md

Lines changed: 147 additions & 0 deletions
Large diffs are not rendered by default.

documentation/MAINTENANCE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,10 @@ Can you analyze the last Java version, Java 26 from @All-JEPS.md if exist some J
1313
Review that the list doesn´t any broken link to @/.cursor with .md files
1414

1515
# Prompt to provide a release changelog
16-
Can you update the current changelog for 0.13.0 comparing git commits in relation to 0.12.0 tag. Use @https://keepachangelog.com/en/1.1.0/ rules
16+
Can you update the current changelog for 0.14.0 comparing git commits in relation to 0.13.0 tag. Use @https://keepachangelog.com/en/1.1.0/ rules
1717

1818
#Bump to a new snapshot
19-
@resources/ update version to 0.13.0 and pom.xml and maven modules
19+
@resources/ update version to 0.14.0 and pom.xml, maven modules and finally regenerate the skills
2020
```
2121
2222
## Release process
@@ -64,5 +64,5 @@ git push --tags
6464
## Add a new Skills
6565
6666
```bash
67-
review if exist a new id in @skills-generator/src/main/resources/skill-inventory.json to review compare with the content of @skills-generator/src/main/resources/skills and if exist add a new skill summary in @skills-generator/src/main/resources/skills . to elaborate the skill review the content of the id with @skills-generator/src/main/resources/system-prompts when finish, validate generation with ./mvnw clean install -pl skills-generator and validate the skill with npx skill-check skills
67+
review if exist a new id in @skills-generator/src/main/resources/skill-inventory.xml to review compare with the content of @skills-generator/src/main/resources/skills and if exist add a new skill summary in @skills-generator/src/main/resources/skills . to elaborate the skill review the content of the id with @skills-generator/src/main/resources/system-prompts when finish, validate generation with ./mvnw clean install -pl skills-generator and validate the skill with npx skill-check skills
6868
```

documentation/openspec/specs/technologies-openapi/spec.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ The new skill SHALL complement, not duplicate, framework REST skills: framework
4040

4141
### Requirement: Generator Integration
4242

43-
New sources for **701** MUST be registered in both `skill-inventory.json` and `system-prompt-inventory.json`, and the `skills-generator` module MUST build successfully after the change.
43+
New sources for **701** MUST be registered in both `skill-inventory.xml` and `system-prompt-inventory.xml`, and the `skills-generator` module MUST build successfully after the change.
4444

4545
#### Scenario: Maven verify passes
4646

documentation/openspec/specs/technologies-wiremock/spec.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ The new skill SHALL complement, not replace, framework integration-test skills:
4040

4141
### Requirement: Generator Integration
4242

43-
New sources for **702** MUST be registered in both `skill-inventory.json` and `system-prompt-inventory.json`, and the `skills-generator` module MUST build successfully after the change.
43+
New sources for **702** MUST be registered in both `skill-inventory.xml` and `system-prompt-inventory.xml`, and the `skills-generator` module MUST build successfully after the change.
4444

4545
#### Scenario: Maven verify passes
4646

pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
<groupId>info.jab</groupId>
99
<artifactId>cursor-rules-java</artifactId>
10-
<version>0.14.0-SNAPSHOT</version>
10+
<version>0.14.0</version>
1111
<packaging>pom</packaging>
1212
<name>cursor-rules-java</name>
1313
<description>The project provides a curated collection of System prompts and Skills for modern

site-generator/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
<parent>
99
<groupId>info.jab</groupId>
1010
<artifactId>cursor-rules-java</artifactId>
11-
<version>0.14.0-SNAPSHOT</version>
11+
<version>0.14.0</version>
1212
</parent>
1313

1414
<artifactId>cursor-rules-java-site</artifactId>

skills-generator/pom.xml

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,20 +7,14 @@
77
<parent>
88
<groupId>info.jab</groupId>
99
<artifactId>cursor-rules-java</artifactId>
10-
<version>0.14.0-SNAPSHOT</version>
10+
<version>0.14.0</version>
1111
</parent>
1212

1313
<groupId>info.jab.pml</groupId>
1414
<artifactId>cursor-rules-java-skills-generator</artifactId>
1515
<packaging>jar</packaging>
1616

1717
<dependencies>
18-
<!-- JSON parsing for skill-inventory.json -->
19-
<dependency>
20-
<groupId>com.fasterxml.jackson.core</groupId>
21-
<artifactId>jackson-databind</artifactId>
22-
</dependency>
23-
2418
<!-- Logging dependencies -->
2519
<dependency>
2620
<groupId>org.slf4j</groupId>
@@ -77,11 +71,11 @@
7771
<resource>
7872
<directory>${project.basedir}/src/main/resources</directory>
7973
<includes>
80-
<include>skill-inventory.json</include>
74+
<include>skill-inventory.xml</include>
8175
<include>skills/**</include>
8276
<include>system-prompts/**</include>
8377
<include>system-prompts.xsl</include>
84-
<include>system-prompt-inventory.json</include>
78+
<include>system-prompt-inventory.xml</include>
8579
</includes>
8680
</resource>
8781
</resources>

0 commit comments

Comments
 (0)