DEVELOPER.md

Developer commands

Essential maven commands

# Analyze dependencies
./mvnw dependency:tree
./mvnw dependency:analyze
./mvnw dependency:resolve

./mvnw clean validate -U
./mvnw buildplan:list-plugin
./mvnw buildplan:list-phase
./mvnw help:all-profiles
./mvnw help:active-profiles
./mvnw license:third-party-report

# Clean the project
./mvnw clean

# Run unit tests
./mvnw clean test

# Run integration tests
./mvnw clean verify

# Clean and package in one command
./mvnw clean package

# Check for dependency updates
./mvnw versions:display-property-updates
./mvnw versions:display-dependency-updates
./mvnw versions:display-plugin-updates

# Generate project reports
./mvnw site
jwebserver -p 8005 -d "$(pwd)/target/site/"

# Run blog in local
./mvnw clean generate-resources jbake:inline -pl site-generator -P local-preview

# Promote blog changes to Prod
./mvnw clean generate-resources -pl site-generator -P site-update

Submodules

This is a multi-module project. The following modules are declared in the root pom.xml.

Module	Artifact ID	Commands	Description
system-prompts-generator	cursor-rules-java-generator	./mvnw clean verify -pl system-prompts-generator ./mvnw clean install -pl system-prompts-generator	XSLT-based rule generator that produces Cursor rules from XML sources into .cursor/rules/.
skills-generator	cursor-rules-java-skills-generator	./mvnw clean verify -pl skills-generator ./mvnw clean install -pl skills-generator	Generates agent skills from cursor rules into skills/. Depends on system-prompts-generator.
site-generator	cursor-rules-java-site	./mvnw clean verify -pl site-generator ./mvnw clean generate-resources jbake:inline -pl site-generator -P local-preview ./mvnw clean generate-resources -pl site-generator -P site-update	JBake-based static site generator for documentation and GitHub Pages.

Maven Profiles

The following profiles are declared in this project. Activate them with -P <profileId>.

Profile ID	Command	Activation	Description
security	./mvnw clean verify -P security	manual	Runs OWASP dependency-check-maven to scan for known vulnerabilities; fails on CVSS ≥ 7.
find-bugs	./mvnw clean verify -P find-bugs	manual	Runs PMD and SpotBugs static analysis with max effort and low threshold.
local-preview	./mvnw clean generate-resources jbake:inline -pl site-generator -P local-preview	manual	Generates site to target/docs-local and serves it locally (site-generator).
site-update	./mvnw clean generate-resources -pl site-generator -P site-update	manual	Regenerates the static site into docs/ for GitHub Pages (site-generator).

Plugin Goals Reference

The following sections list useful goals for each plugin configured in this project's pom.xml.

maven-compiler-plugin

Goal	Description
./mvnw compiler:compile	Compile main source files
./mvnw compiler:testCompile	Compile test source files

maven-surefire-plugin

Goal	Description
./mvnw surefire:test	Run unit tests
./mvnw surefire:help	Display help information

maven-resources-plugin

Goal	Description
./mvnw resources:resources	Copy main resources to output directory
./mvnw resources:testResources	Copy test resources to output directory

maven-clean-plugin

Goal	Description
./mvnw clean:clean	Delete the build output directory

jbake-maven-plugin

Goal	Description
./mvnw jbake:generate	Generate static site with JBake
./mvnw jbake:inline	Generate and serve site locally

maven-enforcer-plugin

Goal	Description
./mvnw enforcer:enforce	Execute enforcer rules
./mvnw enforcer:display-info	Display current platform information

spotless-maven-plugin

Goal	Description
./mvnw spotless:apply	Apply formatting fixes
./mvnw spotless:check	Check formatting and fail on violations

versions-maven-plugin

Goal	Description
./mvnw versions:display-dependency-updates	Show available dependency updates
./mvnw versions:display-plugin-updates	Show available plugin updates
./mvnw versions:display-property-updates	Show available property updates
./mvnw versions:use-latest-releases	Update dependencies to latest releases
./mvnw versions:set -DnewVersion=X.Y.Z	Set the project version

spotbugs-maven-plugin

Goal	Description
./mvnw spotbugs:check	Run SpotBugs analysis and fail on bugs
./mvnw spotbugs:spotbugs	Generate a SpotBugs report
./mvnw spotbugs:gui	Launch the SpotBugs GUI

maven-pmd-plugin

Goal	Description
./mvnw pmd:check	Run PMD analysis and fail on violations
./mvnw pmd:pmd	Generate a PMD report
./mvnw pmd:cpd-check	Run copy-paste detection and fail on duplicates

dependency-check-maven

Goal	Description
./mvnw dependency-check:check	Scan dependencies for known vulnerabilities
./mvnw dependency-check:aggregate	Aggregate scan for multi-module projects