Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

<groupId>info.jab</groupId>
<artifactId>cursor-rules-java</artifactId>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
2 changes: 1 addition & 1 deletion site-generator/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
<parent>
<groupId>info.jab</groupId>
<artifactId>cursor-rules-java</artifactId>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<relativePath>../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion skills-generator/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<parent>
<groupId>info.jab</groupId>
<artifactId>cursor-rules-java</artifactId>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<relativePath>../pom.xml</relativePath>
</parent>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="001-commands-inventory">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="002-agents-inventory">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="003-skills-inventory">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</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>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Facilitates conversational discovery to create Architectural Decision Records (ADRs) for non-functional requirements using the ISO/IEC 25010:2023 quality model. Use when the user wants to document quality attributes, NFR decisions, security/performance/scalability architecture, or design systems with measurable quality criteria. This should trigger for requests such as Create ADR for Non-functional requirements; Document Non-functional requirements; Capture Non-functional requirements; Generate Non-functional requirements in an ADR.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to generate Java project diagrams — including UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, UML Deployment Diagrams, ER (Entity Relationship) diagrams, and bounded-context diagrams — through a modular, step-based interactive process that adapts to your specific visualization needs. This should trigger for requests such as Generate UML diagram; Create sequence diagram; Create class diagram; Create state machine diagram; Create deployment diagram; Create C4 diagram; Create bounded-context diagram; Create context-map diagram.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when a sanitized issue summary, requirement summary, or design brief needs technical design exploration before creating ADRs, specifications, or implementation plans. This skill inspects repository context, clarifies material ambiguity, compares feasible approaches and trade-offs, recommends a direction, obtains approval, and identifies ADR candidates. This should trigger for requests such as Explore a design; Compare implementation approaches; Recommend an architecture direction; Clarify technical options before planning.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when creating or refining a structured Java implementation plan from trusted issue summaries, approved designs, ADRs, OpenSpec changes, existing plans, or a valid combination. The plan records its source artifacts and derivation direction and can remain the execution artifact without requiring OpenSpec. This should trigger for requests such as Create a plan from an issue; Create a plan from OpenSpec; Design an implementation plan; Refine an existing plan.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when creating or updating OpenSpec change artifacts from an issue, implementation plan, approved design, ADRs, existing OpenSpec artifacts, or a valid combination. The workflow assesses whether the scope is one change or multiple changes, records sources and derivation direction, and prevents silent synchronization. This should trigger for requests such as Create an OpenSpec change from an issue; Convert a plan into OpenSpec; Update an existing OpenSpec change; Split broad requirements into reviewable OpenSpec changes.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="043-planning-github-issues">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need GitHub CLI (`gh`) installation/authentication guidance and a sanitized GitHub issue inventory workflow. The agent does not ingest GitHub issue or milestone output directly; it asks the user for sanitized issue summaries before analysis or @014-agile-user-story handoff. This should trigger for requests such as GitHub issue summary workflow; GitHub CLI setup for issues; Prepare sanitized GitHub issue inventory.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="044-planning-jira">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need the Jira CLI (`jira`) to verify installation, configure Jira Cloud access, list issues (all or by JQL) as markdown tables, and analyze user-provided sanitized Jira summaries. Uses an interactive install gate - if `jira` is missing, ask whether to show installation guidance before any issue commands. This should trigger for requests such as jira issue list; List Jira issues; Jira JQL issue query; Jira CLI issue workflow.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="110-java-maven-best-practices">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to review, improve, or troubleshoot a Maven pom.xml file — including dependency management with BOMs, plugin configuration, version centralization, multi-module project structure, build profiles, or any situation where you want to align your Maven setup with industry best practices. This should trigger for requests such as Review pom.xml to improve it; Apply Maven best practices to pom.xml; Improve Maven POM configuration.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to add or evaluate Maven dependencies that improve code quality — including nullness annotations (JSpecify), static analysis (Error Prone + NullAway), functional programming (VAVR), or architecture testing (ArchUnit) — and want a consultative, question-driven approach that adds only what you actually need. This should trigger for requests such as Add Maven dependencies; Add JSpecify nullness dependencies; Add Error Prone NullAway dependencies; Add VAVR functional dependencies; Add ArchUnit architecture testing dependencies.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
interactive="true">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to add or configure Maven plugins in your pom.xml — including quality tools (enforcer, surefire, failsafe, jacoco, pitest, spotbugs, pmd), security scanning (OWASP), code formatting (Spotless), version management, container image build (Jib), build information tracking, and benchmarking (JMH) — through a consultative, modular step-by-step approach that only adds what you actually need. This should trigger for requests such as Add Maven plugins in pom.xml; Improve Maven plugins in pom.xml.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="113-java-maven-documentation">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to create a DEVELOPER.md file for a Maven project — combining a fixed base template with dynamic sections derived from the project pom.xml, including a Plugin Goals Reference, Maven Profiles table, and Submodules table for multi-module projects. This should trigger for requests such as Create DEVELOPER.md; Generate DEVELOPER.md; Maven project documentation; Add Maven documentation; Plugin goals reference.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="114-java-maven-search">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Covers Maven Central search using structured Search API fields and URL construction, plus project-local update report guidance for user-provided Versions Maven Plugin output. Use when finding or verifying coordinates or interpreting update reports for the user’s pom.xml. This should trigger for requests such as Search Maven Central; Find Maven dependency; Maven coordinates; groupId artifactId version.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="121-java-object-oriented-design">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when reviewing, improving, or refactoring Java object-oriented design, including applying SOLID, DRY, or YAGNI; improving classes and interfaces; correcting encapsulation, inheritance, or polymorphism; resolving God Class, Feature Envy, or Data Clumps; and improving object creation, methods, or exception contracts. Triggers include review Java OOD, refactor Java OOD, improve Java OOD, fix OOP misuse, and identify Java code smells.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="122-java-type-design">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to review, improve, or refactor Java code for type design quality — including establishing clear type hierarchies, applying consistent naming conventions, eliminating primitive obsession with domain-specific value objects, leveraging generic type parameters, creating type-safe wrappers, designing fluent interfaces, ensuring precision-appropriate numeric types (BigDecimal for financial calculations), and improving type contrast through interfaces and method signature alignment. This should trigger for requests such as Review Java code for type design; Improve type design in Java code; Fix primitive obsession in Java code; Create value objects in Java code.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="123-java-design-patterns">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to select, review, or implement Java design and integration patterns — including classic Java design patterns, REST API patterns, Kafka and event-driven patterns, database and persistence patterns, and cross-cutting integration patterns. This should trigger for requests such as Apply Java design patterns; Review REST API patterns; Design Kafka event-driven patterns; Improve database persistence patterns; Add resilient integration patterns.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="124-java-secure-coding">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to apply Java secure coding best practices — including validating untrusted inputs, defending against injection attacks with parameterized queries, minimizing attack surface via least privilege, applying strong cryptographic algorithms, handling exceptions securely without exposing sensitive data, managing secrets at runtime, avoiding unsafe deserialization, and encoding output to prevent XSS. This should trigger for requests such as Review Java code for secure coding.</description>
</metadata>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
id="125-java-concurrency">
<metadata>
<author>Juan Antonio Breña Moral</author>
<version>0.16.0</version>
<version>0.17.0-SNAPSHOT</version>
<license>Apache-2.0</license>
<description>Use when you need to apply Java concurrency best practices — including thread safety fundamentals, ExecutorService thread pool management, concurrent design patterns like Producer-Consumer, asynchronous programming with CompletableFuture, immutability and safe publication, deadlock avoidance, virtual threads, structured concurrency, scoped values, backpressure, cancellation discipline, and observability for concurrent systems. This should trigger for requests such as Review Java code for concurrency.</description>
</metadata>
Expand Down
Loading
Loading