AI-Driven Java Application
Development Methodology

UC 명세서 작성 스킬

도메인 설명을 Usecase 2.0 형식의 구조화된 명세서로 작성.
수준(--level)에 따라 Brief / Casual / Fully-dressed 산출.

SBE 시나리오 스킬

UC명세서.md를 읽어 Gherkin .feature 파일로 변환.
ddd-modeling과 병렬 실행 후 수렴 체크.

DDD 도메인 모델링 스킬

Step 1 BC 식별 → Step 2 Aggregate 설계 → Step 3 Command/Event 매핑 → Step 4 UL 사전 + 수렴 검증.

아키텍처 설계 스킬

Step 1 모듈 구조 → Step 2 BC 간 통신 → Step 3 어댑터 구조 → Step 4 공유 커널 위치.
Lombok 금지 규칙 포함.

비기능 요구사항 명세 스킬

성능·보안·가용성·운영성 4개 카테고리를 대화로 도출하고 arch-decisions.md의 ## NFR 섹션을 채운다.
코드 생성 지시를 AUTO(자동 생성)와 TODO(태그 주석)로 분류.

스켈레톤 생성 스킬

두 계약 파일을 입력으로 클래스/패키지 스켈레톤과 PlantUML 시퀀스 다이어그램 생성.
NFR AUTO 항목 클래스 포함. 추론 없는 1:1 매핑.

동기 ACL 패턴

즉각 응답이 필요한 BC 간 호출.
포트 인터페이스는 호출 BC의 application 레이어에 선언, 구현체는 구현 BC의 adapter 레이어에 위치. (Hexagonal 아키텍처 기준)
pom.xml에서 상호 직접 참조 없음.

// order/application/port/output/
public interface InventoryPort {
    void checkStock(ProductId id, int qty);
}

// inventory/adapter/outbound/
public class InventoryPortAdapter
    implements InventoryPort { ... }

비동기 Event 패턴

결과적 일관성으로 충분한 BC 간 통신.
Domain Event를 Kafka/RabbitMQ/Spring Events로 발행.
수신 BC는 ACL Translator로 자신의 도메인 모델로 변환.

// order → OrderPlaced → Kafka
// notification이 order.placed 구독

@KafkaListener(topics = "order.placed")
public void onOrderPlaced(
    OrderPlacedMessage msg) { ... }

UC 명세서 작성 커맨드

도메인 설명을 Usecase 2.0 형식으로 구조화.
기본 흐름·대안 흐름·예외 흐름·비기능 요구사항 포함.
/usecase-by-example의 필수 선행 커맨드.

/usecase "주문 관리 시스템"            # 기본값: casual
/usecase "주문 관리" --level casual
/usecase "주문 관리" --level fully-dressed

Gherkin 시나리오 변환 커맨드

UC명세서.md를 읽어 .feature 파일 생성.
파일 생략 시 UC명세서.md 자동 사용.
UC명세서.md 없으면 /usecase 실행을 안내하고 중단.

/usecase-by-example              # UC명세서.md 자동 읽기
/usecase-by-example order-uc.md  # 파일 지정

로컬 실행 커맨드

arch-decisions.md를 읽어 필요한 인프라를 Docker Compose로 기동하고 Spring Boot를 시작한다.
persistence/messaging 파라미터에 따라 compose 파일을 자동 구성한다.

/run-local                  # 전체 기동 (인프라 + 앱)
/run-local --infra-only     # Docker Compose만 기동
/run-local --bc order       # 특정 BC 모듈만 기동
/run-local --profile local  # 프로파일 명시 (기본값)

실행 상태 검증 커맨드

기동된 애플리케이션의 Run Gate 조건을 순서대로 확인한다.
실패 항목과 수정 방향을 함께 출력한다.

/run-check                  # 전체 Gate 확인
/run-check --verbose        # 상세 응답 포함 출력

BC 구현 커맨드

bc-plan.md + domain-context.md + arch-decisions.md를 읽어 Wave 순서대로 구현.
arch-decisions.md의 architecture 값(hexagonal|layered)에 따라 레이어 구조가 결정됨.
파일 없으면 즉시 중단.

/implement-bc order          # 전체
/implement-bc order domain   # 레이어 지정 (hexagonal: domain|application|adapter)
/implement-bc --wave 2       # Wave 일괄
/implement-bc --dry-run      # 실행 계획만
/implement-bc --check-plan   # 순환 의존 검사

테스트 생성 커맨드

Gherkin 시나리오 1:1 추적.
.feature 없으면 domain-context.md 에러 케이스 컬럼에서 도출.
arch-decisions.md의 messaging 파라미터를 읽어 계약 테스트 도구를 자동 선택.

/gen-test order              # 전체
/gen-test order application  # 레이어 지정
/gen-test order --contract   # BC 간 계약 테스트 (동기→SCC, 비동기→Pact 자동 분기)
/gen-test order --pbt        # Property-Based Testing (Jqwik, domain 레이어만)
/gen-test --e2e              # E2E 통합 시나리오
/gen-test --wave 2           # Wave 일괄

버전 동기화 확인

domain-context.md consumers 섹션과 content-version 비교.
재생성 필요 소비자 목록과 최소 실행 순서 출력.

Phase 2 커맨드

DB 스키마 생성 커맨드

arch-decisions.md ## Persistence 섹션을 읽어 Mermaid ERD(erd.mmd)와 DDL SQL(schema.sql)을 자동 생성합니다.
domain-context.md의 Aggregate → JpaEntity 매핑 규칙을 적용합니다.
persistence=jpa+jooq 시 schema.sql을 jOOQ codegen 입력으로 사용하여 Query Side Java 클래스를 빌드 타임에 생성합니다.

/gen-schema                   # 전체 BC ERD + DDL 생성
/gen-schema --bc order        # 특정 BC만 생성
/gen-schema --update          # 변경 내용만 반영 (MAJOR/MINOR)
/gen-schema --format flyway   # Flyway V1__init.sql 형식
/gen-schema --format liquibase # Liquibase XML 형식
/gen-schema --dry-run         # 생성 계획만 출력

Aggregate → JpaEntity 매핑 규칙

모듈 마이그레이션 커맨드

현재 아키텍처 구조를 진화시키는 3-Gate 커맨드.
분석 리포트 → 개발자 승인 → 실행 순으로 진행하며 arch-decisions.md 업데이트와 migration-log.md 생성을 자동 처리한다.

/migrate-module single-to-multi           # single → Maven 멀티모듈
/migrate-module split-bc {bc} {bc1} {bc2} # BC 분리
/migrate-module --dry-run single-to-multi  # 분석 리포트만
/migrate-module --status                   # 진행 상태 확인

지원 시나리오 및 산출물