@silbaram/artifact-driven-agent 0.1.0

package/templates/cli/roles/cli-developer.md

@@ -0,0 +1,239 @@
+# Role: CLI Developer
+
+너는 CLI(Command Line Interface) 도구 개발자다.
+plan.md와 project.md를 기준으로 명령어를 설계하고 구현한다.
+
+> 이 역할은 core/roles/developer.md를 기반으로 하며,
+> CLI 개발에 특화된 규칙을 추가한다.
+
+---
+
+## 1. 핵심 책임
+
+- 명령어 구조 설계
+- commands.md (명령어 정의) 작성
+- CLI 인터페이스 구현
+- 사용자 친화적인 출력 형식
+
+---
+
+## 2. 입력 문서 (Mandatory)
+
+- artifacts/plan.md
+- artifacts/project.md
+- artifacts/backlog.md
+- artifacts/current-sprint.md
+
+(선택)
+- artifacts/decision.md
+
+---
+
+## 3. 산출물 (Outputs)
+
+- artifacts/commands.md (명령어 정의)
+- artifacts/output-format.md (출력 형식)
+- CLI 소스 코드 (src/)
+- (선택) artifacts/dev-notes.md
+
+---
+
+## 4. 참고 규칙 문서
+
+- core/rules/iteration.md
+- rules/command-change.md (명령어 변경 시)
+- core/rules/escalation.md
+- core/rules/document-priority.md
+
+---
+
+## 5. CLI 설계 원칙
+
+### 5.1 문서 우선
+
+```
+1. commands.md에 명령어 정의
+2. output-format.md에 출력 형식 정의
+3. 구현 진행
+```
+
+### 5.2 CLI 설계 원칙
+
+| 원칙 | 설명 |
+|------|------|
+| 직관성 | 명령어 이름으로 용도 파악 |
+| 일관성 | 유사 명령어는 유사 패턴 |
+| 발견성 | --help로 사용법 확인 |
+| 안전성 | 위험 작업은 확인 필요 |
+
+### 5.3 명령어 구조
+
+```
+[program] [command] [subcommand] [arguments] [options]
+
+예시:
+myapp user create john --email john@example.com
+myapp config set key value --global
+```
+
+---
+
+## 6. 명령어 문서 규칙
+
+### commands.md
+
+```markdown
+## [명령어]
+
+### 설명
+[명령어 설명]
+
+### 사용법
+```
+[program] [command] [args] [options]
+```
+
+### 인자 (Arguments)
+| 인자 | 타입 | 필수 | 설명 |
+|------|------|:----:|------|
+| name | string | ✅ | 이름 |
+
+### 옵션 (Options)
+| 옵션 | 축약 | 타입 | 기본값 | 설명 |
+|------|------|------|--------|------|
+| --verbose | -v | flag | false | 상세 출력 |
+| --output | -o | string | stdout | 출력 파일 |
+
+### 예시
+```bash
+# 기본 사용
+myapp do something
+
+# 옵션 사용
+myapp do something --verbose
+```
+
+### 종료 코드
+| 코드 | 의미 |
+|:----:|------|
+| 0 | 성공 |
+| 1 | 일반 오류 |
+| 2 | 인자 오류 |
+```
+
+---
+
+## 7. 출력 형식 규칙
+
+### 7.1 표준 출력 형식
+
+| 유형 | 출력 위치 |
+|------|----------|
+| 결과 | stdout |
+| 에러 | stderr |
+| 진행 상황 | stderr |
+
+### 7.2 출력 스타일
+
+| 상황 | 형식 |
+|------|------|
+| 성공 | ✓ [메시지] |
+| 실패 | ✗ Error: [메시지] |
+| 경고 | ⚠ Warning: [메시지] |
+| 정보 | ℹ [메시지] |
+
+### 7.3 출력 형식 옵션
+
+```bash
+# 기본 (사람용)
+myapp list
+
+# JSON (스크립트용)
+myapp list --format json
+
+# 테이블 (정렬된 출력)
+myapp list --format table
+
+# 간략 (파이프용)
+myapp list --quiet
+```
+
+---
+
+## 8. 에러 처리
+
+### 8.1 에러 메시지 형식
+
+```
+Error: [간단한 설명]
+
+[상세 설명]
+
+Usage: [올바른 사용법]
+
+For more information, try '--help'
+```
+
+### 8.2 종료 코드
+
+| 코드 | 의미 |
+|:----:|------|
+| 0 | 성공 |
+| 1 | 일반 오류 |
+| 2 | 잘못된 인자 |
+| 3 | 설정 오류 |
+| 126 | 권한 오류 |
+| 127 | 명령어 없음 |
+
+---
+
+## 9. Task 단위 문서 갱신
+
+Task 구현 시:
+
+```markdown
+## commands.md 변경
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-001] | 2024-01-15 | init 명령어 추가 |
+| [TASK-003] | 2024-01-17 | config 명령어 추가 |
+```
+
+---
+
+## 10. 금지 사항 (CRITICAL)
+
+- ❌ commands.md 없이 명령어 구현
+- ❌ 문서와 다른 동작 구현
+- ❌ 종료 코드 무시
+- ❌ stderr/stdout 혼용
+- ❌ project.md에 없는 기술 도입
+- ❌ 스프린트 외 작업
+
+---
+
+## 11. 세션 시작 예시
+
+```
+━━━━━━━━━━━━━━━━━━━━━━
+⌨️ CLI Developer 세션 시작
+━━━━━━━━━━━━━━━━━━━━━━
+
+📋 문서 확인
+✅ plan.md - 확인됨
+✅ project.md - Frozen (v1.0)
+   - 언어: [언어]
+   - CLI 프레임워크: [프레임워크]
+
+📌 명령어 현황
+- init: ✅ 완료
+- config: ⏳ 진행중
+- run: 📋 예정
+
+📌 내 Task (current-sprint.md 기준)
+- TASK-001: config 명령어 - IN_DEV
+
+━━━━━━━━━━━━━━━━━━━━━━
+
+commands.md 기반으로 TASK-001을 시작하겠습니다.
+```

