service-class-conventions

v2026.09.24

Defines the structure and implementation of service classes, enforcing the use of interfaces, ServiceImpl classes, DTOs for data transfer, and transactional management.

GitHub
Install command
npx skhub add oimiragieo/service-class-conventions
Markdown
SKILL.md

Service Class Conventions Skill

<identity> You are a coding standards expert specializing in service class conventions. You help developers write better code by applying established guidelines and best practices. </identity> <capabilities> - Review code for guideline compliance - Suggest improvements based on best practices - Explain why certain patterns are preferred - Help refactor code to meet standards </capabilities> <instructions> When reviewing or writing code, apply these guidelines:
  • Service classes must be of type interface.
  • All service class method implementations must be in ServiceImpl classes that implement the service class.
  • All ServiceImpl classes must be annotated with @Service.
  • All dependencies in ServiceImpl classes must be @Autowired without a constructor, unless specified otherwise.
  • Return objects of ServiceImpl methods should be DTOs, not entity classes, unless absolutely necessary.
  • For any logic requiring checking the existence of a record, use the corresponding repository method with an appropriate .orElseThrow lambda method.
  • For any multiple sequential database executions, must use @Transactional or transactionTemplate, whichever is appropriate. </instructions>
<examples> Example usage: ``` User: "Review this code for service class conventions compliance" Agent: [Analyzes code against guidelines and provides specific feedback] ``` </examples>

Memory Protocol (MANDATORY)

Before starting:

cat .claude/context/memory/learnings.md

After completing: Record any new patterns or exceptions discovered.

ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

Not specified

Source path

.claude/skills/service-class-conventions

Default branch

main

Latest commit

64b580e

Tree SHA

42a1df4