npm - aiwf - Versions diffs - 0.3.23 → 0.4.0 - Mend

aiwf 0.3.23 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (321) hide show

package/docs/CLI_USAGE_GUIDE.ko.md DELETED Viewed

@@ -1,634 +0,0 @@
-# AIWF CLI 사용 가이드
-## 📋 목차
-1. [설치 및 초기 설정](#설치-및-초기-설정)
-2. [기본 명령어](#기본-명령어)
-3. [AI 도구 관리](#ai-도구-관리)
-4. [캐시 관리](#캐시-관리)
-5. [언어 관리](#언어-관리)
-6. [독립 스프린트 관리 (YOLO 중심)](#독립-스프린트-관리-yolo-중심)
-7. [체크포인트 시스템 (YOLO 복구)](#체크포인트-시스템-yolo-복구)
-8. [YOLO 설정 관리](#yolo-설정-관리)
-9. [Claude Code 통합 명령어](#claude-code-통합-명령어)
-10. [Git 통합 및 Feature Tracking](#git-통합-및-feature-tracking)
-11. [일반적인 워크플로우](#일반적인-워크플로우)
-12. [문제 해결](#문제-해결)
----
-## 🚀 설치 및 초기 설정
-### 설치
-```bash
-# 전역 설치 (권장)
-npm install -g aiwf
-# 프로젝트 디렉토리에서
-cd my-project
-aiwf install
-```
-설치 과정에서 안내하는 내용:
-1. 언어 선택 (한국어/English)
-2. 프로젝트 구조 생성
-3. Claude 명령어 설치
-### 강제 설치 (프롬프트 없이)
-```bash
-aiwf install --force
-# 또는
-aiwf install -f
-```
-### 설치 후 생성되는 구조
-```
-your-project/
-├── .aiwf/                    # AIWF 프로젝트 관리
-├── .claude/commands/aiwf/    # Claude Code 명령어
-├── .cursor/rules/            # Cursor IDE 규칙
-├── .windsurf/rules/          # Windsurf IDE 규칙
-└── [기존 프로젝트 파일들]
-```
----
-## 📌 기본 명령어
-### aiwf 메인 명령어
-```bash
-# 기본 설치 (install이 기본 동작)
-aiwf
-# 명시적 설치
-aiwf install
-# 강제 설치
-aiwf install --force
-# 도움말
-aiwf --help
-# 버전 확인
-aiwf --version
-```
----
-## 🤖 AI 도구 관리
-### AI 도구 설치
-```bash
-# 특정 AI 도구 템플릿 설치
-aiwf ai-tool install claude-code
-aiwf ai-tool install cursor
-aiwf ai-tool install windsurf
-aiwf ai-tool install github-copilot
-aiwf ai-tool install augment
-```
-### AI 도구 목록 확인
-```bash
-# 설치 가능한 도구와 설치된 도구 목록
-aiwf ai-tool list
-```
-출력 예시:
-```
-🤖 AI Tool Templates
-claude-code
-  Status: ✓ Installed
-  Version: 1.0.0
-  Features: custom_instructions, project_context, command_integration
-cursor
-  Status: Available
-  Version: 1.0.0
-  Features: smart_completion, aiwf_context_awareness, project_structure_recognition
-windsurf
-  Status: Available
-  Version: 1.0.0
-  Features: ai_assistance, code_generation, context_awareness
-```
-### AI 도구 업데이트
-```bash
-# 특정 도구 업데이트
-aiwf ai-tool update claude-code
-# 업데이트 확인
-aiwf ai-tool check
-aiwf ai-tool check claude-code  # 특정 도구만
-```
-### AI 도구 검증
-```bash
-# 설치 상태 검증
-aiwf ai-tool verify claude-code
-```
-### AI 도구 버전 확인
-```bash
-aiwf ai-tool version claude-code
-```
----
-## 💾 캐시 관리
-### 템플릿 다운로드 (오프라인 사용)
-```bash
-# 대화형 선택
-aiwf cache download
-# 모든 템플릿 다운로드
-aiwf cache download --all
-# 특정 타입만 다운로드
-aiwf cache download --type ai-tools
-aiwf cache download --type projects
-```
-### 캐시 목록 확인
-```bash
-# 전체 캐시 목록
-aiwf cache list
-# 타입별 필터
-aiwf cache list --type ai-tools
-```
-### 캐시 정리
-```bash
-# 만료된 캐시만 정리 (기본 7일)
-aiwf cache clean
-# 모든 캐시 삭제
-aiwf cache clean --all
-# 특정 기간 이상된 캐시 삭제
-aiwf cache clean --max-age 30  # 30일 이상
-```
-### 캐시 업데이트
-```bash
-# 업데이트 확인
-aiwf cache update
-# 업데이트 확인 후 자동 설치
-aiwf cache update --install
-```
-### 캐시 상태 확인
-```bash
-aiwf cache status
-```
-출력 예시:
-```
-📊 AIWF Cache Status
-Cache Location: /Users/username/.aiwf-cache
-Network Status: Online
-Cache Statistics:
-  Total Size: 24.3 MB
-  Templates: 12
-  AI Tools: 5
-  Oldest Entry: 2024-01-13
-By Status:
-  Valid: 10 templates
-  Expired: 2 templates
-  Corrupted: 0 templates
-```
----
-## 🌐 언어 관리
-### 언어 상태 확인
-```bash
-# 현재 언어 설정 확인
-aiwf-lang
-aiwf-lang status
-aiwf-lang s  # 별칭
-```
-### 언어 변경
-```bash
-# 한국어로 변경
-aiwf-lang set ko
-# 영어로 변경
-aiwf-lang set en
-# 대화형 선택
-aiwf-lang set
-# 자동 감지 설정
-aiwf-lang set --auto-detect true
-aiwf-lang set --auto-detect false
-```
-### 언어 초기화
-```bash
-# 자동 감지 모드로 리셋
-aiwf-lang reset
-aiwf-lang r  # 별칭
-```
----
-## 🚀 독립 스프린트 관리 (YOLO 중심)
-### 독립 스프린트 생성
-```bash
-# README TODO에서 자동 추출
-aiwf sprint independent --from-readme
-# GitHub 이슈에서 생성
-aiwf sprint independent --from-issue 123
-# 대화형 생성
-aiwf sprint independent "빠른 프로토타입"
-# 엔지니어링 레벨 지정
-aiwf sprint independent "API 개발" --minimal    # 최소 구현
-aiwf sprint independent "API 개발" --balanced   # 균형잡힌 구현
-aiwf sprint independent "API 개발" --complete   # 완전한 구현
-```
-### 스프린트 목록 및 상태
-```bash
-# 모든 스프린트 목록
-aiwf-sprint list
-aiwf-sprint ls
-# 상태별 필터링
-aiwf-sprint list --status active
-aiwf-sprint list --status completed
-# 특정 스프린트 상태 확인
-aiwf-sprint status S01
-```
-### 전용 CLI 도구 (aiwf-sprint)
-```bash
-# 도움말
-aiwf-sprint help
-# 독립 스프린트 생성
-aiwf-sprint independent --from-readme --minimal
-aiwf-sprint ind "빠른 기능" --balanced
-```
-출력 예시:
-```
-🚀 독립 스프린트 생성 중...
-✅ 독립 스프린트 생성 완료!
-  스프린트 ID: S03
-  태스크 수: 5개
-🚀 다음 단계:
-  Claude Code에서 /project:aiwf:yolo S03 실행
-```
----
-## 💾 체크포인트 시스템 (YOLO 복구)
-### 체크포인트 관리
-```bash
-# 체크포인트 목록 보기
-aiwf checkpoint list
-aiwf checkpoint ls
-aiwf checkpoint list --limit 20
-# 현재 YOLO 세션 상태
-aiwf checkpoint status
-# 체크포인트에서 복구
-aiwf checkpoint restore cp_1234567890
-# 수동 체크포인트 생성
-aiwf checkpoint create "주요 리팩토링 전"
-# 오래된 체크포인트 정리
-aiwf checkpoint clean --keep 10
-aiwf checkpoint clean --keep 5 --dry-run  # 실제 삭제 없이 미리보기
-```
-### 전용 CLI 도구 (aiwf-checkpoint)
-```bash
-# 도움말
-aiwf-checkpoint help
-# 진행 상황 리포트
-aiwf-checkpoint report
-# 체크포인트 상세 정보
-aiwf-checkpoint show cp_1234567890
-```
-출력 예시:
-```
-📊 체크포인트 목록:
-🚀 cp_1703123456789 - session_start
-    태스크: 0개 완료
-✅ cp_1703123556789 - task_complete
-    태스크: 5개 완료
-🔄 cp_1703123656789 - auto
-    태스크: 10개 완료
-```
----
-## 🛠️ YOLO 설정 관리
-### YOLO 설정 초기화
-```bash
-# 기본 설정 파일 생성
-aiwf yolo-config init
-# 기존 파일 덮어쓰기
-aiwf yolo-config init --force
-# 대화형 설정 마법사
-aiwf yolo-config wizard
-aiwf yolo-config interactive
-# 현재 설정 확인
-aiwf yolo-config show
-aiwf yolo-config status
-```
-### 설정 마법사 옵션
-대화형 마법사에서 설정할 수 있는 항목:
-- 엔지니어링 레벨 (minimal/balanced/complete)
-- 포커스 규칙 (요구사항 우선, 간단한 해결책 등)
-- 실행 모드 (빠른/스마트/안전)
-- 체크포인트 설정
-- 오버엔지니어링 방지 규칙
-출력 예시:
-```
-🛠️ YOLO 설정 마법사
-엔지니어링 레벨을 선택하세요:
-❯ 최소 (Minimal) - 빠른 프로토타입, 최소 구현
-  균형 (Balanced) - 품질과 속도의 균형
-  완전 (Complete) - 완전한 구현, 높은 품질
-✅ 커스텀 YOLO 설정이 생성되었습니다!
-📁 위치: .aiwf/yolo-config.yaml
-```
----
-## 🤝 Claude Code 통합 명령어
-Claude Code에서 사용할 수 있는 `/aiwf_*` 명령어들:
-### 프로젝트 초기화
-```
-/aiwf_initialize          # 프로젝트 초기 설정
-/aiwf_prime              # 프로젝트 컨텍스트 로드
-```
-### 계획 및 작업 관리
-```
-/aiwf_create_milestone_plan      # 마일스톤 계획 생성
-/aiwf_create_sprints_from_milestone  # 스프린트 생성
-/aiwf_create_sprint_tasks        # 스프린트 작업 생성
-/aiwf_create_general_task        # 일반 작업 생성
-/aiwf_create_prd                 # 제품 요구사항 문서 생성
-```
-### 개발 작업
-```
-/aiwf_do_task                    # 작업 실행
-/aiwf_commit                     # Git 커밋 생성
-/aiwf_test                       # 테스트 실행
-```
-### 코드 리뷰
-```
-/aiwf_code_review                # 코드 리뷰
-/aiwf_project_review             # 프로젝트 전체 리뷰
-/aiwf_testing_review             # 테스트 커버리지 리뷰
-/aiwf_discuss_review             # 리뷰 결과 토론
-```
-### AI 페르소나
-```
-/project:aiwf:ai_persona:architect      # 아키텍트 페르소나
-/project:aiwf:ai_persona:backend        # 백엔드 개발자
-/project:aiwf:ai_persona:frontend       # 프론트엔드 개발자
-/project:aiwf:ai_persona:security       # 보안 전문가
-/project:aiwf:ai_persona:data_analyst   # 데이터 분석가
-/project:aiwf:ai_persona:status         # 현재 페르소나 상태
-/project:aiwf:ai_persona:auto on        # 자동 페르소나 전환
-```
-### GitHub 통합
-```
-/aiwf_pr_create                  # Pull Request 생성
-/aiwf_issue_create               # GitHub Issue 생성
-```
-### 고급 기능
-```
-/aiwf_yolo                       # 자동 작업 실행
-/aiwf_infinite                   # 연속 작업 모드
-/aiwf_ultrathink_code_advanced   # 고급 코드 분석
-```
----
-## 🔗 Git 통합 및 Feature Tracking
-### Git Hooks 설치
-```bash
-# 프로젝트 루트에서 실행
-./hooks/install-hooks.sh
-```
-### Feature 관련 스크립트
-```bash
-# Git 히스토리에서 Feature ID 스캔
-node commands/scan-git-history.js --since 2025-01-01
-# 특정 Feature의 커밋 동기화
-node commands/sync-feature-commits.js FL001
-# Feature 커밋 리포트 생성
-node commands/feature-commit-report.js --format markdown
-```
-### Git 커밋 시 자동 Feature 추적
-```bash
-# Feature ID가 포함된 커밋
-git commit -m "feat(FL001): 인증 시스템 구현"
-# post-commit hook이 자동으로 Feature Ledger 업데이트
-```
----
-## 💡 일반적인 워크플로우
-### 1. 새 프로젝트 시작
-```bash
-# 1. 프로젝트 생성
-mkdir my-awesome-project
-cd my-awesome-project
-# 2. AIWF 설치
-aiwf install
-# 3. Git hooks 설치
-git init
-./hooks/install-hooks.sh
-# 4. AI 도구 설정
-aiwf ai-tool install claude-code
-aiwf ai-tool install cursor
-# 5. Claude Code에서 프로젝트 열기
-# 그 후 /aiwf_initialize 실행
-```
-### 2. 기존 프로젝트에 추가
-```bash
-# 1. 프로젝트 디렉토리로 이동
-cd existing-project
-# 2. AIWF 설치
-aiwf install
-# 3. 기존 구조와 통합
-/aiwf_prime  # Claude Code에서
-```
-### 3. 팀 협업 설정
-```bash
-# 1. 언어 설정 통일
-aiwf-lang set ko  # 또는 en
-# 2. AI 도구 표준화
-aiwf ai-tool install claude-code
-aiwf ai-tool install cursor
-# 3. Git hooks 설정
-./hooks/install-hooks.sh
-# 4. .gitignore에 추가
-echo ".aiwf/backup_*" >> .gitignore
-echo "token-data/" >> .gitignore
-```
-### 4. 오프라인 개발 준비
-```bash
-# 1. 모든 템플릿 다운로드
-aiwf cache download --all
-# 2. 캐시 상태 확인
-aiwf cache status
-# 3. 오프라인에서도 정상 작동
-# 캐시된 템플릿 자동 사용
-```
----
-## 🔧 문제 해결
-### 설치 실패 시
-```bash
-# 1. 강제 재설치
-aiwf install --force
-# 2. 캐시 정리 후 재시도
-aiwf cache clean --all
-aiwf install
-# 3. 수동 정리
-rm -rf .aiwf .claude .cursor .windsurf
-aiwf install
-```
-### 언어 관련 문제
-```bash
-# 언어 설정 초기화
-aiwf-lang reset
-# 수동으로 언어 설정
-aiwf-lang set ko --auto-detect false
-```
-### 네트워크 문제
-```bash
-# 1. 캐시 모드 사용
-aiwf cache download --all  # 온라인일 때 미리 실행
-# 2. 프록시 설정 (필요시)
-export HTTPS_PROXY=http://proxy.company.com:8080
-aiwf install
-```
-### 권한 문제
-```bash
-# 실행 권한 부여
-chmod +x hooks/install-hooks.sh
-chmod +x hooks/post-commit
-chmod +x index.js
-chmod +x language-cli.js
-```
-### 업데이트 후 문제 발생
-```bash
-# 백업에서 복원
-# 백업 위치: .aiwf/backup_YYYY-MM-DD_HHMMSS
-cp -r .aiwf/backup_2024-01-20_143052/* .aiwf/
-```
----
-## 📚 추가 리소스
-- **GitHub 저장소**: https://github.com/moonklabs/aiwf
-- **문제 보고**: https://github.com/moonklabs/aiwf/issues
-- **문서**: [COMMANDS_GUIDE.md](docs/COMMANDS_GUIDE.md)
-- **한국어 문서**: [COMMANDS_GUIDE.ko.md](docs/COMMANDS_GUIDE.ko.md)
----
-## 🎯 빠른 참조
-```bash
-# 전역 설치
-npm install -g aiwf
-# 프로젝트 설정
-aiwf install
-# AI 도구
-aiwf ai-tool install claude-code
-aiwf ai-tool list
-# 캐시
-aiwf cache download --all
-aiwf cache status
-# 언어
-aiwf-lang set ko
-aiwf-lang status
-# Git hooks
-./hooks/install-hooks.sh
-```