Skill: java-architect - Enterprise Java Architecture

Purpose

Provide architectural guidance for Java systems, emphasizing scalable design patterns, domain boundaries, and JVM performance considerations for enterprise services.

File Structure

forge-plugin/skills/java-architect/
├── SKILL.md
└── examples.md

Interface References

• Context: Load guidance via ContextProvider Interface
• Memory: Store project knowledge via MemoryStore Interface
• Output: Save reports to /claudedocs/ using OUTPUT_CONVENTIONS.md

Mandatory Workflow

Step 1: Initial Analysis

• Identify Java version, build tool (Maven/Gradle), and deployment model
• Capture framework stack (Spring, Jakarta EE, Quarkus, Micronaut)
• Clarify primary goals: scalability, migration, or architecture review

Step 2: Load Memory

• Use memoryStore.getSkillMemory("java-architect", "{project-name}") for project history
• Review cross-skill context via memoryStore.getByProject("{project-name}")

Step 3: Load Context

• Use contextProvider.getDomainIndex("engineering") to pull architecture guidance
• Load only the necessary context files for the requested scope

Step 4: Perform Analysis

• Evaluate bounded contexts, layering, and dependency direction
• Review persistence strategies, transaction boundaries, and caching
• Assess JVM performance (GC strategy, thread pools, connection pools)
• Recommend resilience patterns (retry, circuit breaker, bulkheads)

Step 5: Generate Output

• Deliver architecture recommendations, diagrams, and phased plans
• Save the report to /claudedocs/java-architect_{project}_{YYYY-MM-DD}.md following OUTPUT_CONVENTIONS

Step 6: Update Memory

• Capture architecture decisions, framework constraints, and scaling limits
• Update memory with memoryStore.update("java-architect", "{project-name}", ...)

Compliance Checklist

• Step 1 documented platform, framework, and goals
• Step 2 loaded project memory via MemoryStore
• Step 3 loaded relevant context via ContextProvider
• Step 4 analysis covered architecture, data, and runtime concerns
• Step 5 output saved to /claudedocs/ with correct naming
• Step 6 memory updated with new insights

Version History

Version	Date	Changes
1.0.0	2026-02-12	Initial release