ened/little-fairy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add main character prompt guide

Browse Source
This commit is contained in:
ened
2025-08-23 11:46:14 +09:00
parent cd48f95fe9
commit 6a928c9b64
3 changed files with 422 additions and 215 deletions
Download Patch File Download Diff File Expand all files Collapse all files

215
moon/claude.md
View File

@@ -1,215 +0,0 @@
# 프로젝트 개요
- **게임 제목**: Little Fairy (작은 선녀)
- **장르**: 생명 시뮬레이션 RPG
- **타겟 플랫폼**: Windows
- **개발 엔진**: Godot 4.4.1
- **주 언어**: C#
- **핵심 경험**: "살아있음의 기쁨"과 "생명의 연속성" 체험
# 현재 개발 상태
- **버전**: v0.0.1
- **마지막 업데이트**: 2025-08-15
- **현재 작업 중인 기능**: 디자인 문서 완성 (업데이트 완료)
- **다음 마일스톤**: Phase 1 - 기반 시스템 구축 시작
# 핵심 게임 컨셉
## 혁신적 매듭 시스템
**노리개 연결 구조**: 매듭들이 하나의 연속된 실로 연결되어 노리개 형태 구성. **연결 순서에 따라 완전히 다른 스킬과 능력 조합 발현**이 핵심 혁신점.
예시:
- "국화매듭 → 물결매듭 → 웃음매듭" = "치유하는 웃음" 스킬
- "웃음매듭 → 물결매듭 → 국화매듭" = "기쁨의 가르침" 스킬
## 생명의 동반자 시스템
4단계에서 가장 깊은 인연과의 결합 선택. 6가지 동반자 유형 + 독립적 완성 경로:
1. 연인/배우자 2. 영혼의 벗 3. 스승/제자 4. 수호 관계 5. 창조적 파트너 6. 혼자서 완성
## 주요 시스템
- [x] 게임 디자인 문서 완성 (프로토타입 기반 개정)
- [x] 시스템 설계 명세서 완성 (매듭 연결 순서 시스템 포함)
- [x] 개발 로드맵 수립 (24개월 상세 계획)
- [ ] 생애주기 시스템 (LifeCycleManager)
- [ ] 선녀의 별자리 유전 시스템 (DNAPoolManager → StellarDNA)
- [ ] 매듭 시스템 (KnotSystem) - 연결 순서 기반 스킬 생성
- [ ] 생명의 동반자 시스템 (CompanionSystem)
- [ ] 노드 기반 맵 시스템 (MapManager)
- [ ] 위험 요소 및 사망 시스템 (RiskManager)
# 시나리오 1: "치유의 노래" 상세 콘텐츠
## 등장인물 (14명)
### Map A: 꽃마루 (4명)
1. **할머니 달빛** (75세) - 스승/제자 관계
2. **소년 해찬** (12세) - 영혼의 벗 관계
3. **나무꾼 석주** (45세) - 연인/수호자 관계
4. **꽃신 정령 꽃님** (나이불명) - 창조적 파트너 관계
### Map B: 물소리 벌판 (4명)
5. **농부 철수** (38세) - 실용적 조력자
6. **용왕 미르** (1000세) - 연인/창조적 파트너 관계
7. **의원 혜련** (52세) - 스승/창조적 파트너 관계
8. **청년 준호** (28세) - 연인/창조적 파트너 관계
### Map C: 단풍골 (5명)
9. **한옥 보존가 영숙** (68세) - 스승/제자 관계
10. **환경운동가 민수** (35세) - 영혼의 벗/창조적 파트너
11. **예술가 소희** (29세) - 창조적 파트너 관계
12. **기업인 태영** (42세) - 인생 동반자 관계
13. **도시 수호신 한울** (500세) - 신령 동맹 관계
### Map D: 백설봉 (1명 + 최종 동반자 선택)
14. **산신령 설봉** (나이불명) - 최종 깨달음 제공자
## 매듭 시스템 (24종)
### 시나리오 1 특화 매듭 (16종)
- **Map A**: 꽃매듭, 웃음매듭, 뿌리매듭, 달빛매듭
- **Map B**: 물결매듭, 자비매듭, 희망매듭, 땀방울매듭
- **Map C**: 전통매듭, 갈등매듭, 예술매듭, 성찰매듭
- **Map D**: 전승매듭, 완성매듭, 평화매듭, 순환매듭
### 공통 기본 매듭 (8종)
생명매듭, 시간매듭, 기억매듭, 선택매듭, 성장매듭, 연결매듭, 순환매듭, 감사매듭
# 기술적 아키텍처
## 코어 시스템 설계
- **GameManager**: 게임 전반 관리 및 씬 전환
- **LifeCycleManager**: 4단계 생애주기 관리 (어린선녀→성장→성숙→지혜)
- **DNAPoolManager**: 선녀의 별자리 시스템 (StellarDNA 구조)
- **RelationshipManager**: 인연 형성 및 발전 관리
- **KnotSystem**: 매듭 연결 순서 기반 스킬 생성
- **CompanionSystem**: 생명의 동반자 시스템
- **MapManager**: 4개 맵의 노드 기반 이동
- **RiskManager**: 생애주기별 위험 요소 관리
- **EventManager**: 이벤트 기반 통신
## 핵심 데이터 구조
```csharp
public class StellarDNA // 선녀의 별자리
{
public Dictionary<string, float> Attributes { get; set; }
public List<Knot> Knots { get; set; }
public List<KnotConnection> KnotConnections { get; set; } // 연결 순서 중요!
public CompanionBond CompanionBond { get; set; }
public int Generation { get; set; }
public float QualityRating { get; set; }
}
public class KnotConnection
{
public string FromKnotId { get; set; }
public string ToKnotId { get; set; }
public int Order { get; set; } // 연결 순서가 스킬 결정
public float Strength { get; set; }
}
```
## 코딩 컨벤션
- 클래스명: PascalCase
- 메서드명: PascalCase
- 변수명: camelCase
- 상수: UPPER_SNAKE_CASE
- 프라이빗 필드: _camelCase
# 맵 및 콘텐츠 구조
## 4개 주요 맵 (시나리오 1)
- **Map A (봄)**: 꽃마루 - 어린 선녀 시기 (7개 노드)
- **Map B (여름)**: 물소리 벌판 - 성장기 선녀 (12개 노드)
- **Map C (가을)**: 단풍골 - 성숙기 선녀 (16개 노드)
- **Map D (겨울)**: 백설봉 - 지혜의 시기 (20개 노드)
## 노드 기반 이동 시스템
클릭 기반 즉시 이동으로 복잡한 이동 메커니즘 배제. 스토리와 관계에 집중.
# 개발 로드맵 (24개월)
## Phase 1: 핵심 시스템 구축 (3개월)
- Month 1: 기본 아키텍처 및 생애주기 시스템
- Month 2: 노드 기반 맵 시스템
- Month 3: 기본 매듭 시스템
## Phase 2: 시나리오 1 기본 콘텐츠 (6개월)
- Month 4: Map A 완전 구현
- Month 5: Map B 구현
- Month 6: Map C 구현
- Month 7-8: 생명의 동반자 시스템
- Month 9: 선녀의 별자리 시스템
## Phase 3: 완성도 향상 (3개월)
- Month 10: 위험 시스템 및 사망 처리
- Month 11: UI/UX 완성
- Month 12: 밸런싱 및 최적화
## Phase 4: 확장 시나리오 (9개월)
- Month 13-15: 시나리오 2 "모험의 날개"
- Month 16-18: 시나리오 3 "지혜의 탑"
- Month 19-21: 혼합 시나리오 시스템
## Phase 5: 출시 준비 (3개월)
- Month 22: 최종 완성 및 마스터링
- Month 23: 정식 출시 및 초기 대응
- Month 24: 사후 지원 및 확장 계획
# 확장 시나리오 계획
- **시나리오 2**: "모험의 날개" (14명 추가, 16종 모험 매듭)
- **시나리오 3**: "지혜의 탑" (14명 추가, 16종 지혜 매듭)
- **혼합 시나리오**: 생애주기 4단계에서 시나리오 조합
# Claude 협업 가이드라인
## 요청할 때 포함해야 할 정보
1. **현재 작업 컨텍스트**: 어떤 기능을 구현 중인지
2. **관련 파일**: 수정이 필요한 파일들
3. **요구사항**: 구체적인 기능 명세
4. **제약사항**: 성능, 메모리, 호환성 등
## 중요한 설계 원칙
1. **매듭 연결 순서가 스킬을 결정**: 같은 매듭도 순서에 따라 다른 능력
2. **생명의 동반자는 선택사항**: 혼자서도 완전한 생애 가능
3. **1시간 압축 생애**: 집중도 높은 완성된 경험 제공
4. **한국적 정서**: 전통 문화의 현대적 재해석
## 프로토타입 참고 문서
- **prototype/scenarioA1/**: Map A-D 상세 설계
- **prototype/매듭_시스템_설계_v2.md**: 노리개 연결 시스템
- **prototype/생명의_동반자_시스템_설계.md**: 동반자 시스템
- **prototype/위험요소_사망시스템_설계.md**: 사망 처리
## 코드 리뷰 요청 시
- 전체 코드보다는 특정 기능 단위로 요청
- 의도한 동작과 실제 문제점 명시
- 관련 테스트 케이스 함께 제공
## 디버깅 요청 시
- 에러 메시지 전문 포함
- 재현 단계 상세히 기술
- 예상 동작 vs 실제 동작 비교
# 개발 우선순위
1. **최우선**: 매듭 연결 순서 시스템 (핵심 혁신)
2. **높음**: 생애주기 및 인연 시스템
3. **중간**: UI/UX 개선
4. **낮음**: 부가 기능, 최적화
# 성공 지표
## 경험 목표 달성도
- 플레이어가 "살아있음의 기쁨"을 느끼는가?
- 매듭 시스템이 의미있고 아름답게 작동하는가?
- 동반자 시스템이 감동을 주는가?
- 세대 연결에서 연속성을 체험하는가?
## 기술적 목표
- 1시간 플레이 세션의 완성도
- 매듭 연결 순서 시스템 안정성
- 선녀의 별자리 세대 전승 정확성
- 직관적이고 아름다운 UI
# 테스트 전략
- **Unit Test**: 매듭 연결 로직, 스킬 생성 시스템
- **Integration Test**: 시스템 간 연동 (인연→매듭→스킬)
- **Play Test**: 1시간 완주 경험, 감정적 몰입도
- **Cultural Test**: 한국 문화 요소의 정확성과 자연스러움
---
**업데이트 기록**:
- 2025-08-15: 프로토타입 기반 문서 대폭 개정
- 매듭 연결 순서 시스템 상세 추가
- 생명의 동반자 시스템 통합
- 시나리오 1 상세 콘텐츠 반영
- 24개월 개발 로드맵 수립

321
moon/docs/development/prompt/main-character.md Normal file
View File

@@ -0,0 +1,321 @@
# Little Fairy - 메인 캐릭터 AI 이미지 생성 가이드라인
## 📖 개요
이 문서는 "작은 선녀" 게임의 Spine 2D 캐릭터 시스템을 위한 AI 이미지 생성 전용 가이드라인입니다. Google Imagen 4를 활용하여 2048x2048 픽셀 크기의 4x4 그리드 이미지를 생성하고, 각 영역에 정확히 1개의 캐릭터 파트를 배치하여 총 16개의 이미지 세그먼트를 생산하는 것을 목표로 합니다.
---
## 🎯 핵심 설계 원칙
### 1. 이미지 규격 및 구성
- **전체 이미지 크기**: 2048x2048 픽셀 (1:1 비율)
- **그리드 구성**: 4x4 = 16개 영역
- **개별 영역 크기**: 512x512 픽셀
- **각 영역 내용**: 정확히 1개의 캐릭터 파트만 배치
- **배경**: 투명 또는 단색 배경으로 분리 용이성 확보
### 2. 게임 세계관 반영
- **한국 전통 미학**: 선녀 설화 기반의 동양적 아름다움
- **생애주기 시스템**: 4단계 성장 과정 (어린 선녀 → 지혜의 선녀)
- **계절감**: 봄(어린 시절) → 겨울(지혜의 시기)
- **매듭 시스템**: 한국 전통 매듭공예 요소 반영
- **"살아있음의 기쁨"**: 생명력 넘치는 표현
### 3. Spine 2D 최적화
- **모듈형 설계**: 독립적으로 분리 가능한 파츠
- **리깅 고려**: 관절과 변형 지점 명확화
- **애니메이션 호환**: 자연스러운 움직임을 위한 파트 구성
- **레이어 구조**: Z-order 고려한 파트 분리
---
## 👤 메인 캐릭터 스펙
### 기본 외형 특징 (일관성 유지 필수)
```
핵심 얼굴 특징 (절대 고정):
- 한국인 전통 미인 외모
- 타원형 얼굴 (oval face)
- 큰 표현력 있는 짙은 갈색 눈, 쌍꺼풀
- 부드러운 분홍색 입술
- 일반적인 인간 귀 (뾰족한 귀 금지)
- 매우 창백한 도자기 같은 흰 피부, 신성한 광택
- 긴 흘러내리는 검은 머리카락, 천상의 장식품
체형 특징:
- 우아한 비율의 날씬한 몸매
- 창백한 흰 다리
- 온몸에 설백색의 빛나는 피부
```
### 생애주기별 특성
#### Stage 1: 어린 선녀 (봄, 0-15분)
- **외관 나이**: 12-15세 외모
- **특징**: 작고 귀여운 체형, 순수하고 호기심 많은 표정
- **의상**: 연한 초록색과 분홍색 봄 한복
- **머리 장식**: 작은 꽃잎 장식
- **크기 비율**: 0.7배 스케일
#### Stage 2: 성장기 선녀 (여름, 15-30분)
- **외관 나이**: 16-22세 외모
- **특징**: 길어진 체형, 활발하고 생기발랄한 표정
- **의상**: 하늘색과 비취색 여름 한복
- **머리 장식**: 여름 꽃과 나비 장식
- **크기 비율**: 0.85배 스케일
#### Stage 3: 성숙기 선녀 (가을, 30-45분)
- **외관 나이**: 25-32세 외모
- **특징**: 우아하고 성숙한 체형, 지혜로운 표정
- **의상**: 따뜻한 주황색과 단풍 무늬 가을 한복
- **머리 장식**: 단풍잎과 정교한 비녀
- **크기 비율**: 1.0배 스케일
#### Stage 4: 지혜기 선녀 (겨울, 45-60분)
- **외관 나이**: 37-42세 외모 (노인 아님)
- **특징**: 품격 있고 완성된 체형, 평온하고 자애로운 표정
- **의상**: 깊은 보라색과 은색 겨울 한복, 겨울 외투
- **머리 장식**: 설화 무늬와 고급 장신구
- **크기 비율**: 1.0배 스케일
---
## 🎨 4x4 그리드 구성 전략
### 그리드 레이아웃 (512x512 각 영역)
```
┌─────────┬─────────┬─────────┬─────────┐
│ A1 │ A2 │ A3 │ A4 │
│ 얼굴1 │ 얼굴2 │ 얼굴3 │ 얼굴4 │
│ (기본) │ (기쁨) │ (슬픔) │ (놀람) │
├─────────┼─────────┼─────────┼─────────┤
│ B1 │ B2 │ B3 │ B4 │
│ 몸통 │ 왼팔 │ 오른팔 │ 손 세트 │
│ (기본) │ │ │ │
├─────────┼─────────┼─────────┼─────────┤
│ C1 │ C2 │ C3 │ C4 │
│ 왼다리 │ 오른다리│ 발 세트 │ 헤어1 │
│ │ │ │ (기본) │
├─────────┼─────────┼─────────┼─────────┤
│ D1 │ D2 │ D3 │ D4 │
│ 헤어2 │ 한복 │ 액세서리│ 특수 │
│ (장식) │ 세트 │ 세트 │ 효과 │
└─────────┴─────────┴─────────┴─────────┘
```
### 각 영역별 상세 구성
#### 첫 번째 행 (A1-A4): 얼굴 표정 세트
- **A1**: 기본 중성 표정 (정면 약간 옆각도)
- **A2**: 기쁨/행복 표정 (밝은 미소, 반짝이는 눈)
- **A3**: 슬픔/걱정 표정 (약간 내려간 눈썹, 살짝 다운된 입)
- **A4**: 놀람/호기심 표정 (둥근 눈, 살짝 벌어진 입)
#### 두 번째 행 (B1-B4): 바디 파츠
- **B1**: 메인 몸통 (목 아래 몸체, 기본 포즈)
- **B2**: 왼팔 (팔꿈치 관절 포함, 자연스러운 각도)
- **B3**: 오른팔 (팔꿈치 관절 포함, 다른 각도)
- **B4**: 손 세트 (펼친 손, 주먹, 가리키는 손, 마법 포즈)
#### 세 번째 행 (C1-C4): 하체 및 헤어
- **C1**: 왼다리 (무릎 관절 포함, 자연스러운 포즈)
- **C2**: 오른다리 (무릎 관절 포함, 다른 각도)
- **C3**: 발 세트 (맨발, 신발 신은 발, 다양한 각도)
- **C4**: 기본 헤어스타일 (긴 흑발, 자연스러운 흘러내림)
#### 네 번째 행 (D1-D4): 장식 및 특수 요소
- **D1**: 장식 헤어 (계절별 머리 장식, 비녀, 꽃장식)
- **D2**: 한복 세트 (저고리, 치마, 계절별 색상)
- **D3**: 액세서리 세트 (노리개, 팔찌, 목걸이, 매듭 장식)
- **D4**: 특수 효과 (날개, 마법 오라, 빛 효과, 꽃잎)
---
## 📝 프롬프트 작성 가이드라인
### 기본 프롬프트 구조
#### 필수 고정 요소 (모든 생성에 포함)
```
Beautiful Korean traditional fairy character for 2D game, 2048x2048 pixel image with 4x4 grid layout (512x512 each section), one character part per section, traditional Korean beauty with oval face, large expressive dark brown eyes with double eyelids, soft pink lips, normal human ears, very pale porcelain white skin with divine glow, long flowing black hair, traditional Korean fairy aesthetics, clean separated parts for Spine 2D animation, transparent or solid color background for easy extraction, anime/manhwa art style
```
#### 생애주기별 수정자
- **Stage 1**: `age 12-15 appearance, small cute proportions, innocent curious expression, 0.7x scale`
- **Stage 2**: `age 16-22 appearance, growing teenage proportions, energetic bright expression, 0.85x scale`
- **Stage 3**: `age 25-32 appearance, elegant mature proportions, wise graceful expression, 1.0x scale`
- **Stage 4**: `age 37-42 appearance, dignified mature proportions (not elderly), serene benevolent expression, 1.0x scale`
#### 계절별 색상 팔레트
- **봄 (Stage 1)**: `light green and soft pink spring colors, flower petal decorations`
- **여름 (Stage 2)**: `sky blue and jade green summer colors, butterfly and summer flower elements`
- **가을 (Stage 3)**: `warm orange and maple pattern autumn colors, sophisticated decorations`
- **겨울 (Stage 4)**: `deep purple and silver winter colors, snow pattern and elegant ornaments`
### 구체적 영역별 프롬프트
#### A행 (얼굴): 표정 세트 생성
```
Korean fairy character faces for 2D game, 2048x2048 with 4x4 grid, four different facial expressions in separate 512x512 sections:
A1: neutral calm expression looking slightly angled,
A2: bright joyful smile with sparkling eyes,
A3: gentle sad expression with slightly lowered eyebrows,
A4: surprised curious expression with wide eyes,
[생애주기별 수정자], traditional Korean facial features, oval face, large dark brown eyes, very pale skin with divine glow, long black hair, clean separation for animation rigging, transparent background
```
#### B행 (바디): 몸통 및 팔 생성
```
Korean fairy character body parts for 2D game, 2048x2048 with 4x4 grid, four body sections in separate 512x512 areas:
B1: main torso without head (clean neck connection), minimal traditional undergarment,
B2: left arm with elbow joint, natural relaxed pose,
B3: right arm with elbow joint, different angle pose,
B4: hand set (open hand, closed fist, pointing gesture, magic casting pose),
[생애주기별 수정자], very pale porcelain white skin, graceful proportions, clean separation for Spine rigging, transparent background
```
#### C행 (하체): 다리 및 기본 헤어
```
Korean fairy character lower body and hair for 2D game, 2048x2048 with 4x4 grid:
C1: left leg with knee joint, natural standing pose,
C2: right leg with knee joint, slightly different angle,
C3: feet set (barefoot, wearing traditional shoes, various angles),
C4: basic long flowing black hair without decorations,
[생애주기별 수정자], very pale white skin, elegant leg proportions, natural hair flow, clean separation for animation, transparent background
```
#### D행 (장식): 의상 및 특수 요소
```
Korean fairy character decorative elements for 2D game, 2048x2048 with 4x4 grid:
D1: decorated hair with [계절별 장식] ornaments and accessories,
D2: traditional Korean hanbok set (jeogori top, chima skirt) in [계절별 색상],
D3: traditional accessories (norigae ornament, bracelets, hair pins, knot decorations),
D4: magical effects (fairy wings, magical aura, light effects, [계절별] petals),
[생애주기별 수정자], traditional Korean fairy aesthetics, clean separated elements, transparent background
```
### Negative Prompt (필수 포함)
```
pointed ears, elf ears, fantasy ears, non-human ears, western fairy wings, insect wings, dragonfly wings, multiple characters in one section, overlapping elements between grid sections, text, watermarks, realistic photography style, dark skin, tanned skin, modern clothing, non-Korean elements, elderly appearance for stage 4
```
---
## ⚙️ 생성 프로세스 가이드
### 1단계: 기본 세팅
1. **시드 고정**: 캐릭터 일관성을 위해 동일한 seed 값 사용
2. **품질 설정**: 최고 품질로 설정
3. **크기 확정**: 2048x2048 픽셀 고정
### 2단계: 생애주기별 순차 생성
1. **Stage 1** → **Stage 2** → **Stage 3** → **Stage 4** 순서
2. 각 단계마다 A행→B행→C행→D행 순서로 생성
3. 이전 단계 결과 검토 후 다음 단계 진행
### 3단계: 품질 검증
- **그리드 정확성**: 4x4가 정확히 구분되는가?
- **영역당 1개**: 각 512x512 영역에 정확히 1개 요소만 있는가?
- **일관성**: 얼굴, 피부색, 전반적 스타일이 일관되는가?
- **분리 용이성**: 배경에서 캐릭터 파트 분리가 쉬운가?
### 4단계: 후처리 준비
- 생성된 이미지를 512x512로 분할하여 16개 파일 생성
- 각 파일명을 Spine 시스템에 맞게 명명
- 투명 배경 처리 및 최적화
---
## 🎯 강화된 4x4 그리드 프롬프트 전략
### 그리드 강조 기법
```
CRITICAL: Create exactly 4x4 grid layout with 16 separate sections (512x512 each), each section must contain ONLY ONE character part, clear borders between sections, no overlapping elements, perfect grid alignment
```
### 영역 지정 강화
```
Top row (A1-A4): Four distinct facial expressions
Second row (B1-B4): Body parts (torso, left arm, right arm, hand poses)
Third row (C1-C4): Lower body (left leg, right leg, feet, basic hair)
Bottom row (D1-D4): Decorative elements (ornate hair, hanbok, accessories, effects)
```
### 일관성 보장 문구
```
Maintain consistent character design across all 16 sections: same facial features, same skin tone, same art style, same lighting, traditional Korean fairy aesthetics throughout
```
---
## 📋 생성 체크리스트
### 이미지 기술 사양
- [ ] 2048x2048 픽셀 크기 확인
- [ ] 4x4 그리드가 명확히 구분됨
- [ ] 각 영역이 정확히 512x512 픽셀
- [ ] 영역당 1개 요소만 배치됨
- [ ] 투명 또는 단색 배경
### 캐릭터 일관성
- [ ] 모든 영역에서 동일한 얼굴 특징
- [ ] 일관된 피부색 (창백한 도자기 색)
- [ ] 동일한 아트 스타일
- [ ] 생애주기에 맞는 연령 표현
- [ ] 한국 전통 미학 반영
### Spine 2D 호환성
- [ ] 관절 부위가 명확히 구분됨
- [ ] 파츠 간 연결점이 자연스러움
- [ ] 레이어링이 가능한 구조
- [ ] 애니메이션 고려된 파트 분할
### 게임 세계관 반영
- [ ] 한국 선녀 설화 느낌
- [ ] 계절감 적절히 표현
- [ ] "살아있음의 기쁨" 감정 표현
- [ ] 매듭 요소 자연스럽게 포함
---
## 🔄 반복 개선 전략
### 1차 생성 후 평가 항목
1. **그리드 정확성**: 16개 영역이 정확히 분할되었는가?
2. **요소 단독성**: 각 영역에 1개 요소만 있는가?
3. **캐릭터 일관성**: 모든 파트가 같은 캐릭터인가?
4. **추출 용이성**: 배경에서 분리하기 쉬운가?
### 문제 발생 시 대응
- **그리드 불명확**: 그리드 강조 문구 추가
- **요소 중복**: 영역별 지정 더 구체화
- **일관성 부족**: 고정 특징 더 강화
- **배경 복잡**: 배경 단순화 명시
### 최적화 반복
1. 초기 결과 분석
2. 프롬프트 미세 조정
3. 재생성 후 비교
4. 최적 프롬프트 확정
---
## 💡 실전 적용 팁
### 효율적 생성을 위한 팁
1. **배치 생성**: 한 번에 여러 변형 시도
2. **프롬프트 템플릿**: 자주 사용하는 구조 저장
3. **결과 비교**: 여러 시드값 테스트 후 최적 선택
4. **단계별 확인**: 각 행 생성 후 품질 검증
### 문제 해결 가이드
- **얼굴 변형 시**: 고정 얼굴 특징 더 강화
- **비율 불일치**: 생애주기별 스케일 명시 강화
- **스타일 혼재**: 아트 스타일 지정 더 구체화
- **배경 간섭**: 투명 배경 요구 더 명확히
---
**이 가이드라인을 통해 Little Fairy 게임의 Spine 2D 캐릭터 시스템에 최적화된 고품질 캐릭터 이미지를 일관성 있게 생성할 수 있습니다. 4x4 그리드 구조로 체계적으로 관리되는 16개 파트를 통해 효율적인 캐릭터 제작이 가능합니다.**

101
prototype/CLAUDE.md Normal file
View File

@@ -0,0 +1,101 @@
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
This is the "Little Fairy" (작은 선녀 키우기) RPG game project - a Korean-themed life simulation game focused on the "joy of being alive" and generational continuity through a unique knot-based evolution system.
### Core Concept
- **1-hour compressed lifetime**: Each playthrough represents a complete fairy's life cycle
- **Knot-based DNA Pool**: Traditional Korean knot patterns represent relationships and experiences
- **Generational evolution**: Each generation inherits abilities based on previous generation's knot patterns
- **Life companion system**: Deep relationships can be formed with NPCs for special bonuses
- **Four seasonal maps**: Spring village, Summer fields, Autumn suburbs, Winter mountains
### Cultural Elements
- Based on Korean fairy tale traditions and seasonal cycles (24 solar terms)
- Integration of traditional Korean knot craft (매듭공예) as core game mechanic
- Korean traditional architecture, food, and cultural activities
- Modern reinterpretation while preserving cultural authenticity
## Project Structure
### Core Documentation
- `생명의_기쁨_RPG_게임기획서_초안.md`: Main game design document defining core experience goals
- `UX_맵시스템_설계.md`: Node-based map system design for simplified navigation
- `매듭_시스템_설계.md` & `매듭_시스템_설계_v2.md`: Knot-based relationship and evolution systems
- `게임플레이_메커니즘_설계.md`: Core gameplay mechanics
- `생명의_동반자_시스템_설계.md`: Companion relationship system
- `위험요소_사망시스템_설계.md`: Death and rebirth mechanics
### Scenario Content
- `scenarioA/`: Complete scenario system with 3 different storylines
- `00_전체_시나리오_개요.md`: Overview of all 3 scenarios
- `01_시나리오1_치유의_노래.md`: Healing-themed scenario
- `02_시나리오2_모험의_날개.md`: Adventure-themed scenario
- `03_시나리오3_지혜의_탑.md`: Wisdom-themed scenario
- `04_시나리오별_상세_비교_분석.md`: Detailed comparison analysis
- `05_개발_로드맵_및_실행_계획.md`: Development roadmap
- `scenarioA1/`, `scenarioA2/`, `scenarioA3/`: Map-specific content for each scenario variant
- `assetA/`: Art and asset production planning documents
### Cultural Reference
- `전통매듭_목록.md`: List of traditional Korean knots
- `전통매듭_반영_완료보고서.md`: Implementation report for traditional knots
## Development Guidelines
### Design Philosophy
All game elements must be evaluated against these core principles:
1. **Life Affirmation**: Does this element make players feel the preciousness of life?
2. **Present Moment Focus**: Does it enrich the current moment's experience?
3. **Connection Enhancement**: Does it deepen bonds with other beings?
4. **Generational Continuity**: Does it provide hope and responsibility for the future?
5. **Growth and Discovery**: Does it offer new insights or emotional experiences?
### Content Creation Standards
- Focus on **everyday miracles** rather than grand adventures
- Emphasize **relationship-centered** interactions with deep NPC bonds
- Maintain **Korean cultural authenticity** while being accessible to international audiences
- Ensure all death/rebirth mechanics serve the "joy of being alive" theme positively
- Design for **1-hour complete experience** that feels fulfilling and complete
### Map System Architecture
- **Node-based navigation**: Click-to-move between meaningful locations
- **No complex movement mechanics**: Focus development resources on content quality
- **Progressive unlocking**: New areas open based on story progression and character growth
- **Seasonal progression**: Maps transform through Spring→Summer→Autumn→Winter lifecycle
### Technical Approach
- **2D illustration-based**: Beautiful artwork over complex 3D environments
- **Modular loading**: Only load necessary content to maintain performance
- **JSON-driven content**: Easy addition of new nodes, characters, and events
- **Event system**: Independent management of location-specific content
## File Naming Convention
This project uses Korean language extensively in documentation. File and folder names use Korean characters and underscores for organization:
- Game design docs: `게임관련_내용.md`
- Scenario content: `시나리오관련_내용.md`
- System design: `시스템_설계.md`
- Cultural elements: `전통문화_관련.md`
## Development Priorities
1. **Core knot system implementation**: The relationship/evolution mechanic is central to everything
2. **NPC interaction depth**: Rich dialogue and relationship progression systems
3. **Visual storytelling**: Beautiful 2D art that conveys Korean cultural atmosphere
4. **Emotional pacing**: Ensure the 1-hour lifecycle feels complete and meaningful
5. **Cultural sensitivity**: Accurate representation of Korean traditions and values
## Key Success Metrics
The game should be evaluated on:
- **Emotional resonance**: Do players feel genuinely moved by their fairy's life story?
- **Cultural appreciation**: Do players gain understanding and appreciation of Korean culture?
- **Replayability through variation**: Do different knot patterns create meaningfully different experiences?
- **Generational investment**: Do players care about how their choices affect future generations?
- **Present moment awareness**: Do players become more mindful of beauty in their own lives?
This project aims to be more than entertainment - it's designed as a cultural experience that helps players find joy and meaning in the concept of being alive.