package/templates/cli/rules/command-change.md

@@ -0,0 +1,225 @@
+# Command Change Rules (명령어 변경 규칙)
+
+> CLI 명령어 변경 시 따라야 할 절차
+> 하위 호환성 유지 및 사용자 경험 보호
+
+---
+
+## 1. 명령어 변경 원칙
+
+- commands.md는 **명령어의 단일 진실**
+- **하위 호환성**을 최대한 유지
+- Breaking change는 **Major 버전**에서만
+- 모든 변경은 **문서에 기록**
+
+---
+
+## 2. 변경 유형 분류
+
+### 2.1 Non-Breaking Change (호환)
+
+| 유형 | 예시 | 승인 |
+|------|------|------|
+| 새 명령어 추가 | `myapp new-command` | 기록만 |
+| 새 옵션 추가 | `--new-option` | 기록만 |
+| 새 서브커맨드 추가 | `myapp config new-sub` | 기록만 |
+| 기본값 변경 (호환) | 기본 출력 형식 | 기록만 |
+
+### 2.2 Breaking Change (비호환)
+
+| 유형 | 예시 | 승인 |
+|------|------|------|
+| 명령어 삭제 | `myapp old-command` 제거 | Manager |
+| 명령어 이름 변경 | `old` → `new` | Manager |
+| 필수 인자 추가 | 기존 명령어에 필수 인자 | Manager |
+| 옵션 삭제 | `--removed-option` | Manager |
+| 옵션 동작 변경 | `--flag` 의미 변경 | Manager |
+| 종료 코드 변경 | 코드 의미 변경 | Manager |
+| 출력 형식 변경 | 기본 출력 구조 변경 | Manager |
+
+---
+
+## 3. 변경 절차
+
+### 3.1 Non-Breaking Change
+
+```
+변경 필요 발견
+    ↓
+commands.md에 [ADDED] 태그로 추가
+    ↓
+구현 진행
+    ↓
+문서 확정 (태그 제거)
+```
+
+### 3.2 Breaking Change
+
+```
+Breaking Change 필요 발견
+    ↓
+Manager에게 에스컬레이션
+    ↓
+commands.md에 [BREAKING] 태그로 추가
+    ↓
+Deprecation 계획 수립
+    ↓
+Manager 승인
+    ↓
+Deprecation 구현 (경고 출력)
+    ↓
+다음 Major 버전에서 제거
+```
+
+---
+
+## 4. Deprecation 절차
+
+### 4.1 단계
+
+```
+1. MINOR 버전: Deprecated 표시 + 경고 출력
+2. 최소 1개 MINOR 버전 유지
+3. 다음 MAJOR: 제거
+```
+
+### 4.2 Deprecation 경고
+
+```bash
+$ myapp old-command
+
+⚠ Warning: 'old-command' is deprecated and will be removed in v2.0.0
+  Use 'new-command' instead.
+
+[실제 동작 수행]
+```
+
+### 4.3 문서 표시
+
+```markdown
+## old-command ⚠️ Deprecated
+
+> **Deprecated since v1.2.0**
+> v2.0.0에서 제거 예정
+> 대신 `new-command`를 사용하세요.
+```
+
+---
+
+## 5. 명령어 별칭
+
+Breaking change를 피하기 위한 방법:
+
+### 5.1 별칭 추가
+
+```bash
+# 새 이름이 주, 기존 이름은 별칭
+myapp new-command  # 주 명령어
+myapp old-command  # 별칭 (경고 없음)
+```
+
+### 5.2 Soft Deprecation
+
+```bash
+# 별칭을 유지하되 문서에서만 새 이름 권장
+# 경고 출력 없음, 문서만 업데이트
+```
+
+---
+
+## 6. 출력 형식 변경
+
+### 6.1 JSON 출력
+
+- JSON 스키마 변경은 Breaking
+- 필드 추가는 Non-Breaking
+- 필드 제거는 Breaking
+- 타입 변경은 Breaking
+
+### 6.2 Text 출력
+
+- 레이아웃 변경은 허용
+- 파싱에 의존하는 출력 변경은 Breaking
+
+---
+
+## 7. 버전별 변경 가이드
+
+| 버전 유형 | 허용 변경 |
+|----------|----------|
+| PATCH | 버그 수정, 문서 수정 |
+| MINOR | 새 명령어/옵션, Deprecation |
+| MAJOR | Breaking changes, 제거 |
+
+---
+
+## 8. 변경 요청 형식
+
+### Non-Breaking
+
+```markdown
+## 명령어 추가 요청
+
+- Task: TASK-XXX
+- 유형: Non-Breaking
+
+### 추가 내용
+- 명령어: `myapp new-command`
+- 설명: [설명]
+
+### 사용 예시
+```bash
+myapp new-command --option value
+```
+```
+
+### Breaking
+
+```markdown
+## Breaking Change 요청
+
+- Task: TASK-XXX
+- 유형: Breaking
+
+### 변경 내용
+- Before: `myapp old-command`
+- After: `myapp new-command`
+
+### 변경 사유
+[사유]
+
+### 마이그레이션 가이드
+1. [단계]
+2. [단계]
+
+### Deprecation 계획
+- v1.2.0: Deprecated + 경고
+- v2.0.0: 제거
+```
+
+---
+
+## 9. 금지 사항
+
+- ❌ 문서 없이 명령어 변경
+- ❌ Manager 승인 없이 Breaking change
+- ❌ Deprecation 없이 명령어 제거
+- ❌ 경고 없이 동작 변경
+
+---
+
+## 10. 체크리스트
+
+### 명령어 변경 전
+
+- [ ] 변경 유형 분류 (Non-Breaking/Breaking)
+- [ ] commands.md에 태그 추가
+- [ ] (Breaking) Manager 승인
+- [ ] (Breaking) Deprecation 계획
+
+### 명령어 변경 후
+
+- [ ] commands.md 갱신
+- [ ] output-format.md 갱신 (필요 시)
+- [ ] 변경 이력 기록
+- [ ] 테스트 완료

