Plinth for Java

<a href="https://trendshift.io/repositories/15013" target="_blank"><img src="https://trendshift.io/api/badge/repositories/15013" alt="jabrena%2Fcursor-rules-java | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

Languages: Español · 中文

>

Help this project grow: Become a sponsor

Goal

An opinionated AI-native workflow for evolving modern Java Enterprise SDLC practices through reusable Skills, Agents, Commands & MCP servers.

What is a Plinth?

A plinth represents the solid foundation or platform used to support statues or artworks in art and sculpture. It served as a structural and symbolic foundation for columns, statues, and entire temple podiums. Romans inherited the idea from Greek architecture but expanded its use to emphasize monumentality, hierarchy, and imperial power.

Project at a glance

• 14 Commands
• 9 Agents
• 125 Skills

Latest Updates

Explore the latest published content on https://jabrena.github.io/plinth/ and follow its evolution through new skills, improvements, and fixes in the CHANGELOG.

Start in 60 seconds

Install every skill for your preferred agent:

npx skills add jabrena/plinth --skill '*' --agent cursor -y
npx skills add jabrena/plinth --skill '*' --agent claude-code -y
npx skills add jabrena/plinth --skill '*' --agent codex -y
npx skills add jabrena/plinth --skill '*' --agent github-copilot -y

Install every command for your prefered agent:

install @004-commands-installation cursor
install @004-commands-installation claude-code
install @004-commands-installation codex
install @004-commands-installation github-copilot

Install every agent for your prefered agent:

install @005-agents-installation cursor
install @005-agents-installation claude-code
install @005-agents-installation codex
install @005-agents-installation github-copilot

See it in action

You can use the project in 2 ways:

• Use the AI-Native development workflow
• Refactor your code with Skills

Using the AI-Native development workflow

Prepare the repository with /onboarding, then identify an issue in your Kanban dashboard from Atlasian Jira, Github Issues or Azure DevOps and apply the following workflow:

/onboarding
  |
  v
Issue
  |
  v
/update-issue --> /explore-problem --> /create-acceptance-criteria
  |
  v
/create-spec --> /explore-design
  |
  v
/implement-spec --> /close-spec

/onboarding establishes root AGENTS.md and one unambiguous OpenSpec project before issue selection. It preserves existing prerequisites; when OpenSpec is missing, you select its result path with documentation/openspec as the default.

##### Analysis & Design

Turn an idea into an actionable change with user stories, GitHub Issues or Jira, ADRs, diagrams, AI plan mode, and OpenSpec.

Functional Specification:

<table> <thead> <tr> <th>Command</th> <th>Explanation</th> </tr> </thead> <tbody> <tr> <td><code>/onboarding</code></td> <td>Establish root repository guidance and one unambiguous OpenSpec project before issue work.</td> </tr> <tr> <td><code>/update-issue</code></td> <td>Update an existing GitHub or Jira issue with a structured user story, acceptance criteria, and resource content.</td> </tr> <tr> <td><code>/explore-problem</code></td> <td>Evaluate an issue from five perspectives and post a Functional Specification comment on the issue.</td> </tr> <tr> <td><code>/create-acceptance-criteria</code></td> <td>Derive Gherkin acceptance criteria from a Functional Specification and post them as a separate issue comment.</td> </tr> </tbody> </table>

Technical Specification:

<table> <thead> <tr> <th>Command</th> <th>Explanation</th> </tr> </thead> <tbody> <tr> <td><code>/create-adr</code> (Optional)</td> <td>Record an architectural decision, its alternatives, rationale, and consequences.</td> </tr> <tr> <td><code>/create-diagram</code> (Optional)</td> <td>Create a focused architecture or design diagram from approved artifacts.</td> </tr> <tr> <td><code>/create-spec</code> (OpenSpec)</td> <td>Create or update one or more validated OpenSpec changes.</td> </tr> <tr> <td><code>/explore-design</code></td> <td>Compare technical approaches and obtain an approved design direction.</td> </tr> </tbody> </table>

##### Build

