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: Apr 28, 2026, 4:25 AM129.1s5 files scanned
SKILL.md
- name:
- java-maintenance
- description:
- Java code maintenance standards including prioritization, refactoring triggers, and compliance verification
- user-invocable:
- false
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:dev-general-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/manage-change-ledger
development
VerifiedTrustedCommunity
The single append-only change-ledger — one worktree_sha-stamped substrate for kind=build and kind=change entries — plus the first-class worktree-sha freshness API
5SKILL.mdUpdated Jun 13, 2026
cuioss/ref-ascii-diagrams
development
VerifiedTrustedCommunity
Authoring standards for ASCII box diagrams in skill and doc source — box-drawing conventions, right-border alignment, and a deterministic check/fix validator over fenced/literal code blocks in .md and .adoc files
5SKILL.mdUpdated Jun 10, 2026
cuioss/recipe-verify-ascii-diagrams
testing
VerifiedTrustedCommunity
Recipe for verifying and fixing alignment of ASCII box diagrams across .md skill source and .adoc documentation, one deliverable per offending file
5SKILL.mdUpdated Jun 10, 2026
cuioss/manage-terminal-title
development
VerifiedTrustedCommunity
Pure platform-agnostic terminal-title composition consumed by platform-runtime via PYTHONPATH
5SKILL.mdUpdated Jun 10, 2026