rrezartprebreza/spring-boot-skills

해결하는 문제

AI 코딩 에이전트는 Spring Boot에서 자주 어려움을 겪으며, 구식 패턴을 환각하거나 프로젝트별 아키텍처 규칙을 무시하거나 잘못된 종속성 버전을 사용하는 경우가 많습니다. 이 프로젝트는 AI 에이전트가 일반적이거나 구식의 조언 대신 특정 프로덕션급 패턴과 규칙을 따르도록 안내하는 "스킬"—구조화된 Markdown 파일—라이브러리를 제공합니다.

작동 방식

사용자는 특정 스킬 폴더를 AI 에이전트의 구성 디렉토리(예: Claude Code의 .claude/skills/ 또는 Codex의 .codex/skills/)에 넣습니다. 이러한 스킬에는 트리거, 규칙 및 "함정"(일반적인 AI 실수와 수정 사항 목록)이 포함됩니다. 사용자가 에이전트에게 작업을 요청하면 에이전트는 요청을 스킬의 트리거와 일치시키고 관련 지침을 로드하여 생성된 코드가 팀의 아키텍처와 표준을 따르도록 합니다.

대상 독자

Spring Boot(버전 3.x 또는 4.x)를 사용하는 Java 개발자 및 아키텍트로, Claude Code나 Codex와 같은 AI 코딩 에이전트를 사용하여 높은 코드 품질과 아키텍처 일관성을 유지하면서 개발을 가속화하려는 분들.

주요 특징

• 버전별 지침: Spring Boot 3과 4를 위한 별도의 스킬 트리를 제공하여 최신 프레임워크 버전과의 호환성을 보장합니다.
• 코드화된 규칙: 계층형/헥사고날 아키텍처, REST API 설계, Spring Data JPA, Spring AI 통합 등 광범위한 도메인을 다룹니다.
• 환각 방지: 각 스킬에 전용 "함정" 섹션을 포함하여 일반적인 AI 실패를 기반으로 에이전트가 하지 말아야 할 것을 명시적으로 알려줍니다.
• 플러그인 지원: Claude Code 및 Codex용 마켓플레이스 플러그인으로 제공되어 설치가 쉽습니다.
• MCP 통합: Spring Boot 앱을 AI 에이전트에 연결하기 위한 Model Context Protocol (MCP) 서버 구축에 대한 지침을 제공합니다.