AI Engineering

OAuth2 Resource Server configures Spring Boot as a stateless JWT resource server. Use it to validate tokens from providers like Keycloak, Auth0, Okta, or Cognito and map claims and scopes to authorization.

Problem Details RFC 9457 standardizes Spring Boot error responses with ProblemDetail for domain, validation, and server exceptions. Use it when implementing exception handlers or formatting API errors.

Resilience Retry helps add retries, backoff, and concurrency protection to Spring Boot 3 services. Use it when choosing Spring Retry or Resilience4j and when handling proxy and transaction limits.

Shep Implement validates feature specs and then executes implementation tasks from YAML with status tracking. Use it after planning is complete and you're ready to start coding.

Shep Planning creates implementation plans, architecture overviews, and task breakdowns after research is complete. Use it when turning a feature spec into TDD phases, files to change, and a YAML plan and task list.

Shep Research analyzes technical approaches, library choices, and architecture decisions for a feature. Use it after a new-feature spec when you need trade-offs, recommendations, and documentation in research.yaml.

Shep Workstreams breaks a large body of work into parallel workstreams, then drives shep CLI execution wave by wave. Use it when planning docs, roadmaps, or epics need to be turned into isolated features with clear dependencies.

Skyll searches for relevant agent skills at runtime and returns full SKILL.md content for context injection. Use it when a task needs specialized workflows or domain knowledge not already loaded.

Spring AI Integration shows how to add chat, prompts, embeddings, RAG, and structured output to Spring Boot apps. Use it when building AI features with Spring AI, ChatClient, vector stores, or Claude/OpenAI models.

Spring Data JPA helps generate JPA entities, repositories, and queries for the persistence layer. Use it for entity conventions, N+1 prevention, projections, pagination, and query patterns.

Spring HATEOAS adds hypermedia links to REST responses so APIs can be self-describing. Use it with EntityModel, CollectionModel, RepresentationModel, and paged collections in Spring Boot.

TSpec Model helps create, modify, and document TypeSpec domain models for Shep's Clean Architecture conventions. Use it when adding entities, value objects, enums, or working in the tsp/ directory.