@silbaram/artifact-driven-agent 0.1.0

package/templates/cli/artifacts/commands.md

@@ -0,0 +1,262 @@
+# Commands Specification
+
+> CLI 명령어 정의 문서
+> 모든 명령어의 단일 진실
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 프로그램명 | [program-name] |
+| 버전 | v1.0.0 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 전역 옵션
+
+모든 명령어에서 사용 가능한 옵션:
+
+| 옵션 | 축약 | 설명 |
+|------|------|------|
+| --help | -h | 도움말 표시 |
+| --version | -V | 버전 표시 |
+| --verbose | -v | 상세 출력 |
+| --quiet | -q | 최소 출력 |
+| --config | -c | 설정 파일 경로 |
+| --format | -f | 출력 형식 (text/json/table) |
+
+---
+
+## 2. 명령어 목록
+
+| 명령어 | 설명 | 상태 | Task |
+|--------|------|:----:|------|
+| init | 프로젝트 초기화 | ✅ | TASK-001 |
+| config | 설정 관리 | ⏳ | TASK-002 |
+| run | 실행 | 📋 | TASK-003 |
+
+---
+
+## 3. init
+
+프로젝트를 초기화합니다.
+
+### 사용법
+
+```bash
+[program] init [directory] [options]
+```
+
+### 인자
+
+| 인자 | 타입 | 필수 | 설명 |
+|------|------|:----:|------|
+| directory | path | ❌ | 대상 디렉토리 (기본: .) |
+
+### 옵션
+
+| 옵션 | 축약 | 타입 | 기본값 | 설명 |
+|------|------|------|--------|------|
+| --template | -t | string | default | 템플릿 이름 |
+| --force | -f | flag | false | 기존 파일 덮어쓰기 |
+| --no-git | | flag | false | git 초기화 건너뛰기 |
+
+### 예시
+
+```bash
+# 현재 디렉토리에 초기화
+[program] init
+
+# 특정 디렉토리에 초기화
+[program] init my-project
+
+# 템플릿 사용
+[program] init --template typescript
+
+# 강제 덮어쓰기
+[program] init --force
+```
+
+### 종료 코드
+
+| 코드 | 의미 |
+|:----:|------|
+| 0 | 성공 |
+| 1 | 초기화 실패 |
+| 2 | 디렉토리가 비어있지 않음 (--force 없이) |
+
+---
+
+## 4. config
+
+설정을 관리합니다.
+
+### 사용법
+
+```bash
+[program] config <subcommand> [options]
+```
+
+### 서브커맨드
+
+#### config get
+
+```bash
+[program] config get <key>
+```
+
+설정 값을 조회합니다.
+
+| 인자 | 타입 | 필수 | 설명 |
+|------|------|:----:|------|
+| key | string | ✅ | 설정 키 |
+
+#### config set
+
+```bash
+[program] config set <key> <value> [options]
+```
+
+설정 값을 저장합니다.
+
+| 인자 | 타입 | 필수 | 설명 |
+|------|------|:----:|------|
+| key | string | ✅ | 설정 키 |
+| value | string | ✅ | 설정 값 |
+
+| 옵션 | 설명 |
+|------|------|
+| --global | 전역 설정에 저장 |
+
+#### config list
+
+```bash
+[program] config list [options]
+```
+
+모든 설정을 표시합니다.
+
+| 옵션 | 설명 |
+|------|------|
+| --global | 전역 설정만 표시 |
+| --local | 로컬 설정만 표시 |
+
+### 예시
+
+```bash
+# 설정 조회
+[program] config get user.name
+
+# 설정 저장
+[program] config set user.name "John Doe"
+
+# 전역 설정
+[program] config set user.email "john@example.com" --global
+
+# 모든 설정 표시
+[program] config list
+```
+
+### 종료 코드
+
+| 코드 | 의미 |
+|:----:|------|
+| 0 | 성공 |
+| 1 | 설정 오류 |
+| 2 | 키를 찾을 수 없음 |
+
+---
+
+## 5. run
+
+프로젝트를 실행합니다.
+
+### 사용법
+
+```bash
+[program] run [script] [options] [-- args]
+```
+
+### 인자
+
+| 인자 | 타입 | 필수 | 설명 |
+|------|------|:----:|------|
+| script | string | ❌ | 스크립트 이름 (기본: default) |
+
+### 옵션
+
+| 옵션 | 축약 | 타입 | 기본값 | 설명 |
+|------|------|------|--------|------|
+| --watch | -w | flag | false | 파일 변경 감시 |
+| --env | -e | string | development | 환경 |
+
+### 예시
+
+```bash
+# 기본 실행
+[program] run
+
+# 특정 스크립트 실행
+[program] run build
+
+# 감시 모드
+[program] run --watch
+
+# 인자 전달
+[program] run test -- --coverage
+```
+
+### 종료 코드
+
+| 코드 | 의미 |
+|:----:|------|
+| 0 | 성공 |
+| 1 | 실행 실패 |
+| 127 | 스크립트를 찾을 수 없음 |
+
+---
+
+## 6. 환경 변수
+
+| 변수 | 설명 | 기본값 |
+|------|------|--------|
+| [PROGRAM]_CONFIG | 설정 파일 경로 | ~/.config/[program] |
+| [PROGRAM]_HOME | 홈 디렉토리 | ~ |
+| [PROGRAM]_DEBUG | 디버그 모드 | false |
+| NO_COLOR | 색상 출력 비활성화 | - |
+
+---
+
+## 7. 설정 파일
+
+### 위치 (우선순위)
+
+1. --config 옵션
+2. ./[program].config
+3. $[PROGRAM]_CONFIG
+4. ~/.config/[program]/config
+
+### 형식
+
+```yaml
+# [program].config
+user:
+  name: "John Doe"
+  email: "john@example.com"
+
+defaults:
+  template: typescript
+  env: development
+```
+
+---
+
+## 8. 변경 이력
+
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-001] | YYYY-MM-DD | init 명령어 추가 |
+| [TASK-002] | YYYY-MM-DD | config 명령어 추가 |

