본문으로 건너뛰기
ElastiCORE 3.0 은 릴리스 후보(RC)입니다: Maven Central 의 3.0.261022-rc1. 2.2 라인 프로젝트는 2.2 문서를 보세요.
버전: 3.0

ElastiCORE 에이전트 키트

github.com/xsko/elasticore-agent-kit (Apache 2.0) - ElastiCORE 로 만든 프로젝트를 위한 Claude Code 플러그인입니다. 같은 스킬이 opencode 용으로도 묶여 있고 Codex CLI 에서도 동작합니다.

그냥 두면 에이전트는 생성된 Java 를 고칩니다. 다음 빌드가 그 수정을 덮어쓰거나, 그 파일이 조용히 YAML 을 따르지 않게 되고, 아무도 알아채지 못합니다. 키트가 있으면 에이전트는 YAML 을 고치고, 다시 생성하고, 컴파일하고, 업무에 무엇이 바뀌었는지 알려 줍니다.

에이전트가 Java 대신 쓰는 것​

키트의 게시판 레시피가 쓰는 게시글·댓글 API 의 모델(두 엔티티 중 하나):

entity:
  Post:
    meta: entity @root @editable @expose(20) @sort(postId-) -- post
    fields:
      postId:    long @id @sequence
      title:     string(100)! @notblank @search(like) -- title
      body:      text! @notblank -- body
      author:    string(30)! @notblank -- author name
      createdAt: datetime @updatable(false) @jpa:org.springframework.data.annotation.CreatedDate -- written at

빌드 한 번이 이것을 JPA 엔티티, 검증이 붙은 요청·응답 DTO, 리포지터리, 서비스, REST 컨트롤러 - 생성·조회·수정·삭제, 최신순 페이지 목록, 제목 일부 검색 - 그리고 400·404 를 답하는 오류 처리기로 바꿉니다. 에이전트는 모델이 말할 수 없는 것(다른 행을 보는 규칙, CRUD 에 없는 연산)만 Java 로, 그것도 생성기가 넘겨준 파일에만 씁니다.

들어 있는 것​

부분하는 일
스킬 elasticoreClaude 가 ElastiCORE 프로젝트에서 일하거나 새로 시작할 때 로드됩니다. 어느 파일이 생성기의 것인지 알고, 한 쪽짜리 DSL 참조, 세 레시피, 실행·확인 페이지를 갖고, 변경이 어디에 속하는지, 무엇을 먼저 묻는지, 어떻게 보고하는지 말합니다. 그 밖의 것은 ElastiCORE 가 프로젝트에 복사하는 가이드로 보냅니다.
훅생성 파일 수정과 -Pforce 실행을 막고, DSL 을 바꾼 뒤 무엇을 실행할지 알려 주고, 생성기의 경고를 전하고, 성공한 빌드가 생성·컴파일하지 않은 DSL 변경을 둔 채 끝내지 못하게 합니다.
에이전트 elasticore:modeler요구사항을 생성·컴파일되는 DSL 변경으로 바꾸고, 업무의 말로 보고합니다.
에이전트 elasticore:reviewer변경을 리뷰합니다: 생성 파일의 손 수정, 가이드나 생성기가 모르는 DSL, DSL 과 어긋난 생성 코드, 권한을 얻거나 잃는 역할.
/elasticore:generate [task]다시 생성·컴파일하고, 모든 경고·건너뛴 파일·오류를 DSL 수정과 함께 설명합니다.
/elasticore:change-report [range]DSL 변경이 업무에 무슨 뜻인지, 무엇을 결정해야 하는지 씁니다.
/elasticore:review [range] [full]커밋하지 않은 변경이나 범위에 reviewer 를 돌립니다. 읽기만 하고, full 을 붙이면 빌드도 합니다(파일이 다시 생성됨).

필요한 것​

  • Claude Code - 또는 opencode 나 Codex CLI.
  • JDK 17 이상. 새 프로젝트는 PATH 에 Gradle 8.14 이상: 템플릿이 그것으로 Gradle wrapper 를 만듭니다.
  • Windows 에서는 Git for Windows: 훅이 bash 로 돌고 Claude Code 는 Git Bash 로 실행합니다. 없으면 편집과 명령마다 훅 오류가 납니다.
  • Maven Central 의 ElastiCORE 3.0 - 새 프로젝트는 거기의 최신 3.x 릴리스를 씁니다. 2.x 프로젝트에서도 훅은 동작하지만, 참조와 레시피는 3.0 용입니다.

이 장의 내용​

플러그인의 현재 버전은 0.4.0 입니다.