@silbaram/artifact-driven-agent 0.1.0

package/templates/game/artifacts/game-systems.md

@@ -0,0 +1,217 @@
+# Game Systems Specification
+
+> 게임 시스템 설계 문서
+> 모든 게임 로직의 단일 진실
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 게임명 | [게임명] |
+| 버전 | v1.0 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 시스템 개요
+
+| 시스템 | 설명 | 상태 | Task |
+|--------|------|:----:|------|
+| Core | 게임 루프, 상태 관리 | ✅ | TASK-001 |
+| Combat | 전투 시스템 | ⏳ | TASK-002 |
+| Inventory | 아이템 관리 | 📋 | TASK-003 |
+| Progression | 레벨/스킬 성장 | 📋 | TASK-004 |
+
+---
+
+## 2. Core System
+
+### 2.1 게임 상태
+
+| 상태 | 설명 | 전환 조건 |
+|------|------|----------|
+| INIT | 초기화 중 | 로딩 완료 → READY |
+| READY | 준비 완료 | 시작 → PLAYING |
+| PLAYING | 게임 진행 중 | 일시정지 → PAUSED |
+| PAUSED | 일시 정지 | 재개 → PLAYING |
+| GAME_OVER | 게임 종료 | 재시작 → INIT |
+
+### 2.2 게임 루프
+
+```
+while (state === PLAYING) {
+    processInput()
+    updateSystems()
+    render()
+}
+```
+
+### 2.3 이벤트 버스
+
+| 이벤트 | 발생 조건 | 데이터 |
+|--------|----------|--------|
+| GAME_START | 게임 시작 | - |
+| GAME_PAUSE | 일시정지 | - |
+| GAME_OVER | 게임 종료 | score, reason |
+
+---
+
+## 3. Combat System
+
+### 3.1 개요
+
+[전투 시스템 설명]
+
+### 3.2 엔티티 속성
+
+| 속성 | 타입 | 설명 | 기본값 |
+|------|------|------|--------|
+| health | number | 현재 체력 | 100 |
+| maxHealth | number | 최대 체력 | 100 |
+| attack | number | 공격력 | 10 |
+| defense | number | 방어력 | 5 |
+
+### 3.3 전투 공식
+
+```
+# 데미지 계산
+damage = max(1, attacker.attack - defender.defense)
+
+# 크리티컬 데미지
+if (random() < critRate):
+    damage = damage * critMultiplier
+```
+
+### 3.4 전투 이벤트
+
+| 이벤트 | 발생 조건 | 데이터 |
+|--------|----------|--------|
+| ATTACK | 공격 시 | attacker, target, damage |
+| DAMAGE | 피격 시 | target, damage, isCritical |
+| DEATH | 체력 0 | entity |
+| HEAL | 회복 시 | target, amount |
+
+### 3.5 상태 이상
+
+| 상태 | 효과 | 지속 시간 |
+|------|------|----------|
+| POISON | 틱당 5 데미지 | 5초 |
+| STUN | 행동 불가 | 2초 |
+| BUFF_ATK | 공격력 +20% | 10초 |
+
+---
+
+## 4. Inventory System
+
+### 4.1 개요
+
+[인벤토리 시스템 설명]
+
+### 4.2 아이템 구조
+
+```
+Item {
+    id: string
+    name: string
+    type: ItemType
+    stackable: boolean
+    maxStack: number
+}
+```
+
+### 4.3 아이템 타입
+
+| 타입 | 설명 | 스택 가능 |
+|------|------|:--------:|
+| CONSUMABLE | 소비 아이템 | ✅ |
+| EQUIPMENT | 장비 | ❌ |
+| MATERIAL | 재료 | ✅ |
+| KEY | 키 아이템 | ❌ |
+
+### 4.4 인벤토리 이벤트
+
+| 이벤트 | 발생 조건 | 데이터 |
+|--------|----------|--------|
+| ITEM_ADD | 아이템 획득 | item, quantity |
+| ITEM_REMOVE | 아이템 제거 | item, quantity |
+| ITEM_USE | 아이템 사용 | item |
+
+---
+
+## 5. Progression System
+
+### 5.1 레벨 시스템
+
+```
+# 필요 경험치
+requiredExp = baseExp * (level ^ expMultiplier)
+
+# 예시 (baseExp=100, expMultiplier=1.5)
+Level 1 → 2: 100 exp
+Level 2 → 3: 283 exp
+Level 3 → 4: 520 exp
+```
+
+### 5.2 스탯 성장
+
+| 레벨업 시 | 증가량 |
+|----------|--------|
+| maxHealth | +10 |
+| attack | +2 |
+| defense | +1 |
+
+### 5.3 진행 이벤트
+
+| 이벤트 | 발생 조건 | 데이터 |
+|--------|----------|--------|
+| EXP_GAIN | 경험치 획득 | amount |
+| LEVEL_UP | 레벨 상승 | newLevel, statGains |
+
+---
+
+## 6. 시스템 간 상호작용
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                                                                 │
+│  Combat System                                                  │
+│       │                                                         │
+│       ├── DEATH 이벤트 ──→ Progression: EXP_GAIN               │
+│       │                                                         │
+│       └── DAMAGE 이벤트 ──→ Rendering: 데미지 이펙트           │
+│                                                                 │
+│  Inventory System                                               │
+│       │                                                         │
+│       └── ITEM_USE ──→ Combat: 회복/버프                       │
+│                                                                 │
+│  Progression System                                             │
+│       │                                                         │
+│       └── LEVEL_UP ──→ Rendering: 레벨업 이펙트                │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 7. 밸런스 파라미터
+
+> 별도 설정 파일로 관리되는 값들
+
+| 파라미터 | 값 | 설명 |
+|----------|-----|------|
+| BASE_HEALTH | 100 | 기본 체력 |
+| BASE_ATTACK | 10 | 기본 공격력 |
+| EXP_MULTIPLIER | 1.5 | 경험치 증가율 |
+| CRIT_RATE | 0.1 | 크리티컬 확률 |
+| CRIT_MULTIPLIER | 2.0 | 크리티컬 배율 |
+
+---
+
+## 8. 변경 이력
+
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-001] | YYYY-MM-DD | Core System 초기 설계 |
+| [TASK-002] | YYYY-MM-DD | Combat System 추가 |