package/templates/cli/artifacts/output-format.md

@@ -0,0 +1,298 @@
+# Output Format Specification
+
+> CLI 출력 형식 정의
+> 일관된 사용자 경험을 위한 표준
+
+---
+
+## 0. 문서 메타
+
+| 항목 | 값 |
+|------|-----|
+| 버전 | v1.0 |
+| 최종 수정 | YYYY-MM-DD |
+
+---
+
+## 1. 출력 스트림
+
+### 1.1 stdout (표준 출력)
+
+**용도:** 명령어의 실제 결과
+
+```bash
+# 결과 데이터
+[program] list
+item1
+item2
+item3
+```
+
+### 1.2 stderr (표준 에러)
+
+**용도:** 에러, 경고, 진행 상황
+
+```bash
+# 에러
+Error: Something went wrong
+
+# 진행 상황
+Processing... 50%
+```
+
+---
+
+## 2. 메시지 유형
+
+### 2.1 성공
+
+```
+✓ Operation completed successfully
+```
+
+### 2.2 에러
+
+```
+✗ Error: [에러 메시지]
+
+[상세 설명 (있는 경우)]
+
+Usage: [올바른 사용법]
+```
+
+### 2.3 경고
+
+```
+⚠ Warning: [경고 메시지]
+```
+
+### 2.4 정보
+
+```
+ℹ [정보 메시지]
+```
+
+### 2.5 진행 상황
+
+```
+⠋ Processing file.txt...
+[████████░░░░░░░░] 50%
+```
+
+---
+
+## 3. 출력 형식
+
+### 3.1 Text (기본)
+
+사람이 읽기 좋은 형식:
+
+```
+Name:    John Doe
+Email:   john@example.com
+Created: 2024-01-15
+```
+
+### 3.2 JSON
+
+스크립트/파이프용:
+
+```json
+{
+  "name": "John Doe",
+  "email": "john@example.com",
+  "created": "2024-01-15"
+}
+```
+
+### 3.3 Table
+
+정렬된 목록:
+
+```
+NAME       EMAIL                CREATED
+─────────────────────────────────────────
+John Doe   john@example.com     2024-01-15
+Jane Doe   jane@example.com     2024-01-16
+```
+
+### 3.4 Quiet
+
+최소 출력 (파이프용):
+
+```
+john@example.com
+jane@example.com
+```
+
+---
+
+## 4. 색상 사용
+
+### 4.1 색상 코드
+
+| 용도 | 색상 |
+|------|------|
+| 성공 | 초록 |
+| 에러 | 빨강 |
+| 경고 | 노랑 |
+| 정보 | 파랑 |
+| 강조 | 볼드 |
+| 경로/코드 | 시안 |
+
+### 4.2 색상 비활성화
+
+```bash
+# 환경 변수
+NO_COLOR=1 [program] list
+
+# 옵션
+[program] list --no-color
+
+# 파이프 시 자동 비활성화
+[program] list | grep "item"
+```
+
+---
+
+## 5. 대화형 프롬프트
+
+### 5.1 확인 (Y/N)
+
+```
+? Are you sure? (y/N) 
+```
+
+### 5.2 선택
+
+```
+? Select an option:
+  ❯ Option 1
+    Option 2
+    Option 3
+```
+
+### 5.3 입력
+
+```
+? Enter your name: █
+```
+
+### 5.4 비대화형 모드
+
+```bash
+# 모든 확인 자동 수락
+[program] delete --yes
+
+# 또는
+echo "y" | [program] delete
+```
+
+---
+
+## 6. 진행 상황
+
+### 6.1 스피너
+
+```
+⠋ Loading...
+⠙ Loading...
+⠹ Loading...
+⠸ Loading...
+```
+
+### 6.2 프로그레스 바
+
+```
+Downloading [████████░░░░░░░░] 50% (5.0 MB / 10.0 MB)
+```
+
+### 6.3 단계 표시
+
+```
+[1/3] Downloading dependencies...
+[2/3] Building project...
+[3/3] Running tests...
+```
+
+---
+
+## 7. 에러 출력
+
+### 7.1 기본 에러
+
+```
+✗ Error: File not found: config.json
+```
+
+### 7.2 상세 에러 (--verbose)
+
+```
+✗ Error: File not found: config.json
+
+   at readConfig (/path/to/file.js:10)
+   at main (/path/to/file.js:5)
+
+Cause: ENOENT: no such file or directory
+```
+
+### 7.3 사용법 에러
+
+```
+✗ Error: Missing required argument: <name>
+
+Usage: [program] create <name> [options]
+
+For more information, try '--help'
+```
+
+---
+
+## 8. 도움말
+
+### 8.1 전체 도움말
+
+```
+[program-name] v1.0.0 - [설명]
+
+Usage: [program] <command> [options]
+
+Commands:
+  init      Initialize a new project
+  config    Manage configuration
+  run       Run the project
+
+Options:
+  -h, --help     Show help
+  -V, --version  Show version
+
+Run '[program] <command> --help' for more information
+```
+
+### 8.2 명령어 도움말
+
+```
+Usage: [program] init [directory] [options]
+
+Initialize a new project
+
+Arguments:
+  directory    Target directory (default: .)
+
+Options:
+  -t, --template <name>  Template to use
+  -f, --force            Overwrite existing files
+  --no-git               Skip git initialization
+
+Examples:
+  [program] init
+  [program] init my-project --template typescript
+```
+
+---
+
+## 9. 변경 이력
+
+| Task | 날짜 | 변경 내용 |
+|------|------|----------|
+| [TASK-001] | YYYY-MM-DD | 초기 출력 형식 정의 |