[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7APYK4DTR2QR5GC8G0XRWCW":3,"skill-same:01M7APYK4DTR2QR5GC8G0XRWCW":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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7APYK4DTR2QR5GC8G0XRWCW","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. Use when writing or reviewing Java in a Spring Boot or Quarkus service.","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fskills\u002Fjava-coding-standards\u002FSKILL.md",[],[],"2026-11-15 14:19:17",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. Use when writing or reviewing Java in a Spring Boot or Quarkus service.\"\nmetadata:\n  origin: 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,"metadata":24,"description":7},{"origin":25},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fskills\u002Fjava-coding-standards",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill java-coding-standards",{"tool":41,"command":42},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill java-coding-standards",{"tool":44,"command":45},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill java-coding-standards","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fskills\u002Fjava-coding-standards\u002FSKILL.md",true,[],[50,59,66,74,81,88],{"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":55,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":54,"licenseFileUrl":70,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\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":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":54,"licenseFileUrl":92,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]