package/templates/game/artifacts/hud.md

@@ -0,0 +1,199 @@
+# HUD/UI Specification
+
+> 게임 UI 설계 문서
+> 화면 구성과 사용자 인터페이스 정의
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 버전 | v1.0 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 화면 목록
+
+| 화면 | 설명 | 상태 | Task |
+|------|------|:----:|------|
+| Title | 타이틀 화면 | ✅ | TASK-001 |
+| Game | 게임 플레이 | ⏳ | TASK-002 |
+| Pause | 일시정지 | 📋 | TASK-003 |
+| GameOver | 게임 종료 | 📋 | TASK-004 |
+| Inventory | 인벤토리 | 📋 | TASK-005 |
+
+---
+
+## 2. 공통 UI 요소
+
+### 2.1 버튼
+
+| 상태 | 표시 |
+|------|------|
+| Normal | 기본 상태 |
+| Hover | 마우스 오버 (밝아짐) |
+| Pressed | 클릭 중 (어두워짐) |
+| Disabled | 비활성화 (회색) |
+
+### 2.2 공통 레이아웃
+
+```
+┌─────────────────────────────────────────┐
+│  [좌상단]                    [우상단]   │
+│                                         │
+│                                         │
+│              [중앙]                     │
+│                                         │
+│                                         │
+│  [좌하단]                    [우하단]   │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 3. Title 화면
+
+### 레이아웃
+
+```
+┌─────────────────────────────────────────┐
+│                                         │
+│            [ GAME TITLE ]               │
+│                                         │
+│            [ 시작하기 ]                 │
+│            [ 설정 ]                     │
+│            [ 종료 ]                     │
+│                                         │
+│                        v1.0.0           │
+└─────────────────────────────────────────┘
+```
+
+### 요소
+
+| 요소 | 위치 | 액션 |
+|------|------|------|
+| 게임 타이틀 | 중앙 상단 | - |
+| 시작 버튼 | 중앙 | → Game 화면 |
+| 설정 버튼 | 중앙 | → Settings 팝업 |
+| 종료 버튼 | 중앙 | 게임 종료 |
+| 버전 | 우하단 | - |
+
+---
+
+## 4. Game 화면 (HUD)
+
+### 레이아웃
+
+```
+┌─────────────────────────────────────────┐
+│ [체력바]                   [미니맵]     │
+│ [마나바]                                │
+│                                         │
+│                                         │
+│              [게임 영역]                │
+│                                         │
+│                                         │
+│ [스킬1][스킬2][스킬3]    [인벤토리]     │
+└─────────────────────────────────────────┘
+```
+
+### HUD 요소
+
+| 요소 | 위치 | 표시 내용 | 이벤트 연동 |
+|------|------|----------|-------------|
+| 체력바 | 좌상단 | HP / MaxHP | DAMAGE, HEAL |
+| 마나바 | 좌상단 | MP / MaxMP | SKILL_USE |
+| 경험치바 | 상단 | EXP / RequiredEXP | EXP_GAIN |
+| 미니맵 | 우상단 | 주변 지형 | MOVE |
+| 스킬 슬롯 | 하단 | 스킬 아이콘, 쿨다운 | SKILL_READY |
+| 인벤토리 버튼 | 우하단 | 가방 아이콘 | → Inventory |
+
+### 게임 이벤트별 UI 반응
+
+| 이벤트 | UI 반응 |
+|--------|---------|
+| DAMAGE | 체력바 감소 + 화면 빨간 플래시 |
+| HEAL | 체력바 증가 + 녹색 이펙트 |
+| LEVEL_UP | 레벨업 팝업 + 황금빛 이펙트 |
+| ITEM_GET | 아이템 획득 알림 (우측) |
+
+---
+
+## 5. Pause 화면
+
+### 레이아웃
+
+```
+┌─────────────────────────────────────────┐
+│                                         │
+│            ┌─────────────┐              │
+│            │  일시정지   │              │
+│            │             │              │
+│            │ [ 계속 ]    │              │
+│            │ [ 설정 ]    │              │
+│            │ [ 타이틀 ]  │              │
+│            └─────────────┘              │
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+### 요소
+
+| 요소 | 액션 |
+|------|------|
+| 계속 | → Game 재개 |
+| 설정 | → Settings |
+| 타이틀 | → Title (확인 팝업) |
+
+---
+
+## 6. Inventory 화면
+
+### 레이아웃
+
+```
+┌─────────────────────────────────────────┐
+│ [닫기]         인벤토리                 │
+├─────────────────────────────────────────┤
+│                                         │
+│  [아이템][아이템][아이템][아이템]       │
+│  [아이템][아이템][아이템][아이템]       │
+│  [아이템][아이템][아이템][아이템]       │
+│                                         │
+├─────────────────────────────────────────┤
+│  [선택된 아이템 정보]                   │
+│  [사용] [버리기]                        │
+└─────────────────────────────────────────┘
+```
+
+### 요소
+
+| 요소 | 액션 |
+|------|------|
+| 아이템 슬롯 | 클릭 → 선택 |
+| 아이템 정보 | 선택된 아이템 표시 |
+| 사용 버튼 | ITEM_USE 이벤트 |
+| 버리기 버튼 | ITEM_REMOVE 이벤트 |
+
+---
+
+## 7. 알림 시스템
+
+### 알림 유형
+
+| 유형 | 위치 | 지속 | 예시 |
+|------|------|------|------|
+| Toast | 상단 중앙 | 2초 | "저장되었습니다" |
+| ItemGet | 우측 | 3초 | "[포션] 획득" |
+| Achievement | 상단 | 5초 | "업적 달성!" |
+| Error | 하단 | 3초 | "마나가 부족합니다" |
+
+---
+
+## 8. 변경 이력
+
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-002] | YYYY-MM-DD | Game HUD 추가 |

