cuioss/java-maintenance
marketplace/bundles/pm-dev-java/skills/java-maintenance/SKILL.md
Java code maintenance standards including prioritization, refactoring triggers, and compliance verification
$ install --global
skillsauthnpx skillsauth add cuioss/plan-marshall java-maintenanceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 30, 2026, 3:19 AM139.9s5 files scanned
SKILL.md
- name:
- java-maintenance
- description:
- Java code maintenance standards including prioritization, refactoring triggers, and compliance verification
- user-invocable:
- false
- mode:
- knowledge
Java Maintenance Skill
REFERENCE MODE: This skill provides reference material. Load specific standards on-demand based on current task.
Java code maintenance standards for identifying, prioritizing, and executing refactoring work. This skill covers compliance checking, maintenance prioritization, and refactoring triggers.
Prerequisites
This skill applies to all Java projects requiring maintenance or refactoring.
Workflow
Step 1: Load Prioritization Framework
Important: Load this standard for any maintenance work.
Read: standards/maintenance-prioritization.md
This provides foundational rules for:
- High priority: API contract issues, code organization
- Medium priority: Method design, maintainability
- Low priority: Style and conventions
Step 2: Load Additional Standards (As Needed)
Refactoring Triggers (load for code analysis):
Read: standards/refactoring-triggers.md
Use when: Identifying when code needs refactoring based on metrics and patterns.
Compliance Checklist (load for verification):
Read: standards/compliance-checklist.md
Use when: Verifying code meets all Java development standards.
Key Rules Summary
Priority Categories
High Priority (API/Contract Issues)
- Missing @NonNull annotations on public APIs
- Inconsistent null safety patterns
- Poor error handling
- Single Responsibility violations
Medium Priority (Maintainability)
- Long methods (>50 lines)
- High parameter counts (>4 without objects)
- High cyclomatic complexity (>15)
- Poor naming conventions
Low Priority (Style)
- Formatting inconsistencies
- Import organization
- Comment style variations
Refactoring Triggers
// TRIGGER: Method too long
// Refactor when method exceeds 50 lines
// TRIGGER: Too many parameters
// Refactor when method has >4 parameters
// Use parameter objects
// TRIGGER: High complexity
// Refactor when cyclomatic complexity >15
// Extract methods, use polymorphism
Compliance Verification
Use explicit script calls for all build operations:
- Analysis:
python3 .plan/execute-script.py plan-marshall:manage-architecture:architecture resolve --command quality-gate - Coverage:
python3 .plan/execute-script.py plan-marshall:manage-architecture:architecture resolve --command coverage - Verify:
python3 .plan/execute-script.py plan-marshall:manage-architecture:architecture resolve --command verify
Related Skills
plan-marshall:ref-code-quality- Language-agnostic refactoring triggers and prioritizationpm-dev-java:java-core- Core Java patternspm-dev-java:junit-core- Test coverage requirementspm-dev-java:javadoc- Documentation standards
Standards Reference
| Standard | Purpose | |----------|---------| | maintenance-prioritization.md | Priority framework for refactoring | | refactoring-triggers.md | Metrics and patterns triggering refactoring | | compliance-checklist.md | Full standards compliance verification |
Related Skills
cuioss/parse-rewrite-log
development
VerifiedTrustedCommunity
Domain-owned OpenRewrite log-line finding parser for the java-cui domain — parses the
5SKILL.mdUpdated Jul 28, 2026
cuioss/search-markers
development
VerifiedTrustedCommunity
Domain-owned OpenRewrite marker detection for the java-cui domain — scans Java/Kotlin sources for cui-rewrite TODO markers, categorizes them by recipe, and fails the gate on any detected marker
5SKILL.mdUpdated Jul 23, 2026
cuioss/manage-build-server
development
VerifiedTrustedCommunity
Operator control surface for the marshalld build server — enrol/drop a project in the machine-global registry (the opt-in enable signal and anti-laundering wall), manage the daemon lifecycle (start, stop, drain, status, install, upgrade) version-pinned to the verified bundle copy, and inspect the daemon's per-project interaction-audit log (read-only)
5SKILL.mdUpdated Jul 19, 2026
cuioss/build-server-client
tools
VerifiedTrustedCommunity
The tiny build-consumption client for the marshalld build server — submit a build job, bounded long-poll for its result, ping the daemon identity, and preflight registry-plus-liveness in one call; consumption only, never provisioning or enrolment
5SKILL.mdUpdated Jul 19, 2026