@silbaram/artifact-driven-agent 0.1.0

package/templates/game/roles/rendering.md

@@ -0,0 +1,137 @@
+# Role: Rendering Developer
+
+너는 게임 렌더링 개발자다.
+plan.md와 project.md를 기준으로 게임의 시각적 요소를 구현한다.
+
+> 이 역할은 core/roles/developer.md를 기반으로 하며,
+> 게임 렌더링에 특화된 규칙을 추가한다.
+
+---
+
+## 1. 핵심 책임
+
+- 게임 화면 렌더링 구현
+- 애니메이션 시스템 구현
+- UI/HUD 구현
+- 시각 효과 (VFX) 구현
+
+---
+
+## 2. 입력 문서 (Mandatory)
+
+- artifacts/plan.md
+- artifacts/project.md
+- artifacts/game-systems.md (게임 로직 이벤트)
+- artifacts/assets.md (에셋 목록)
+- artifacts/backlog.md
+- artifacts/current-sprint.md
+
+---
+
+## 3. 산출물 (Outputs)
+
+- artifacts/hud.md (HUD/UI 설계)
+- 렌더링 소스 코드 (src/)
+- (선택) artifacts/vfx.md (시각 효과 정의)
+
+---
+
+## 4. 참고 규칙 문서
+
+- core/rules/iteration.md
+- rules/asset-change.md (에셋 변경 시)
+- core/rules/escalation.md
+
+---
+
+## 5. 렌더링 구현 원칙
+
+### 5.1 게임 로직 분리
+
+```
+게임 로직 (Game Logic) → 이벤트 → 렌더링
+
+예시:
+- "체력 감소" 이벤트 → 데미지 이펙트 표시
+- "레벨업" 이벤트 → 레벨업 애니메이션
+```
+
+### 5.2 이벤트 기반 렌더링
+
+- Game Logic에서 정의한 이벤트 구독
+- 이벤트에 따라 시각적 피드백
+- 렌더링이 로직에 영향 주지 않음
+
+---
+
+## 6. HUD/UI 문서 구조
+
+### hud.md
+
+```markdown
+## [화면명]
+
+### 구성 요소
+| 요소 | 위치 | 설명 |
+|------|------|------|
+| 체력바 | 좌상단 | 현재/최대 체력 |
+| 미니맵 | 우상단 | 주변 지형 |
+
+### 상태별 표시
+| 상태 | 표시 |
+|------|------|
+| 데미지 | 화면 빨간색 플래시 |
+| 레벨업 | 황금빛 이펙트 |
+
+### 애니메이션
+| 이름 | 트리거 | 설명 |
+|------|--------|------|
+| damage_flash | 피격 시 | 0.2초 빨간 플래시 |
+```
+
+---
+
+## 7. 에셋 협업
+
+### 7.1 에셋 요청
+
+- 필요한 에셋은 assets.md에 등록
+- 스펙 명시 (크기, 포맷, 프레임 수)
+
+### 7.2 에셋 사용
+
+- assets.md에 등록된 에셋만 사용
+- 경로와 이름 규칙 준수
+
+---
+
+## 8. 금지 사항 (CRITICAL)
+
+- ❌ 렌더링에서 게임 로직 수정
+- ❌ assets.md에 없는 에셋 사용
+- ❌ 하드코딩된 에셋 경로
+- ❌ project.md에 없는 기술 도입
+- ❌ 스프린트 외 작업
+
+---
+
+## 9. 세션 시작 예시
+
+```
+━━━━━━━━━━━━━━━━━━━━━━
+🎨 Rendering Developer 세션 시작
+━━━━━━━━━━━━━━━━━━━━━━
+
+📋 문서 확인
+✅ plan.md - 확인됨
+✅ project.md - Frozen (v1.0)
+✅ game-systems.md - 이벤트 목록 확인
+✅ assets.md - 에셋 목록 확인
+
+📌 내 Task (current-sprint.md 기준)
+- TASK-002: [화면명] HUD - IN_DEV
+
+━━━━━━━━━━━━━━━━━━━━━━
+
+TASK-002를 시작하겠습니다.
+```

package/templates/game/rules/system-change.md

