model-domain

Files (2)

• SKILL.md
• ubiquitous-language.md · templates/

SKILL.md (first lines)

# Skill: Model Domain

## 목적

도메인의 **유비쿼터스 언어**를 정의하고 서술형 명세로 작성

**철학**: "ERD 그리기 말고, 말로 설명하기"

---

## 입력

- 도메인 이름 (예: "users")
- Phase 2 결과 (SESSION.md의 완전한 도메인 정의)

---

## 출력

- `ai-context/domain-books/{domain}/domain-model.md`
- 용어 정의 + 관계 규칙 + 제약 조건 + 생명주기

---

## 유비쿼터스 언어란?

**해당 도메인 전용이면서 개발자가 쉽게 이해할 수 있는 전용 언어**

### ❌ 잘못된 접근 (ERD)

```
┌─────────┐        ┌──────────────┐
│  User   │───1:N──│ Translation  │
└─────────┘        └──────────────┘
```

### ✅ 올바른 접근 (유비쿼터스 언어)

```
"사용자는 여러 개의 번역 기록을 가질 수 있다."
"번역 기록은 반드시 한 명의 사용자에게 속한다."
```

---

## 작동 방식

### 1. 용어 추출

SESSION.md에서 해당 도메인의 엔티티와 속성을 읽고, 각 개념을 한글 용어로 정의한다:

```
SESSION.md → users 도메인:
  속성: ID, Email, DisplayName, ProfileImage, PreferredLanguage, CreatedAt

용어 정의:
  사용자 (User)             — 앱을 사용하는 개인
  식별자 (ID)               — 사용자를 고유하게 구분하는 값
  이메일 (Email)            — 로그인 및 연락용 이메일 주소
  표시 이름 (DisplayName)   — 다른 사용자에게 보이는 이름
  프로필 사진 (ProfileImage) — 사용자의 프로필 이미지 경로
  선호 언어 (PreferredLanguage) — 사용자가 선호하는 언어 설정
  가입 시각 (CreatedAt)     — 사용자가 가입한 날짜와 시간
```

### 2. 관계 규칙 생성

SESSION.md의 관계 정의를 서술형 문장으로 변환한다:

```
1:N 관계 (User → Translation):
  "사용자는 여러 개의 번역 기록을 가질 수 있다."
  "번역 기록은 반드시 한 명의 사용자에게 속한다."
  "사용자가 삭제되면 모든 번역 기록도 함께 삭제된다."
```

### 3. 제약 조건 추출

SESSION.md의 제약 정의를 자연어로 변환한다:

```
Email Unique → "이메일 (Email)은 중복될 수 없다."
ID 자동생성 → "식별자 (ID)는 시스템이 자동으로 생성한다."
```

### 4. 생명주기 정의

생성·수정·삭제 각 단계를 단계별 흐름도로 작성한다.

---

## domain-model.md 구조

```markdown
# {domain} 도메인 모델

> 생성일: {오늘 날짜}
> Phase: 3 (Domain Modeler)
> 상태: ✅ 완료

---

## 📖 유비쿼터스 언어 (용어 정의)

> 이 도메인에서 사용하는 전용 용어들

### 핵심 용어

| 용어 | 정의 | 예시 |
|------|------|------|
| 사용자 (User) | 앱을 사용하는 개인 | "홍길동", "john@example.com" |
| 식별자 (ID) | 사용자를 고유하게 구분하는 값 | "u_123abc" |
| ... | ... | ... |

---

## 📐 관계 규칙

> 이 도메인의 엔티티들이 어떻게 연결되는지 서술형으로 정의

From ureca-corp/claude, MIT.

More from ureca-corp/claude