Skip to content

docs(documentation): expand MAINTENANCE skill registry checklist #651

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jabrena merged 4 commits into from
Apr 10, 2026
Merged

docs(documentation): expand MAINTENANCE skill registry checklist #651

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
05956d7
docs(documentation): expand MAINTENANCE skill registry checklist
jabrena Apr 9, 2026
701dd35
fix(docs): Improving the file generated about Inventory
jabrena Apr 10, 2026
c9211d0
fix(docs): refresh Java skills inventory and references
jabrena Apr 10, 2026
2e3e3bc
fix(docs): correct inventory artifact names in changelog
jabrena Apr 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Added

- **Skills**:
- `@001-skills-inventory` checklist skill that emits `SKILLS-JAVA.md` in the project root using the embedded system-prompts template
- `@002-agents-inventory` checklist skill that emits `AGENTS-JAVA.md` with the embedded agents table and installation targets
- `@001-skills-inventory` checklist skill that emits `INVENTORY-SKILLS-JAVA.md` in the project root using the embedded system-prompts template
- `@002-agents-inventory` checklist skill that emits `INVENTORY-AGENTS-JAVA.md` with the embedded agents table and installation targets
- `@003-agents-installation` interactive installer that copies the six embedded robot agents into `.cursor/agents` or `.claude/agents`
- Add INVEST validation to agile user-story workflow in `@014-agile-user-story` (#633)
- Maven Central search guidance skill (`@114-java-maven-search`) (#605)
Expand Down
29 changes: 9 additions & 20 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,23 +22,16 @@ A curated collection of `Skills` and `Agents` for Java Enterprise development, d
The project generates a set of deliverables at the end of any iteration.


| Deliverable | Location |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| Skills for Java | [https://skills.sh/jabrena/cursor-rules-java](https://skills.sh/jabrena/cursor-rules-java) |
| Agents for Java | [Catalog](.cursor/agents) (`.cursor/agents`) |
| Deliverable | Instalation | Getting Started |
| --------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| 1. [Skills for Java](./documentation/INVENTORY-SKILLS-JAVA.md) | `npx skills add jabrena/cursor-rules-java --all --agent cursor` | [`Skills for Java`](./documentation/GETTING-STARTED-SKILLS.md) |
| 2. [Agents for Java](./documentation/INVENTORY-AGENTS-JAVA.md) | `@003-agents-installation` Install Agents in Cursor | [`Agents for Java`](./documentation/GETTING-STARTED-AGENTS.md) |

**Note:** Once you install all skills, you could install the agents easily for Cursor or Claude.

### Compatibility

This project is compatible with any Tool compatible with `Skills`, `Agents` or `AGENTS.md`.

## Getting started

Read the following comprehensive guides to use this project today.

- [Getting started with `Skills for Java`](./documentation/GETTING-STARTED-SKILLS.md)
- [Getting started with `Agents for Java`](./documentation/GETTING-STARTED-AGENTS.md)
- [Getting started with `CI/CD Pipelines and AI Capabilities`](./documentation/GETTING-STARTED-PIPELINES.md)
This project is compatible with any Tool compatible with `Skills`, `Agents`, `AGENTS.md` & `MCP` Servers.

## How to use them?

Expand All @@ -62,6 +55,8 @@ Adding AI tools to your pipeline can provide new opportunities to deliver more v

![](./documentation/images/workflow-pipelines.png)

Futher information [here`](./documentation/GETTING-STARTED-PIPELINES.md)

## Limitations

### Lack of determinism
Expand All @@ -86,13 +81,7 @@ The repository includes [a collection of examples](./examples/) where you can ex

## Architectural decision records, ADR

| Date | ID | Name |
| ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| 2026-04-06 | ADR-005 | [Drop Cursor rules support in favor of Agent Skills](./documentation/adr/ADR-005-drop-cursor-rules-support-in-favor-of-agent-skills.md) |
| 2026-03-01 | ADR-004 | [Skill Generation](./documentation/adr/ADR-004-skill-generation.md) |
| 2025-09-16 | ADR-003 | [Website Generation](./documentation/adr/ADR-003-website-generation.md) |
| 2025-07-10 | ADR-002 | [Cursor Rules scope configuration](./documentation/adr/ADR-002-configure-cursor-rules-manual-scope.md) |
| 2025-07-08 | ADR-001 | [Cursor Rules generation from XML Files](./documentation/adr/ADR-001-generate-cursor-rules-from-xml-files.md) |
- Review the [ADR index](./documentation/adr/README.md) for the complete list.

## Changelog

Expand Down
Loading