@@ -0,0 +1,184 @@
+# System Change Rules (시스템 변경 규칙)
+
+> 게임 시스템 변경 시 따라야 할 절차
+> 시스템 간 의존성 관리
+
+---
+
+## 1. 시스템 변경 원칙
+
+- game-systems.md는 **모든 시스템의 진실**
+- 변경 시 **영향 분석** 필수
+- **밸런스 변경**은 신중하게
+- 모든 변경은 **문서에 기록**
+
+---
+
+## 2. 변경 유형 분류
+
+### 2.1 Minor Change (영향 적음)
+
+| 유형 | 예시 | 승인 |
+|------|------|------|
+| 밸런스 파라미터 조정 | 데미지 10 → 12 | 기록만 |
+| 버그 수정 | 공식 오류 수정 | 기록만 |
+| 설명 보완 | 문서 명확화 | 기록만 |
+
+### 2.2 Major Change (영향 큼)
+
+| 유형 | 예시 | 승인 |
+|------|------|------|
+| 새 시스템 추가 | 조합 시스템 | Manager |
+| 시스템 로직 변경 | 전투 공식 변경 | Manager |
+| 이벤트 추가/삭제 | 새 이벤트 타입 | 영향받는 역할 |
+| 시스템 간 연동 변경 | 의존성 변경 | 영향받는 역할 |
+
+---
+
+## 3. 변경 절차
+
+### 3.1 Minor Change
+
+```
+변경 필요 발견
+    ↓
+game-systems.md에 [MINOR] 태그로 수정
+    ↓
+변경 이력 기록
+    ↓
+구현 진행
+```
+
+### 3.2 Major Change
+
+```
+변경 필요 발견
+    ↓
+영향 분석 수행
+    ↓
+game-systems.md에 [PROPOSED] 태그로 추가
+    ↓
+영향받는 역할에 통보
+    ↓
+Manager 승인 (필요 시)
+    ↓
+합의 후 확정, 구현 진행
+```
+
+---
+
+## 4. 영향 분석
+
+### 4.1 분석 항목
+
+| 항목 | 내용 |
+|------|------|
+| 영향받는 시스템 | 이 시스템을 참조하는 다른 시스템 |
+| 영향받는 에셋 | 변경이 필요한 에셋 |
+| 영향받는 UI | 변경이 필요한 화면 |
+| 밸런스 영향 | 게임 난이도/재미 영향 |
+
+### 4.2 영향 분석 형식
+
+```markdown
+## 영향 분석: [변경 내용]
+
+### 변경 시스템
+- [시스템명]: [변경 내용]
+
+### 영향받는 시스템
+| 시스템 | 영향 | 필요 조치 |
+|--------|------|----------|
+| Combat | 데미지 계산 변경 | 공식 수정 |
+
+### 영향받는 에셋
+- [에셋명]: [필요 조치]
+
+### 영향받는 UI
+- [화면명]: [필요 조치]
+
+### 밸런스 영향
+- [영향 설명]
+
+### 총 영향 규모
+Minor / Major
+```
+
+---
+
+## 5. 이벤트 변경 규칙
+
+### 5.1 이벤트 추가
+
+- game-systems.md에 이벤트 정의
+- 이벤트 데이터 구조 명시
+- 렌더링/사운드에 통보
+
+### 5.2 이벤트 삭제
+
+- Deprecated 표시 먼저
+- 참조하는 시스템 확인
+- 최소 1 스프린트 유지 후 삭제
+
+### 5.3 이벤트 변경
+
+- 데이터 구조 변경 시 Major Change
+- 모든 구독자에게 통보
+
+---
+
+## 6. 밸런스 변경 가이드
+
+### 6.1 변경 시 고려사항
+
+| 항목 | 질문 |
+|------|------|
+| 재미 | 게임이 더 재미있어지는가? |
+| 난이도 | 너무 쉬워지거나 어려워지는가? |
+| 진행 | 진행 속도에 영향이 있는가? |
+| 공정성 | 특정 전략이 압도적이 되는가? |
+
+### 6.2 밸런스 테스트
+
+- 변경 전후 시뮬레이션
+- 극단적 케이스 테스트
+- 수치 변경은 10-20% 단위로
+
+---
+
+## 7. 역할별 책임
+
+| 역할 | 책임 |
+|------|------|
+| Game Logic | 시스템 변경 제안, 영향 분석 |
+| Rendering | 시각적 영향 검토 |
+| Sound | 오디오 영향 검토 |
+| Manager | Major Change 승인 |
+
+---
+
+## 8. 금지 사항
+
+- ❌ 문서 없이 시스템 변경
+- ❌ 영향 분석 없이 Major Change
+- ❌ 통보 없이 이벤트 변경
+- ❌ 테스트 없이 밸런스 변경
+
+---
+
+## 9. 체크리스트
+
+### 시스템 변경 전
+
+- [ ] 변경 유형 분류 (Minor/Major)
+- [ ] 영향 분석 완료
+- [ ] game-systems.md에 [PROPOSED] 추가
+- [ ] 영향받는 역할 통보
+- [ ] (Major) Manager 승인
+
+### 시스템 변경 후
+
+- [ ] game-systems.md 갱신
+- [ ] 변경 이력 기록
+- [ ] 관련 에셋/UI 갱신 확인
+- [ ] 테스트 완료

package/templates/library/artifacts/changelog.md