package/templates/game/roles/game-logic.md

@@ -0,0 +1,193 @@
+# Role: Game Logic Developer
+
+너는 게임 로직 개발자다.
+plan.md와 project.md를 기준으로 게임 시스템과 로직을 구현한다.
+
+> 이 역할은 core/roles/developer.md를 기반으로 하며,
+> 게임 개발에 특화된 규칙을 추가한다.
+
+---
+
+## 1. 핵심 책임
+
+- 게임 시스템 설계 및 구현
+- game-systems.md (게임 시스템 문서) 작성
+- 게임 규칙/밸런스 구현
+- 상태 관리 및 게임 루프 구현
+
+---
+
+## 2. 입력 문서 (Mandatory)
+
+- artifacts/plan.md (게임 기획)
+- artifacts/project.md
+- artifacts/backlog.md
+- artifacts/current-sprint.md
+
+(선택)
+- artifacts/decision.md
+
+---
+
+## 3. 산출물 (Outputs)
+
+- artifacts/game-systems.md (게임 시스템 설계)
+- 게임 로직 소스 코드 (src/)
+- (선택) artifacts/balance.md (밸런스 데이터)
+- (선택) artifacts/dev-notes.md
+
+---
+
+## 4. 참고 규칙 문서
+
+- core/rules/iteration.md
+- rules/system-change.md (시스템 변경 시)
+- core/rules/escalation.md
+- core/rules/document-priority.md
+
+---
+
+## 5. 게임 시스템 설계 원칙
+
+### 5.1 문서 우선
+
+```
+1. game-systems.md에 시스템 설계
+2. 시스템 간 상호작용 정의
+3. 밸런스 파라미터 문서화
+4. 구현 진행
+```
+
+### 5.2 시스템 분리
+
+| 시스템 유형 | 예시 |
+|-------------|------|
+| Core | 게임 루프, 상태 관리 |
+| Gameplay | 전투, 이동, 인벤토리 |
+| Progression | 레벨업, 스킬, 업적 |
+| Economy | 재화, 상점, 거래 |
+
+### 5.3 테스트 가능한 설계
+
+- 각 시스템은 독립적으로 테스트 가능
+- 밸런스 값은 외부 설정으로 분리
+- 결정론적 로직 (동일 입력 → 동일 결과)
+
+---
+
+## 6. 게임 시스템 문서 구조
+
+### game-systems.md
+
+```markdown
+## [시스템명] System
+
+### 개요
+[시스템 설명]
+
+### 핵심 개념
+- [개념 1]: [설명]
+- [개념 2]: [설명]
+
+### 상태 (State)
+| 상태 | 타입 | 설명 |
+|------|------|------|
+| health | number | 현재 체력 |
+
+### 동작 (Actions)
+| 동작 | 트리거 | 결과 |
+|------|--------|------|
+| attack | 공격 버튼 | 대상에게 데미지 |
+
+### 공식 (Formulas)
+```
+damage = base_attack * (1 + strength * 0.1)
+```
+
+### 다른 시스템과 상호작용
+- [시스템A] → [상호작용]
+- [시스템B] ← [상호작용]
+```
+
+---
+
+## 7. Task 단위 작업
+
+Task 구현 시:
+
+```markdown
+## game-systems.md 변경
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-001] | 2024-01-15 | 전투 시스템 추가 |
+| [TASK-003] | 2024-01-17 | 레벨업 공식 수정 |
+```
+
+---
+
+## 8. 밸런스 관리
+
+### 8.1 밸런스 파라미터
+
+- 모든 밸런스 값은 코드에 하드코딩 금지
+- 설정 파일 또는 데이터 테이블로 분리
+- balance.md에 공식과 의도 문서화
+
+### 8.2 밸런스 변경
+
+- MINOR 변경: game-systems.md에 기록
+- MAJOR 변경: Manager 협의 필요
+
+---
+
+## 9. 금지 사항 (CRITICAL)
+
+- ❌ game-systems.md 없이 시스템 구현
+- ❌ 밸런스 값 하드코딩
+- ❌ 문서화 없이 공식 변경
+- ❌ project.md에 없는 기술 도입
+- ❌ 스프린트 외 작업
+- ❌ 다른 시스템 임의 수정
+
+---
+
+## 10. 다른 역할과 협업
+
+### 10.1 Rendering Developer
+
+- 시각적 피드백 요구사항 전달
+- 상태 변경 이벤트 정의
+- 애니메이션 트리거 포인트 명시
+
+### 10.2 Sound Developer
+
+- 사운드 트리거 포인트 정의
+- 이벤트 기반 사운드 재생
+
+---
+
+## 11. 세션 시작 예시
+
+```
+━━━━━━━━━━━━━━━━━━━━━━
+🎮 Game Logic Developer 세션 시작
+━━━━━━━━━━━━━━━━━━━━━━
+
+📋 문서 확인
+✅ plan.md - 확인됨 (게임 기획)
+✅ project.md - Frozen (v1.0)
+   - 엔진: [엔진]
+   - 언어: [언어]
+
+📌 게임 시스템 현황
+- Combat System: ✅ 완료
+- Inventory System: ⏳ 진행중
+- Level System: 📋 예정
+
+📌 내 Task (current-sprint.md 기준)
+- TASK-001: [시스템명] - IN_DEV
+
+━━━━━━━━━━━━━━━━━━━━━━
+
+game-systems.md 기반으로 TASK-001을 시작하겠습니다.
+```