Agent Skills: Java Standards

Java Standards

Java service standards for Bitso projects.

When to use this skill

• Creating new Java services or modules
• Understanding project organization patterns
• Reviewing Java code for standards compliance
• Configuring MapStruct for object mapping
• Verifying builds after code changes

Skill Contents

Sections

• When to use this skill
• Tech Stack
• Project Organization
• Build Verification
• References
• Related Rules
• Related Skills

Available Resources

📚 references/ - Detailed documentation

• build verification
• code review
• mapstruct spring
• services

Tech Stack

| Component | Version | Notes | |-----------|---------|-------| | Java | 21 (LTS) | Current LTS version | | Gradle | 9.2.1 | Recommended for all projects | | Spring Boot | 3.5.9 | Latest (min 3.5.9) - preparing for Spring Boot 4 | | Database Access | jOOQ | For accessing PostgreSQL | | Databases | PostgreSQL, Redis | Primary data stores | | Inter-service Communication | gRPC | Standard protocol | | Object Mapping | MapStruct | For DTO/domain mapping |

For Spring Boot upgrades, use /upgrade-to-recommended-versions.

Project Organization

Projects should be organized with domain-based modules:

root-project/
├── build.gradle
├── settings.gradle
├── docs/                    # Documentation
├── bitso-libs/              # Library modules
│   ├── <subdomain>/         # Domain logic
│   └── <subdomain-proto>/   # Protobuf definitions
└── bitso-services/          # Service modules
    └── <domain>/            # Spring Boot application

Build Verification

After updating Java or Groovy code, verify changes:

# Run tests to verify changes
./gradlew test 2>&1 | grep -E "FAILED|Error" || echo "All tests passed"

# Or run full build with tests
./gradlew build 2>&1 | grep -E "FAILED|Error" || echo "Build successful"

If problems are found, fix them before committing.

References

| Reference | Description | |-----------|-------------| | references/services.md | Tech stack, project structure, dependency management, MapStruct | | references/code-review.md | Java 21 standards, coding style, var keyword usage | | references/build-verification.md | Build commands and verification practices |

Related Rules

• java-services-standards - Full-service standards
• java-code-review-standards - Code review guidelines
• java-run-build-after-changes - Build verification

Related Skills

| Skill | Purpose | |-------|---------| | gradle-standards | Gradle configuration | | grpc-services-rfc-33 | gRPC service implementation | | database-integration | jOOQ and Flyway |