@@ -0,0 +1,84 @@
+# Changelog
+
+> 모든 버전의 변경 사항 기록
+> [Semantic Versioning](https://semver.org/) 준수
+
+---
+
+## [Unreleased]
+
+### Added
+- (새 기능 추가 시 여기에 기록)
+
+### Changed
+- (변경 사항 기록)
+
+### Deprecated
+- (deprecated 예정 기능)
+
+### Removed
+- (제거된 기능)
+
+### Fixed
+- (버그 수정)
+
+### Security
+- (보안 관련 수정)
+
+---
+
+## [1.0.0] - YYYY-MM-DD
+
+### Added
+- 초기 릴리스
+- `mainFunction()` 추가 [TASK-001]
+- `helperFunction()` 추가 [TASK-002]
+- 기본 설정 시스템 [TASK-003]
+
+### Documentation
+- public-api.md 작성
+- examples.md 작성
+- README.md 작성
+
+---
+
+## 버전 관리 규칙
+
+### 버전 형식
+
+```
+MAJOR.MINOR.PATCH
+
+예: 1.2.3
+```
+
+### 버전 증가 기준
+
+| 변경 유형 | 버전 | 예시 |
+|----------|------|------|
+| 버그 수정 | PATCH | 1.0.0 → 1.0.1 |
+| 새 기능 (호환) | MINOR | 1.0.1 → 1.1.0 |
+| Breaking change | MAJOR | 1.1.0 → 2.0.0 |
+
+### 카테고리 정의
+
+| 카테고리 | 설명 |
+|----------|------|
+| Added | 새로 추가된 기능 |
+| Changed | 기존 기능의 변경 |
+| Deprecated | 곧 제거될 기능 |
+| Removed | 제거된 기능 |
+| Fixed | 버그 수정 |
+| Security | 보안 관련 수정 |
+
+---
+
+## 릴리스 체크리스트
+
+- [ ] 모든 Task 완료
+- [ ] 테스트 통과
+- [ ] public-api.md 갱신
+- [ ] examples.md 갱신
+- [ ] changelog.md 갱신
+- [ ] 버전 번호 증가
+- [ ] 태그 생성

package/templates/library/artifacts/examples.md

@@ -0,0 +1,157 @@
+# Examples (사용 예제)
+
+> 라이브러리 사용 예제 모음
+> 실제 동작하는 코드로 작성
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 라이브러리 버전 | v1.0.0 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 빠른 시작 (Quick Start)
+
+### 1.1 설치
+
+```bash
+pip install [library-name]
+```
+
+### 1.2 기본 사용
+
+```python
+from library import main_function
+
+# 가장 간단한 사용법
+result = main_function("hello")
+print(result.value)  # 출력: processed: hello
+```
+
+---
+
+## 2. 기본 예제
+
+### 2.1 예제: [시나리오 이름]
+
+**목적:** [이 예제가 보여주는 것]
+
+```python
+from library import main_function, Config
+
+# 설정
+config = Config(timeout=30)
+
+# 실행
+result = main_function("input", config=config)
+
+# 결과 확인
+if result.status == "success":
+    print(f"성공: {result.value}")
+else:
+    print(f"실패: {result.error}")
+```
+
+**실행 결과:**
+```
+성공: processed: input
+```
+
+---
+
+### 2.2 예제: [다른 시나리오]
+
+**목적:** [설명]
+
+```python
+# 예제 코드
+```
+
+---
+
+## 3. 고급 예제
+
+### 3.1 비동기 처리
+
+```python
+import asyncio
+from library import async_function
+
+async def main():
+    result = await async_function("data")
+    print(result)
+
+asyncio.run(main())
+```
+
+### 3.2 에러 처리
+
+```python
+from library import main_function, LibraryError
+
+try:
+    result = main_function("")
+except LibraryError as e:
+    print(f"에러 발생: {e.message}")
+    print(f"에러 코드: {e.code}")
+```
+
+### 3.3 커스텀 설정
+
+```python
+from library import configure, main_function
+
+# 전역 설정
+configure(
+    timeout=60,
+    retries=5,
+    debug=True
+)
+
+# 설정이 적용된 상태로 실행
+result = main_function("data")
+```
+
+---
+
+## 4. 통합 예제
+
+### 4.1 [프레임워크]와 함께 사용
+
+```python
+# 프레임워크 통합 예제
+```
+
+### 4.2 다른 라이브러리와 함께
+
+```python
+# 다른 라이브러리와 조합 예제
+```
+
+---
+
+## 5. FAQ 및 팁
+
+### Q: [자주 묻는 질문]?
+
+```python
+# 해결 방법 코드
+```
+
+### Q: [다른 질문]?
+
+```python
+# 해결 방법 코드
+```
+
+---
+
+## 6. 변경 이력
+
+| 버전 | 날짜 | 변경 내용 | Task |
+|------|------|----------|------|
+| v1.0.0 | YYYY-MM-DD | 초기 예제 작성 | - |