Java Architect

What it does

When your agent uses it

• Setting up a new Spring Boot 3.x microservice on Java 21
• Tuning slow JPA queries and Hibernate mappings
• Configuring Spring Security with OAuth2 and JWT
• Writing reactive WebFlux endpoints without blocking calls
• Raising test coverage and verifying the build with Maven or Gradle

Example prompts

• “Create a Spring Boot 3 inventory service with records for DTOs and Flyway migrations.”
• “The orders list endpoint issues too many SQL queries, so find the JPA problem and fix it.”
• “Secure these endpoints with OAuth2 resource server settings and JWT validation.”
• “Port the product search controller to WebFlux and test it with TestContainers.”

Requirements

• A Java 21 JDK with Maven or Gradle

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Architecture analysis - Review project structure, dependencies, Spring config
2. 2Domain design - Create models following DDD and Clean Architecture; verify domain boundaries before proceeding. If boundaries are unclear…
3. 3Implementation - Build services with Spring Boot best practices
4. 4Data layer - Optimize JPA queries, implement repositories; run ./mvnw verify -pl to confirm query correctness. If integration tests fail…
5. 5Security & config - Apply Spring Security, externalize configuration, add observability; run ./mvnw verify after security changes to…
6. 6Quality assurance - Run ./mvnw verify (Maven) or ./gradlew check (Gradle) to confirm all tests pass and coverage reaches 85%+ before…

What it can do on your machine

Read from SKILL.md and the folder at commit 1be15d8. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are java).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • github.com
  • synergetic.solutions
  • jeffallan.github.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Java Architect loads about 1.5k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 362 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~95

When it runs · the whole SKILL.md, loaded when a task matches

~1.5k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~16k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Jeffallan/claude-skills at commit 1be15d8, republished under its MIT licence (© Jeffallan). 362 words, ~1,472 tokens.

name

java-architect

description

Use when building, configuring, or debugging enterprise Java applications with Spring Boot 3.x, microservices, or reactive programming. Invoke to implement WebFlux endpoints, optimize JPA queries and database performance, configure Spring Security with OAuth2/JWT, or resolve authentication issues and async processing challenges in cloud-native Spring applications.

license

MIT

metadata.author

https://github.com/Jeffallan

metadata.company

https://synergetic.solutions

metadata.version

1.1.0

metadata.domain

language

metadata.triggers

Spring Boot, Java, microservices, Spring Cloud, JPA, Hibernate, WebFlux, reactive, Java Enterprise

metadata.role

architect

metadata.scope

implementation

metadata.output-format

code

metadata.related-skills

fullstack-guardian, api-designer, devops-engineer, database-optimizer

@RestController
@RequestMapping("/api/v1/orders")
@RequiredArgsConstructor
public class OrderController {

    private final OrderService orderService;

    @GetMapping("/{id}")
    public Mono<ResponseEntity<OrderDto>> getOrder(@PathVariable UUID id) {
        return orderService.findById(id)
                .map(ResponseEntity::ok)
                .defaultIfEmpty(ResponseEntity.notFound().build());
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Mono<OrderDto> createOrder(@Valid @RequestBody CreateOrderRequest request) {
        return orderService.create(request);
    }
}

public interface OrderRepository extends JpaRepository<Order, UUID> {

    // Avoid N+1: fetch association in one query
    @Query("SELECT o FROM Order o JOIN FETCH o.items WHERE o.customerId = :customerId")
    List<Order> findByCustomerIdWithItems(@Param("customerId") UUID customerId);

    // Projection to limit fetched columns
    @Query("SELECT new com.example.dto.OrderSummary(o.id, o.status, o.total) FROM Order o WHERE o.status = :status")
    Page<OrderSummary> findSummariesByStatus(@Param("status") OrderStatus status, Pageable pageable);
}

@Configuration
@EnableMethodSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        return http
                .csrf(AbstractHttpConfigurer::disable)
                .sessionManagement(s -> s.sessionCreationPolicy(STATELESS))
                .authorizeHttpRequests(auth -> auth
                        .requestMatchers("/actuator/health").permitAll()
                        .anyRequest().authenticated())
                .oauth2ResourceServer(oauth2 -> oauth2.jwt(Customizer.withDefaults()))
                .build();
    }
}

© Jeffallan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/java-architect of Jeffallan/claude-skills.

• SKILL.md
• references/jpa-optimization.md
• references/reactive-webflux.md
• references/spring-boot-setup.md
• references/spring-security.md
• references/testing-patterns.md

Open the folder on GitHubat commit 1be15d8