Purpose

SEAS Framework is an enterprise-grade Spring Boot framework that provides modular microservices, starter modules, code generation capabilities, and comprehensive development tooling for building scalable applications.

This skill provides comprehensive documentation for:

•10 server microservices (healthy, storage, base, generate, job, message, mqtt, security, workflow, ai)
•4+ Spring Boot starter modules (core, data, cache, captcha)
•Framework patterns (annotations, utilities, holders, AOP, enums)
•Development workflow (build, testing, deployment, contribution)

When to Use

Use SEAS Framework when:

•Building enterprise Spring Boot applications with modular architecture
•You need code generation for CRUD operations
•Working with file storage, conversion, or IoT devices
•Implementing workflows, job scheduling, or messaging
•You need comprehensive security with national encryption (SM2, SM4)

AI tools reference this skill to:

•Understand SEAS module APIs and integration patterns
•Follow framework conventions and best practices
•Generate code aligned with SEAS architecture
•Avoid common pitfalls and anti-patterns

Directory Structure

code

seas-framework/
├── SKILL.md                 # Main skill document (this file)
└── references/              # Detailed documentation and guides
    ├── infrastructure/      # Skills system documentation
    │   └── overview.md
    ├── server-modules/      # 10 server microservices
    │   ├── healthy.md
    │   ├── storage.md
    │   ├── base.md
    │   ├── generate.md
    │   ├── job.md
    │   ├── message.md
    │   ├── mqtt.md
    │   ├── security.md
    │   ├── workflow.md
    │   └── ai.md
    ├── starter-modules/     # Spring Boot starters
    │   ├── core.md
    │   ├── data.md
    │   ├── cache.md
    │   └── captcha.md
    ├── patterns/            # Framework patterns
    │   ├── annotations.md
    │   ├── utilities.md
    │   ├── holders.md
    │   ├── aop.md
    │   └── enums.md
    └── workflow/            # Development workflow
        ├── project-structure.md
        ├── build.md
        ├── code-generation.md
        ├── testing.md
        ├── configuration.md
        ├── setup.md
        ├── deployment.md
        └── contributing.md

Component to Skills Mapping

When working with...	Reference these skills
Health check endpoints	`references/server-modules/healthy.md`
File upload/download	`references/server-modules/storage.md`
User authentication	`references/server-modules/base.md`, `references/patterns/annotations.md`
Code generation	`references/server-modules/generate.md`, `references/workflow/code-generation.md`
Scheduled tasks	`references/server-modules/job.md`, `references/patterns/annotations.md`
Email/SMS messaging	`references/server-modules/message.md`
IoT devices	`references/server-modules/mqtt.md`
Security/permissions	`references/server-modules/security.md`, `references/patterns/annotations.md`
Workflows	`references/server-modules/workflow.md`
AI features	`references/server-modules/ai.md`
Adding to Spring Boot app	`references/starter-modules/*.md`
Framework annotations	`references/patterns/annotations.md`
Utility methods	`references/patterns/utilities.md`
Testing	`references/workflow/testing.md`, `references/patterns/aop.md`
Building/deploying	`references/workflow/build.md`, `references/workflow/deployment.md`

Setup for AI Tools

Claude Code

Claude Code automatically discovers the skills/seas-framework/ directory and loads relevant skills based on the current context.

GitHub Copilot

Copilot Workspace references the skills directory when analyzing code. Ensure the .github/copilot-instructions.md file includes a reference to these skills.

Cursor

Cursor's context system automatically includes markdown files in the skills/seas-framework/ directory when working with SEAS code.

Other Tools

For other AI coding tools, configure the project context to include the skills/seas-framework/references/ directory in documentation/analysis scope.

Contributing

When adding new features or modifying framework behavior, update the relevant skills to keep AI tools synchronized with the codebase. See references/workflow/contributing.md for the skills update checklist.

Maintenance

Skills track the main branch. They should be updated whenever framework code changes that affect documented APIs, patterns, or behaviors. For maintenance workflow, see references/workflow/contributing.md.

Prerequisites

•Java 17 or higher
•Spring Boot 3.x
•Maven 3.8+
•MySQL/PostgreSQL (for data storage)
•Redis (for caching)
•(Optional) MinIO (for file storage)
•(Optional) MQTT broker (for IoT features)