[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73DCWAVCCHZ52SHX2TSADD8":3,"skill-same:01M73DCWAVCCHZ52SHX2TSADD8":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M73DCWAVCCHZ52SHX2TSADD8","java-coding-standards",null,"Java coding standards for Spring Boot and Quarkus services: naming, immutability, Optional usage, streams, exceptions, generics, CDI, reactive patterns, and project layout. Automatically applies framework-specific conventions.","Horonomos-laps\u002FYana-AI","Horonomos-laps","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F355299122?v=4","01M76B3QPXE88ET2SQPDPVATZT"," Horonomos-laps","01M72ZQRJPCYPSSWT4D00VJR2A",13,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fjava-coding-standards\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: java-coding-standards\ndescription: \"Java coding standards for Spring Boot and Quarkus services: naming, immutability, Optional usage, streams, exceptions, generics, CDI, reactive patterns, and project layout. Automatically applies framework-specific conventions.\"\norigin: ECC\n---\n\n# Java Coding Standards\n\nStandards for readable, maintainable Java (17+) code in Spring Boot and Quarkus services.\n\n## When to Use\n\n- Writing or reviewing Java code in Spring Boot or Quarkus projects\n- Enforcing naming, immutability, or exception handling conventions\n- Working with records, sealed classes, or pattern matching (Java 17+)\n- Reviewing use of Optional, streams, or generics\n- Structuring packages and project layout\n- **[QUARKUS]**: Working with CDI scopes, Panache entities, or reactive pipelines\n\n## How It Works\n\n### Framework Detection\n\nBefore applying standards, determine the framework from the build file:\n\n- Build file contains `quarkus` → apply **[QUARKUS]** conventions\n- Build file contains `spring-boot` → apply **[SPRING]** conventions\n- Neither detected → apply shared conventions only\n\n## Core Principles\n\n- Prefer clarity over cleverness\n- Immutable by default; minimize shared mutable state\n- Fail fast with meaningful exceptions\n- Consistent naming and package structure\n- **[QUARKUS]**: Favor build-time over runtime processing; avoid runtime reflection where possible\n\n## Examples\n\nThe sections below show concrete Spring Boot, Quarkus, and shared Java examples\nfor naming, immutability, dependency injection, reactive code, exceptions,\nproject layout, logging, configuration, and tests.\n\n## Naming\n\n```java\n\u002F\u002F PASS: Classes\u002FRecords: PascalCase\npublic class MarketService {}\npublic record Money(BigDecimal amount, Currency currency) {}\n\n\u002F\u002F PASS: Methods\u002Ffields: camelCase\nprivate final MarketRepository marketRepository;\npublic Market findBySlug(String slug) {}\n\n\u002F\u002F PASS: Constants: UPPER_SNAKE_CASE\nprivate static final int MAX_PAGE_SIZE = 100;\n\n\u002F\u002F PASS: [QUARKUS] JAX-RS resources named as *Resource, not *Controller\npublic class MarketResource {}\n\n\u002F\u002F PASS: [SPRING] REST controllers named as *Controller\npublic class MarketController {}\n```\n\n## Immutability\n\n```java\n\u002F\u002F PASS: Favor records and final fields\npublic record MarketDto(Long id, String name, MarketStatus status) {}\n\npublic class Market {\n  private final Long id;\n  private final String name;\n  \u002F\u002F getters only, no setters\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache active-record entities use public fields (Quarkus convention)\n@Entity\npublic class Market extends PanacheEntity {\n  public String name;\n  public MarketStatus status;\n  \u002F\u002F Panache generates accessors at build time; public fields are idiomatic here\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache MongoDB entities\n@MongoEntity(collection = \"markets\")\npublic class Market extends PanacheMongoEntity {\n  public String name;\n  public MarketStatus status;\n}\n```\n\n## Optional Usage\n\n```java\n\u002F\u002F PASS: Return Optional from find* methods\n\u002F\u002F [SPRING]\nOptional\u003CMarket> market = marketRepository.findBySlug(slug);\n\n\u002F\u002F [QUARKUS] Panache\nOptional\u003CMarket> market = Market.find(\"slug\", slug).firstResultOptional();\n\n\u002F\u002F PASS: Map\u002FflatMap instead of get()\nreturn market\n    .map(MarketResponse::from)\n    .orElseThrow(() -> new EntityNotFoundException(\"Market not found\"));\n```\n\n## Streams Best Practices\n\n```java\n\u002F\u002F PASS: Use streams for transformations, keep pipelines short\nList\u003CString> names = markets.stream()\n    .map(Market::name)\n    .filter(Objects::nonNull)\n    .toList();\n\n\u002F\u002F FAIL: Avoid complex nested streams; prefer loops for clarity\n```\n\n## Dependency Injection\n\n```java\n\u002F\u002F PASS: [SPRING] Constructor injection (preferred over @Autowired on fields)\n@Service\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Constructor injection\n@ApplicationScoped\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  @Inject\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Package-private field injection (acceptable in Quarkus — avoids proxy issues)\n@ApplicationScoped\npublic class MarketService {\n  @Inject\n  MarketRepository marketRepository;\n}\n\n\u002F\u002F FAIL: [SPRING] Field injection with @Autowired\n@Autowired\nprivate MarketRepository marketRepository; \u002F\u002F use constructor injection\n\n\u002F\u002F FAIL: [QUARKUS] @Singleton when interception or lazy init is needed\n@Singleton \u002F\u002F non-proxyable — use @ApplicationScoped instead\npublic class MarketService {}\n```\n\n## Reactive Patterns [QUARKUS]\n\n```java\n\u002F\u002F PASS: Return Uni\u002FMulti from reactive endpoints\n@GET\n@Path(\"\u002F{slug}\")\npublic Uni\u003CMarket> findBySlug(@PathParam(\"slug\") String slug) {\n  return Market.find(\"slug\", slug)\n      .\u003CMarket>firstResult()\n      .onItem().ifNull().failWith(() -> new MarketNotFoundException(slug));\n}\n\n\u002F\u002F PASS: Non-blocking pipeline composition\npublic Uni\u003COrderConfirmation> placeOrder(OrderRequest req) {\n  return validateOrder(req)\n      .chain(valid -> persistOrder(valid))\n      .chain(order -> notifyFulfillment(order));\n}\n\n\u002F\u002F FAIL: Blocking call inside a Uni\u002FMulti pipeline\npublic Uni\u003CMarket> find(String slug) {\n  Market m = Market.find(\"slug\", slug).firstResult(); \u002F\u002F BLOCKING — breaks event loop\n  return Uni.createFrom().item(m);\n}\n\n\u002F\u002F FAIL: Subscribing more than once to a shared Uni\nUni\u003CMarket> shared = fetchMarket(slug);\nshared.subscribe().with(m -> log(m));\nshared.subscribe().with(m -> cache(m)); \u002F\u002F double subscribe — use Uni.memoize()\n```\n\n## Exceptions\n\n- Use unchecked exceptions for domain errors; wrap technical exceptions with context\n- Create domain-specific exceptions (e.g., `MarketNotFoundException`)\n- Avoid broad `catch (Exception ex)` unless rethrowing\u002Flogging centrally\n\n```java\nthrow new MarketNotFoundException(slug);\n```\n\n### Centralised Exception Handling\n\n```java\n\u002F\u002F [SPRING]\n@RestControllerAdvice\npublic class GlobalExceptionHandler {\n  @ExceptionHandler(MarketNotFoundException.class)\n  public ResponseEntity\u003CErrorResponse> handle(MarketNotFoundException ex) {\n    return ResponseEntity.status(404).body(ErrorResponse.from(ex));\n  }\n}\n\n\u002F\u002F [QUARKUS] Option A: ExceptionMapper\n@Provider\npublic class MarketNotFoundMapper implements ExceptionMapper\u003CMarketNotFoundException> {\n  @Override\n  public Response toResponse(MarketNotFoundException ex) {\n    return Response.status(404).entity(ErrorResponse.from(ex)).build();\n  }\n}\n\n\u002F\u002F [QUARKUS] Option B: @ServerExceptionMapper (RESTEasy Reactive)\n@ServerExceptionMapper\npublic RestResponse\u003CErrorResponse> handle(MarketNotFoundException ex) {\n  return RestResponse.status(Status.NOT_FOUND, ErrorResponse.from(ex));\n}\n```\n\n## Generics and Type Safety\n\n- Avoid raw types; declare generic parameters\n- Prefer bounded generics for reusable utilities\n\n```java\npublic \u003CT extends Identifiable> Map\u003CLong, T> indexById(Collection\u003CT> items) { ... }\n```\n\n## Project Structure\n\n### [SPRING] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F\n  controller\u002F\n  service\u002F\n  repository\u002F\n  domain\u002F\n  dto\u002F\n  util\u002F\nsrc\u002Fmain\u002Fresources\u002F\n  application.yml\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n### [QUARKUS] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F              # @ConfigMapping, @ConfigProperty beans, Producers\n  resource\u002F            # JAX-RS resources (not \"controller\")\n  service\u002F\n  repository\u002F          # PanacheRepository implementations (if not using active record)\n  domain\u002F              # JPA\u002FPanache entities, MongoDB entities\n  dto\u002F\n  util\u002F\n  mapper\u002F              # MapStruct mappers (if used)\nsrc\u002Fmain\u002Fresources\u002F\n  application.properties   # Quarkus convention (YAML supported with quarkus-config-yaml)\n  import.sql               # Hibernate auto-import for dev\u002Ftest\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n## Formatting and Style\n\n- Use 2 or 4 spaces consistently (project standard)\n- One public top-level type per file\n- Keep methods short and focused; extract helpers\n- Order members: constants, fields, constructors, public methods, protected, private\n\n## Code Smells to Avoid\n\n- Long parameter lists → use DTO\u002Fbuilders\n- Deep nesting → early returns\n- Magic numbers → named constants\n- Static mutable state → prefer dependency injection\n- Silent catch blocks → log and act or rethrow\n- **[QUARKUS]**: `@Singleton` where `@ApplicationScoped` is intended — breaks proxying and interception\n- **[QUARKUS]**: Mixing `quarkus-resteasy-reactive` and `quarkus-resteasy` (classic) — pick one stack\n- **[QUARKUS]**: Panache active-record + repository pattern in the same bounded context — pick one\n\n## Logging\n\n```java\n\u002F\u002F [SPRING] SLF4J\nprivate static final Logger log = LoggerFactory.getLogger(MarketService.class);\nlog.info(\"fetch_market slug={}\", slug);\nlog.error(\"failed_fetch_market slug={}\", slug, ex);\n\n\u002F\u002F [QUARKUS] JBoss Logging (default, zero-cost at build time)\nprivate static final Logger log = Logger.getLogger(MarketService.class);\nlog.infof(\"fetch_market slug=%s\", slug);\nlog.errorf(ex, \"failed_fetch_market slug=%s\", slug);\n\n\u002F\u002F [QUARKUS] Alternative: simplified logging with @Inject\n@Inject\nLogger log; \u002F\u002F CDI-injected, scoped to declaring class\n```\n\n## Null Handling\n\n- Accept `@Nullable` only when unavoidable; otherwise use `@NonNull`\n- Use Bean Validation (`@NotNull`, `@NotBlank`) on inputs\n- **[QUARKUS]**: Apply `@Valid` on `@BeanParam`, `@RestForm`, and request body parameters\n\n## Configuration\n\n```java\n\u002F\u002F [SPRING] @ConfigurationProperties\n@ConfigurationProperties(prefix = \"market\")\npublic record MarketProperties(int maxPageSize, Duration cacheTtl) {}\n\n\u002F\u002F [QUARKUS] @ConfigMapping (type-safe, build-time validated)\n@ConfigMapping(prefix = \"market\")\npublic interface MarketConfig {\n  int maxPageSize();\n  Duration cacheTtl();\n}\n\n\u002F\u002F [QUARKUS] Simple values with @ConfigProperty\n@ConfigProperty(name = \"market.max-page-size\", defaultValue = \"100\")\nint maxPageSize;\n```\n\n## Testing Expectations\n\n### Shared\n- JUnit 5 + AssertJ for fluent assertions\n- Mockito for mocking; avoid partial mocks where possible\n- Favor deterministic tests; no hidden sleeps\n\n### [SPRING]\n- `@WebMvcTest` for controller slices, `@DataJpaTest` for repository slices\n- `@SpringBootTest` reserved for full integration tests\n- `@MockBean` for replacing beans in Spring context\n\n### [QUARKUS]\n- Plain JUnit 5 + Mockito for unit tests (no `@QuarkusTest`)\n- `@QuarkusTest` reserved for CDI integration tests\n- `@InjectMock` for replacing CDI beans in integration tests\n- Dev Services for database\u002FKafka\u002FRedis — avoid manual Testcontainers setup when Dev Services suffice\n- `@QuarkusTestResource` for custom external service lifecycle\n\n```java\n\u002F\u002F [SPRING] Controller test\n@WebMvcTest(MarketController.class)\nclass MarketControllerTest {\n  @Autowired MockMvc mockMvc;\n  @MockBean MarketService marketService;\n}\n\n\u002F\u002F [QUARKUS] Integration test\n@QuarkusTest\nclass MarketResourceTest {\n  @InjectMock\n  MarketService marketService;\n\n  @Test\n  void should_return_404_when_market_not_found() {\n    given().when().get(\"\u002Fmarkets\u002Funknown\").then().statusCode(404);\n  }\n}\n\n\u002F\u002F [QUARKUS] Unit test (no CDI, no @QuarkusTest)\n@ExtendWith(MockitoExtension.class)\nclass MarketServiceTest {\n  @Mock MarketRepository marketRepository;\n  @InjectMocks MarketService marketService;\n}\n```\n\n**Remember**: Keep code intentional, typed, and observable. Optimize for maintainability over micro-optimizations unless proven necessary.\n","# Java Coding Standards\n\nStandards for readable, maintainable Java (17+) code in Spring Boot and Quarkus services.\n\n## When to Use\n\n- Writing or reviewing Java code in Spring Boot or Quarkus projects\n- Enforcing naming, immutability, or exception handling conventions\n- Working with records, sealed classes, or pattern matching (Java 17+)\n- Reviewing use of Optional, streams, or generics\n- Structuring packages and project layout\n- **[QUARKUS]**: Working with CDI scopes, Panache entities, or reactive pipelines\n\n## How It Works\n\n### Framework Detection\n\nBefore applying standards, determine the framework from the build file:\n\n- Build file contains `quarkus` → apply **[QUARKUS]** conventions\n- Build file contains `spring-boot` → apply **[SPRING]** conventions\n- Neither detected → apply shared conventions only\n\n## Core Principles\n\n- Prefer clarity over cleverness\n- Immutable by default; minimize shared mutable state\n- Fail fast with meaningful exceptions\n- Consistent naming and package structure\n- **[QUARKUS]**: Favor build-time over runtime processing; avoid runtime reflection where possible\n\n## Examples\n\nThe sections below show concrete Spring Boot, Quarkus, and shared Java examples\nfor naming, immutability, dependency injection, reactive code, exceptions,\nproject layout, logging, configuration, and tests.\n\n## Naming\n\n```java\n\u002F\u002F PASS: Classes\u002FRecords: PascalCase\npublic class MarketService {}\npublic record Money(BigDecimal amount, Currency currency) {}\n\n\u002F\u002F PASS: Methods\u002Ffields: camelCase\nprivate final MarketRepository marketRepository;\npublic Market findBySlug(String slug) {}\n\n\u002F\u002F PASS: Constants: UPPER_SNAKE_CASE\nprivate static final int MAX_PAGE_SIZE = 100;\n\n\u002F\u002F PASS: [QUARKUS] JAX-RS resources named as *Resource, not *Controller\npublic class MarketResource {}\n\n\u002F\u002F PASS: [SPRING] REST controllers named as *Controller\npublic class MarketController {}\n```\n\n## Immutability\n\n```java\n\u002F\u002F PASS: Favor records and final fields\npublic record MarketDto(Long id, String name, MarketStatus status) {}\n\npublic class Market {\n  private final Long id;\n  private final String name;\n  \u002F\u002F getters only, no setters\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache active-record entities use public fields (Quarkus convention)\n@Entity\npublic class Market extends PanacheEntity {\n  public String name;\n  public MarketStatus status;\n  \u002F\u002F Panache generates accessors at build time; public fields are idiomatic here\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache MongoDB entities\n@MongoEntity(collection = \"markets\")\npublic class Market extends PanacheMongoEntity {\n  public String name;\n  public MarketStatus status;\n}\n```\n\n## Optional Usage\n\n```java\n\u002F\u002F PASS: Return Optional from find* methods\n\u002F\u002F [SPRING]\nOptional\u003CMarket> market = marketRepository.findBySlug(slug);\n\n\u002F\u002F [QUARKUS] Panache\nOptional\u003CMarket> market = Market.find(\"slug\", slug).firstResultOptional();\n\n\u002F\u002F PASS: Map\u002FflatMap instead of get()\nreturn market\n    .map(MarketResponse::from)\n    .orElseThrow(() -> new EntityNotFoundException(\"Market not found\"));\n```\n\n## Streams Best Practices\n\n```java\n\u002F\u002F PASS: Use streams for transformations, keep pipelines short\nList\u003CString> names = markets.stream()\n    .map(Market::name)\n    .filter(Objects::nonNull)\n    .toList();\n\n\u002F\u002F FAIL: Avoid complex nested streams; prefer loops for clarity\n```\n\n## Dependency Injection\n\n```java\n\u002F\u002F PASS: [SPRING] Constructor injection (preferred over @Autowired on fields)\n@Service\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Constructor injection\n@ApplicationScoped\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  @Inject\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Package-private field injection (acceptable in Quarkus — avoids proxy issues)\n@ApplicationScoped\npublic class MarketService {\n  @Inject\n  MarketRepository marketRepository;\n}\n\n\u002F\u002F FAIL: [SPRING] Field injection with @Autowired\n@Autowired\nprivate MarketRepository marketRepository; \u002F\u002F use constructor injection\n\n\u002F\u002F FAIL: [QUARKUS] @Singleton when interception or lazy init is needed\n@Singleton \u002F\u002F non-proxyable — use @ApplicationScoped instead\npublic class MarketService {}\n```\n\n## Reactive Patterns [QUARKUS]\n\n```java\n\u002F\u002F PASS: Return Uni\u002FMulti from reactive endpoints\n@GET\n@Path(\"\u002F{slug}\")\npublic Uni\u003CMarket> findBySlug(@PathParam(\"slug\") String slug) {\n  return Market.find(\"slug\", slug)\n      .\u003CMarket>firstResult()\n      .onItem().ifNull().failWith(() -> new MarketNotFoundException(slug));\n}\n\n\u002F\u002F PASS: Non-blocking pipeline composition\npublic Uni\u003COrderConfirmation> placeOrder(OrderRequest req) {\n  return validateOrder(req)\n      .chain(valid -> persistOrder(valid))\n      .chain(order -> notifyFulfillment(order));\n}\n\n\u002F\u002F FAIL: Blocking call inside a Uni\u002FMulti pipeline\npublic Uni\u003CMarket> find(String slug) {\n  Market m = Market.find(\"slug\", slug).firstResult(); \u002F\u002F BLOCKING — breaks event loop\n  return Uni.createFrom().item(m);\n}\n\n\u002F\u002F FAIL: Subscribing more than once to a shared Uni\nUni\u003CMarket> shared = fetchMarket(slug);\nshared.subscribe().with(m -> log(m));\nshared.subscribe().with(m -> cache(m)); \u002F\u002F double subscribe — use Uni.memoize()\n```\n\n## Exceptions\n\n- Use unchecked exceptions for domain errors; wrap technical exceptions with context\n- Create domain-specific exceptions (e.g., `MarketNotFoundException`)\n- Avoid broad `catch (Exception ex)` unless rethrowing\u002Flogging centrally\n\n```java\nthrow new MarketNotFoundException(slug);\n```\n\n### Centralised Exception Handling\n\n```java\n\u002F\u002F [SPRING]\n@RestControllerAdvice\npublic class GlobalExceptionHandler {\n  @ExceptionHandler(MarketNotFoundException.class)\n  public ResponseEntity\u003CErrorResponse> handle(MarketNotFoundException ex) {\n    return ResponseEntity.status(404).body(ErrorResponse.from(ex));\n  }\n}\n\n\u002F\u002F [QUARKUS] Option A: ExceptionMapper\n@Provider\npublic class MarketNotFoundMapper implements ExceptionMapper\u003CMarketNotFoundException> {\n  @Override\n  public Response toResponse(MarketNotFoundException ex) {\n    return Response.status(404).entity(ErrorResponse.from(ex)).build();\n  }\n}\n\n\u002F\u002F [QUARKUS] Option B: @ServerExceptionMapper (RESTEasy Reactive)\n@ServerExceptionMapper\npublic RestResponse\u003CErrorResponse> handle(MarketNotFoundException ex) {\n  return RestResponse.status(Status.NOT_FOUND, ErrorResponse.from(ex));\n}\n```\n\n## Generics and Type Safety\n\n- Avoid raw types; declare generic parameters\n- Prefer bounded generics for reusable utilities\n\n```java\npublic \u003CT extends Identifiable> Map\u003CLong, T> indexById(Collection\u003CT> items) { ... }\n```\n\n## Project Structure\n\n### [SPRING] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F\n  controller\u002F\n  service\u002F\n  repository\u002F\n  domain\u002F\n  dto\u002F\n  util\u002F\nsrc\u002Fmain\u002Fresources\u002F\n  application.yml\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n### [QUARKUS] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F              # @ConfigMapping, @ConfigProperty beans, Producers\n  resource\u002F            # JAX-RS resources (not \"controller\")\n  service\u002F\n  repository\u002F          # PanacheRepository implementations (if not using active record)\n  domain\u002F              # JPA\u002FPanache entities, MongoDB entities\n  dto\u002F\n  util\u002F\n  mapper\u002F              # MapStruct mappers (if used)\nsrc\u002Fmain\u002Fresources\u002F\n  application.properties   # Quarkus convention (YAML supported with quarkus-config-yaml)\n  import.sql               # Hibernate auto-import for dev\u002Ftest\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n## Formatting and Style\n\n- Use 2 or 4 spaces consistently (project standard)\n- One public top-level type per file\n- Keep methods short and focused; extract helpers\n- Order members: constants, fields, constructors, public methods, protected, private\n\n## Code Smells to Avoid\n\n- Long parameter lists → use DTO\u002Fbuilders\n- Deep nesting → early returns\n- Magic numbers → named constants\n- Static mutable state → prefer dependency injection\n- Silent catch blocks → log and act or rethrow\n- **[QUARKUS]**: `@Singleton` where `@ApplicationScoped` is intended — breaks proxying and interception\n- **[QUARKUS]**: Mixing `quarkus-resteasy-reactive` and `quarkus-resteasy` (classic) — pick one stack\n- **[QUARKUS]**: Panache active-record + repository pattern in the same bounded context — pick one\n\n## Logging\n\n```java\n\u002F\u002F [SPRING] SLF4J\nprivate static final Logger log = LoggerFactory.getLogger(MarketService.class);\nlog.info(\"fetch_market slug={}\", slug);\nlog.error(\"failed_fetch_market slug={}\", slug, ex);\n\n\u002F\u002F [QUARKUS] JBoss Logging (default, zero-cost at build time)\nprivate static final Logger log = Logger.getLogger(MarketService.class);\nlog.infof(\"fetch_market slug=%s\", slug);\nlog.errorf(ex, \"failed_fetch_market slug=%s\", slug);\n\n\u002F\u002F [QUARKUS] Alternative: simplified logging with @Inject\n@Inject\nLogger log; \u002F\u002F CDI-injected, scoped to declaring class\n```\n\n## Null Handling\n\n- Accept `@Nullable` only when unavoidable; otherwise use `@NonNull`\n- Use Bean Validation (`@NotNull`, `@NotBlank`) on inputs\n- **[QUARKUS]**: Apply `@Valid` on `@BeanParam`, `@RestForm`, and request body parameters\n\n## Configuration\n\n```java\n\u002F\u002F [SPRING] @ConfigurationProperties\n@ConfigurationProperties(prefix = \"market\")\npublic record MarketProperties(int maxPageSize, Duration cacheTtl) {}\n\n\u002F\u002F [QUARKUS] @ConfigMapping (type-safe, build-time validated)\n@ConfigMapping(prefix = \"market\")\npublic interface MarketConfig {\n  int maxPageSize();\n  Duration cacheTtl();\n}\n\n\u002F\u002F [QUARKUS] Simple values with @ConfigProperty\n@ConfigProperty(name = \"market.max-page-size\", defaultValue = \"100\")\nint maxPageSize;\n```\n\n## Testing Expectations\n\n### Shared\n- JUnit 5 + AssertJ for fluent assertions\n- Mockito for mocking; avoid partial mocks where possible\n- Favor deterministic tests; no hidden sleeps\n\n### [SPRING]\n- `@WebMvcTest` for controller slices, `@DataJpaTest` for repository slices\n- `@SpringBootTest` reserved for full integration tests\n- `@MockBean` for replacing beans in Spring context\n\n### [QUARKUS]\n- Plain JUnit 5 + Mockito for unit tests (no `@QuarkusTest`)\n- `@QuarkusTest` reserved for CDI integration tests\n- `@InjectMock` for replacing CDI beans in integration tests\n- Dev Services for database\u002FKafka\u002FRedis — avoid manual Testcontainers setup when Dev Services suffice\n- `@QuarkusTestResource` for custom external service lifecycle\n\n```java\n\u002F\u002F [SPRING] Controller test\n@WebMvcTest(MarketController.class)\nclass MarketControllerTest {\n  @Autowired MockMvc mockMvc;\n  @MockBean MarketService marketService;\n}\n\n\u002F\u002F [QUARKUS] Integration test\n@QuarkusTest\nclass MarketResourceTest {\n  @InjectMock\n  MarketService marketService;\n\n  @Test\n  void should_return_404_when_market_not_found() {\n    given().when().get(\"\u002Fmarkets\u002Funknown\").then().statusCode(404);\n  }\n}\n\n\u002F\u002F [QUARKUS] Unit test (no CDI, no @QuarkusTest)\n@ExtendWith(MockitoExtension.class)\nclass MarketServiceTest {\n  @Mock MarketRepository marketRepository;\n  @InjectMocks MarketService marketService;\n}\n```\n\n**Remember**: Keep code intentional, typed, and observable. Optimize for maintainability over micro-optimizations unless proven necessary.\n",{"name":5,"origin":24,"description":7},"ECC","main","481dcd7dd2e288b9d627a2bd017db70e64e6c6fa","core\u002Fskills\u002Fjava-coding-standards",2,"https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI","https:\u002F\u002Fyana.vutam.link\u002F","https:\u002F\u002Fgithub.com\u002FHoronomos-laps","https:\u002F\u002Fyana.vutam.link","An open-source governed runtime & execution environment for multi-agent AI systems.","2026-11-14 13:24:09",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add Horonomos-laps\u002FYana-AI --skill java-coding-standards",{"tool":41,"command":42},"bunx","bunx skills add Horonomos-laps\u002FYana-AI --skill java-coding-standards",{"tool":44,"command":45},"pnpm","pnpm dlx skills add Horonomos-laps\u002FYana-AI --skill java-coding-standards","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fjava-coding-standards\u002FSKILL.md",true,[],[50,58,65,73,81,89],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":54,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M735GKET5YVYKAY62W2P5YXB","openai--sentry--sentry","Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.","MIT","https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fopenai--sentry--sentry\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M73DCAP83T17HY7SMGK7MGFE","ito-basket-compare","Compare Itô prediction-market baskets against a user's knowledge base, portfolio notes, financial context, watchlist, or research thesis. Use for read-only basket comparison and gap analysis without investment advice or live trading.","https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fito-basket-compare\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M734CYEMZFDR3KH6SW0JP8TD","implementing-network-traffic-baselining","Build network traffic baselines from NetFlow\u002FIPFIX data using Python pandas for statistical analysis, z-score anomaly detection, and hourly\u002Fdaily traffic pattern profiling","https:\u002F\u002Fgithub.com\u002Fyanacuti1121\u002FYana-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fimplementing-network-traffic-baselining\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fimplementing-network-traffic-baselining\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":77,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M73ASZ6NJRJM44Z2P84NGQ3Q","detecting-evasion-techniques-in-endpoint-logs","Detects defense evasion techniques used by adversaries in endpoint logs including log tampering, timestomping, process injection, and security tool disabling. Use when investigating suspicious endpoint behavior, building detection rules for evasion tactics, or conducting threat hunting for stealthy adversary activity. Activates for requests involving evasion detection, defense evasion analysis, log tampering detection, or MITRE ATT&CK TA0005.","https:\u002F\u002Fgithub.com\u002Fyanacuti1121\u002FYana-AI\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fdetecting-evasion-techniques-in-endpoint-logs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fdetecting-evasion-techniques-in-endpoint-logs\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M734AFNXD06Z78QRK0VKGT7Q","implementing-microsegmentation-with-guardicore","Implementing microsegmentation using Akamai Guardicore Segmentation to map application dependencies, create granular network policies, visualize east-west traffic flows, and enforce least-privilege communication between workloads across data centers and cloud.","https:\u002F\u002Fgithub.com\u002Fyanacuti1121\u002FYana-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fimplementing-microsegmentation-with-guardicore\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fimplementing-microsegmentation-with-guardicore\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M736TK27QMCXK0DVCH25SJN5","ramdisk-tmpfs-patterns","https:\u002F\u002Fgithub.com\u002FHoronomos-laps\u002FYana-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Framdisk-tmpfs-patterns\u002FSKILL.md",[],[]]