Skip to content

Java Architect

Guides building, configuring, and debugging Spring Boot 3.x enterprise Java apps, including WebFlux, JPA, and Spring Security.

Stars
12,176
Licence
MIT
Files
6 files

What it does

When installed, this skill tells an AI coding agent to act like a senior Java architect for Spring Boot 3.x projects on Java 21. It shapes the agent's work toward reactive WebFlux endpoints, tuned JPA queries (for example avoiding N+1 fetches), Spring Security with OAuth2/JWT, and tests with JUnit 5 and Testcontainers, aiming for 85%+ coverage. It also includes reference notes the agent loads on demand for setup, reactive code, data access, security, and testing.

Great for

  • Java developers building or maintaining Spring Boot 3.x microservices
  • Teams adding OAuth2/JWT security or reactive WebFlux endpoints to an existing Spring app
  • Developers debugging slow JPA queries or failing Spring Security filter chains

Skip it if

  • Non-Java projects, since the guidance is specific to Spring and the JVM
  • Production security decisions made without review: generated security configuration (CSRF disabled, stateless JWT) must be checked by a qualified engineer
  • Projects that cannot run Maven or Gradle builds, since the workflow depends on running ./mvnw verify or ./gradlew check

Try asking

  • “Add a reactive WebFlux endpoint for creating and fetching orders with validation”
  • “Find and fix N+1 query problems in my Spring Data JPA repositories”
  • “Configure Spring Security as an OAuth2 resource server with JWT for my microservice”
  • “Set up JUnit 5 and Testcontainers tests for my service layer and check JaCoCo coverage”
Step-by-step guide: how to use Java ArchitectInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 6 original files, the MIT licence and an attribution note.

    java-architect.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip java-architect.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip java-architect.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the agent at a specific module (for example ./mvnw verify -pl <module>) so builds and tests stay fast and focused.
  • Review generated SecurityFilterChain and JWT configuration yourself before deploying, since the example disables CSRF and uses stateless sessions.
  • Ask for the specific reference topic you need (JPA tuning, WebFlux, security) so the agent loads the matching detailed guidance.

What's inside

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

Redistributed unmodified from Jeffallan/claude-skills under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.