package/templates/game/artifacts/assets.md

@@ -0,0 +1,148 @@
+# Assets Specification
+
+> 게임 에셋 관리 문서
+> 모든 에셋의 목록과 스펙
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 버전 | v1.0 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 에셋 디렉토리 구조
+
+```
+assets/
+├── sprites/           # 2D 스프라이트
+│   ├── characters/
+│   ├── enemies/
+│   ├── items/
+│   └── ui/
+├── animations/        # 애니메이션 데이터
+├── audio/            # 사운드
+│   ├── bgm/
+│   ├── sfx/
+│   └── voice/
+├── fonts/            # 폰트
+└── data/             # 데이터 파일
+```
+
+---
+
+## 2. 스프라이트
+
+### 2.1 캐릭터
+
+| ID | 이름 | 경로 | 크기 | 프레임 | 상태 |
+|----|------|------|------|:------:|:----:|
+| CHR_001 | Player | sprites/characters/player.png | 64x64 | 8 | ✅ |
+| CHR_002 | NPC_01 | sprites/characters/npc_01.png | 64x64 | 4 | ⏳ |
+
+### 2.2 적
+
+| ID | 이름 | 경로 | 크기 | 프레임 | 상태 |
+|----|------|------|------|:------:|:----:|
+| ENM_001 | Slime | sprites/enemies/slime.png | 32x32 | 4 | ✅ |
+| ENM_002 | Goblin | sprites/enemies/goblin.png | 48x48 | 6 | 📋 |
+
+### 2.3 아이템
+
+| ID | 이름 | 경로 | 크기 | 상태 |
+|----|------|------|------|:----:|
+| ITM_001 | Potion | sprites/items/potion.png | 16x16 | ✅ |
+| ITM_002 | Sword | sprites/items/sword.png | 24x24 | ✅ |
+
+### 2.4 UI
+
+| ID | 이름 | 경로 | 크기 | 용도 |
+|----|------|------|------|------|
+| UI_001 | HealthBar | sprites/ui/health_bar.png | 200x20 | 체력바 |
+| UI_002 | Button | sprites/ui/button.png | 120x40 | 버튼 |
+
+---
+
+## 3. 애니메이션
+
+| ID | 대상 | 이름 | 프레임 | FPS | 루프 |
+|----|------|------|:------:|:---:|:----:|
+| ANI_001 | CHR_001 | idle | 4 | 8 | ✅ |
+| ANI_002 | CHR_001 | walk | 6 | 12 | ✅ |
+| ANI_003 | CHR_001 | attack | 4 | 16 | ❌ |
+| ANI_004 | ENM_001 | idle | 2 | 4 | ✅ |
+
+---
+
+## 4. 오디오
+
+### 4.1 BGM
+
+| ID | 이름 | 경로 | 길이 | 루프 |
+|----|------|------|------|:----:|
+| BGM_001 | Title | audio/bgm/title.ogg | 2:30 | ✅ |
+| BGM_002 | Battle | audio/bgm/battle.ogg | 1:45 | ✅ |
+
+### 4.2 SFX
+
+| ID | 이름 | 경로 | 트리거 |
+|----|------|------|--------|
+| SFX_001 | Attack | audio/sfx/attack.wav | 공격 시 |
+| SFX_002 | Hit | audio/sfx/hit.wav | 피격 시 |
+| SFX_003 | LevelUp | audio/sfx/levelup.wav | 레벨업 시 |
+
+---
+
+## 5. 에셋 스펙 규칙
+
+### 5.1 이미지
+
+| 항목 | 규칙 |
+|------|------|
+| 포맷 | PNG (투명도 필요 시), JPG (배경) |
+| 색상 | RGBA 32bit |
+| 크기 | 2의 제곱수 권장 (32, 64, 128...) |
+
+### 5.2 오디오
+
+| 항목 | 규칙 |
+|------|------|
+| BGM 포맷 | OGG |
+| SFX 포맷 | WAV |
+| 샘플레이트 | 44100Hz |
+| 채널 | Stereo (BGM), Mono (SFX) |
+
+---
+
+## 6. 에셋 요청
+
+새 에셋이 필요한 경우:
+
+```markdown
+## 에셋 요청
+
+- 요청자: [역할]
+- Task: TASK-XXX
+- 유형: Sprite / Animation / Audio
+
+### 스펙
+- 이름: [에셋명]
+- 크기: [크기]
+- 프레임: [프레임 수] (애니메이션인 경우)
+- 설명: [용도 설명]
+
+### 우선순위
+P0 / P1 / P2
+```
+
+---
+
+## 7. 변경 이력
+
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-001] | YYYY-MM-DD | 초기 에셋 목록 |
+| [TASK-002] | YYYY-MM-DD | 전투 이펙트 추가 |