Implement and improve Java applications with Maven, design, coding, testing, security, documentation, Spring Boot, Quarkus, Micronaut, OpenAPI, and WireMock guidance.

<table> <thead> <tr> <th>Command</th> <th>Explanation</th> </tr> </thead> <tbody> <tr> <td><code>/implement-spec</code></td> <td>Deliver an approved plan or validated OpenSpec task list through framework-aware delegation.</td> </tr> <tr> <td><code>/close-spec</code></td> <td>Archive an OpenSpec change by name using the OpenSpec CLI.</td> </tr> </tbody> </table>

Operate

Measure and improve production behavior through observability, profiling, benchmarking, and performance testing.

<table> <thead> <tr> <th>Command</th> <th>Explanation</th> </tr> </thead> <tbody> <tr> <td><code>/profile</code></td> <td>Coordinate Java profiling from baseline detection through verified optimization.</td> </tr> <tr> <td><code>/benchmark</code></td> <td>Select and coordinate JMeter, Gatling, or JMH performance workflows.</td> </tr> </tbody> </table>

Compliance (Alpha)

Review Java systems, AI models, and how GenAI tools are used across applications and delivery pipelines for regulation-aware engineering controls, evidence, and qualified owner handoffs spanning AI, data, security, product, platform, market, and governance. <u>These skills support engineering awareness and do not provide legal advice.</u>

Note: This set of skills could be a good complement for the future OWASP EU Compliance MCP.

Refactor your code with Skill

The project provides a complete set of Agent Skills for Java Enterprise development covering aspects like: Build system based on Maven, Design, Coding, Testing, Observability, Refactoring & JMH Benchmarking, Performance testing with JMeter/Gatling, Profiling with Async profiler/OpenJDK tools, Documentation, Spring Boot, Quarkus, Micronaut, OpenAPI, WireMock, Docker, SQL/NoSQL, Security & AGENTS.md

User prompt example:

Use @110-java-maven-best-practices to review this Maven project located in examples/@maven/maven-demo
Explain the findings, apply the approved improvements, and validate the build.

The skill guides the agent through a structured Maven review while keeping you in control of proposed changes.

5-Minute Onboarding

Learn to use this project following the quick guide Getting Started in 5 minutes.

Explore the complete Commands, Agents, Skills, and MCP Servers inventories.

Project Components

The project generates a set of deliverables at the end of any iteration.

Compatibility

This project is compatible with any tool that supports Commands, Agents, Skills, MCP Servers and AGENTS.md.

Skill Validations

Every push runs the following validation checks in the Skill Scanners as part of the CI Pipeline to keep documentation and generated skills correct, consistent, and secure:

Limitations

Lack of determinism

From the outset, be aware that results from interactions with these Skills and agents are not deterministic because of how the models behave, but you can mitigate that with clear goals and validation checkpoints.

Not all models behave in the same way

Some interactive skills require Premium models for interactive use; otherwise they follow a fixed sequence of steps.

Limits of interactions with models

Models can generate code, but they cannot execute it against your local data. To bridge that gap, some Skills include scripts you run locally.

Software engineers must remain in the loop

This project supports software engineering work; it does not replace engineering judgment. A software engineer must review, guide, and validate AI-generated decisions, code, and outcomes before they are used.

Access to corporate data

Use caution when a problem involves corporate databases or other sensitive organizational data. Before granting an AI-assisted workflow access, assess authorization, privacy, data leakage, retention, and unintended modification risks. Apply least-privilege access, human review, validation, and monitoring. See OWASP GenAI Data Security Risks & Mitigations 2026, and the new set of skills about EU regulation.

Contribute

See CONTRIBUTING.md for ways to support and improve the project.

Architecture Decision Records (ADR)

• Review the ADR index for the complete list.

Java JEPs from Java 8 onward

Java uses JEPs (JDK Enhancement Proposals) to describe new language and platform features. This repository tracks which JEPs could improve the Skills and guidance here.

• JEPs list

Further resources

Talks, articles, reference links, skill portals, and related projects live in Project references.

Developed by humans with support from Cursor and Codex, with ❤️ from Madrid