name: spring-boot-full-stack
version: 1.0.0
description: |
Complete Java Spring Boot skill set for building enterprise applications.
Includes modular architecture with optional components:
- PostgreSQL database with JPA/Hibernate + Flyway migration
- Redis caching (optional)
- Kafka/RabbitMQ messaging (optional, choose one)
- JWT + OAuth2 authentication (optional OAuth2)
- RBAC authorization (optional)
- TDD with Mockito
- Spec-First Development with OpenSpec

author: Expert Panel (AI Generated)
tags:
- java
- spring-boot
- postgresql
- redis
- kafka
- rabbitmq
- authentication
- security
- tdd
- openspec

triggers:
- "spring boot project"
- "java backend"
- "microservice"
- "api development"
- "enterprise application"

dependencies: []

Spring Boot Full Stack Skill

Overview

This skill provides a complete, modular framework for building Java Spring Boot applications with enterprise-grade features.

Quick Start

# Minimal setup (PostgreSQL + JWT only)
mvn clean install -Pminimal

# With Redis caching
mvn clean install -Dmodule.redis.enabled=true

# Full stack (all modules)
mvn clean install -Pfull-stack

# Run application
mvn spring-boot:run -Dspring-boot.run.profiles=local

Module Selection

Development Workflow

1. Spec First: Define specifications in openspec/specs/
2. TDD: Write tests first (RED)
3. Implement: Write minimal code (GREEN)
4. Refactor: Improve code quality
5. Archive: Update specs after implementation

Docker Options

# Without Docker (services installed locally)
make dev

# With Docker infrastructure
make dev-docker

# Full Docker deployment
docker compose --profile with-app up -d

Skills Included

Core (Always enabled)

• spring-project-init - Project initialization
• spring-maven-modular - Maven profiles & BOM
• spring-error-handling - Global exception handling
• spring-validation - Request validation
• spring-logging - Structured logging
• spring-testing - Unit + Integration testing
• spring-tdd-mockito - TDD with Mockito
• spring-openspec - Spec-First Development

Optional

• spring-redis - Redis caching
• spring-kafka - Kafka messaging
• spring-rabbitmq - RabbitMQ messaging
• spring-oauth2 - OAuth2/OIDC
• spring-rbac - Role-based access control
• spring-docker - Docker containerization
• spring-api-docs - OpenAPI/Swagger
• spring-monitoring - Actuator + Prometheus

File Structure

src/
├── main/
│   ├── java/
│   │   └── com/company/app/
│   │       ├── config/           # Configuration classes
│   │       ├── controller/       # REST controllers
│   │       ├── service/          # Business logic
│   │       ├── repository/       # Data access
│   │       ├── domain/           # Entities
│   │       ├── dto/              # Data transfer objects
│   │       ├── exception/        # Custom exceptions
│   │       └── security/         # Security configuration
│   └── resources/
│       ├── application.yml
│       ├── application-local.yml
│       ├── application-dev.yml
│       ├── application-prod.yml
│       └── db/migration/         # Flyway migrations
├── test/
│   └── java/
│       └── com/company/app/
│           ├── unit/             # Unit tests
│           └── integration/      # Integration tests
└── openspec/
    ├── AGENTS.md
    ├── specs/                    # Feature specifications
    └── changes/                  # Proposed changes

References

• Anthropic Skills Specification
• OpenSpec - Spec-Driven Development
• Spring Boot Documentation