aiwf 0.3.1 → 0.3.2

package/.aiwf/.claude/commands/aiwf/aiwf_compress_aggressive_persona.md

@@ -0,0 +1,53 @@
+# aiwf compress-aggressive-persona
+
+활성화된 페르소나를 고려하여 공격적 모드로 컨텍스트를 압축합니다.
+
+## 실행
+
+```javascript
+const { spawn } = require('child_process');
+const path = require('path');
+
+// .aiwf 디렉토리로 이동하여 명령 실행
+const cwd = path.join(process.cwd(), '.aiwf');
+const proc = spawn('node', [
+  '../claude-code/aiwf/ko/commands/compress-context.js',
+  'aggressive',
+  '--persona'
+], { cwd, stdio: 'inherit' });
+
+proc.on('error', (err) => {
+  console.error('명령 실행 실패:', err.message);
+});
+```
+
+## 설명
+
+페르소나 특성을 고려하면서도 50-70%의 높은 압축률을 목표로 합니다. 페르소나 관련 핵심 정보는 보존하되, 나머지는 적극적으로 요약합니다.
+
+### 특징
+
+- 페르소나 중심 요약 생성
+- 핵심 패턴만 보존
+- 중요도가 낮은 섹션은 요약으로 대체
+- 페르소나별 summarization focus 적용
+
+## 압축 결과
+
+압축 후 페르소나별 요약이 문서 하단에 추가됩니다:
+
+```markdown
+---
+### [페르소나명] 관점 요약
+
+주요 내용 ([페르소나의 focus]):
+- 핵심 포인트 1
+- 핵심 포인트 2
+- ...
+---
+```
+
+## 주의사항
+
+- 매우 높은 압축률로 인해 일부 세부 정보가 손실될 수 있습니다
+- 중요한 문서는 백업 후 사용을 권장합니다

package/.aiwf/.claude/commands/aiwf/aiwf_compress_minimal_persona.md

@@ -0,0 +1,48 @@
+# aiwf compress-minimal-persona
+
+활성화된 페르소나를 고려하여 최소 모드로 컨텍스트를 압축합니다.
+
+## 실행
+
+```javascript
+const { spawn } = require('child_process');
+const path = require('path');
+
+// .aiwf 디렉토리로 이동하여 명령 실행
+const cwd = path.join(process.cwd(), '.aiwf');
+const proc = spawn('node', [
+  '../claude-code/aiwf/ko/commands/compress-context.js',
+  'minimal',
+  '--persona'
+], { cwd, stdio: 'inherit' });
+
+proc.on('error', (err) => {
+  console.error('명령 실행 실패:', err.message);
+});
+```
+
+## 설명
+
+페르소나 특성을 고려하면서도 최소한의 압축만 수행합니다. 10-30%의 낮은 압축률로 원본 내용을 최대한 보존합니다.
+
+### 압축 전략
+
+- 페르소나 관련 패턴은 100% 보존
+- 중복 내용만 제거
+- 불필요한 공백과 포맷팅 정리
+- 페르소나별 중요도 점수가 평균 이상인 섹션은 그대로 유지
+
+## 적합한 사용 사례
+
+- 중요한 기술 문서
+- 상세한 API 문서
+- 보안 관련 문서
+- 데이터 분석 리포트
+
+## 결과
+
+압축 후에도 다음이 보장됩니다:
+- 모든 페르소나 관련 키워드 보존
+- 문서 구조 완전 유지
+- 코드 블록과 예제 보존
+- 테이블과 다이어그램 유지

package/.aiwf/.claude/commands/aiwf/aiwf_compress_stats.md

@@ -0,0 +1,79 @@
+# aiwf compress-stats
+
+페르소나별 압축 통계를 확인합니다.
+
+## 실행
+
+```javascript
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+// PersonaAwareCompressor import
+const { PersonaAwareCompressor } = require(path.join(
+  process.cwd(), 
+  'claude-code/aiwf/ko/utils/persona-aware-compressor.js'
+));
+
+try {
+  const compressor = new PersonaAwareCompressor();
+  const stats = compressor.getPersonaCompressionStats();
+  
+  console.log(chalk.cyan('📊 페르소나별 압축 통계'));
+  console.log(chalk.gray('━'.repeat(50)));
+  
+  if (stats.currentPersona) {
+    console.log(`현재 페르소나: ${chalk.yellow(stats.currentPersona)}`);
+    
+    if (stats.strategy) {
+      console.log('\n📋 현재 페르소나 압축 전략:');
+      console.log(`- 포커스 영역: ${stats.strategy.focusAreas.join(', ')}`);
+      console.log(`- 요약 초점: ${stats.strategy.summarizationFocus}`);
+      console.log(`- 보존 패턴: ${stats.strategy.preservePatterns.slice(0, 5).join(', ')}...`);
+    }
+  } else {
+    console.log(chalk.yellow('⚠️  활성화된 페르소나가 없습니다.'));
+  }
+  
+  const avgRatios = stats.averageRatioByPersona;
+  if (Object.keys(avgRatios).length > 0) {
+    console.log('\n📈 페르소나별 평균 압축률:');
+    Object.entries(avgRatios).forEach(([persona, ratio]) => {
+      const personaNames = {
+        architect: 'Architect',
+        security: 'Security Expert',
+        frontend: 'Frontend Developer',
+        backend: 'Backend Developer',
+        data_analyst: 'Data Analyst'
+      };
+      console.log(`- ${personaNames[persona] || persona}: ${chalk.green(ratio + '%')}`);
+    });
+  } else {
+    console.log('\n압축 히스토리가 없습니다.');
+  }
+  
+} catch (error) {
+  console.error(chalk.red('오류:'), error.message);
+}
+```
+
+## 설명
+
+페르소나별 압축 통계와 현재 활성화된 페르소나의 압축 전략을 확인합니다.
+
+### 제공 정보
+
+1. **현재 페르소나 정보**
+   - 활성 페르소나 이름
+   - 압축 전략 상세
+   - 보존 패턴 목록
+
+2. **압축 히스토리 통계**
+   - 페르소나별 평균 압축률
+   - 압축 성능 비교
+
+## 활용 방법
+
+- 페르소나별 압축 효율성 비교
+- 최적의 압축 모드 선택
+- 압축 전략 개선점 파악

package/.aiwf/.claude/commands/aiwf/aiwf_compress_with_persona.md

@@ -0,0 +1,51 @@
+# aiwf compress-with-persona
+
+활성화된 페르소나를 고려하여 컨텍스트를 압축합니다.
+
+## 실행
+
+```javascript
+const { spawn } = require('child_process');
+const path = require('path');
+
+// .aiwf 디렉토리로 이동하여 명령 실행
+const cwd = path.join(process.cwd(), '.aiwf');
+const proc = spawn('node', [
+  '../claude-code/aiwf/ko/commands/compress-context.js',
+  'balanced',
+  '--persona'
+], { cwd, stdio: 'inherit' });
+
+proc.on('error', (err) => {
+  console.error('명령 실행 실패:', err.message);
+});
+```
+
+## 설명
+
+현재 활성화된 페르소나의 특성을 고려하여 컨텍스트를 압축합니다. 페르소나별로 중요한 패턴과 키워드를 보존하며, 관련성이 낮은 내용은 더 적극적으로 압축합니다.
+
+### 페르소나별 압축 전략
+
+- **Architect**: 시스템 설계, 아키텍처 패턴 중심 보존
+- **Security**: 보안 경고, 취약점 정보 완전 보존
+- **Frontend**: UI/UX 설명, 시각적 요소 중심 보존
+- **Backend**: API 명세, 데이터베이스 스키마 보존
+- **Data Analyst**: 데이터 설명, 인사이트 완전 보존
+
+## 사용 예시
+
+```bash
+# 기본 모드 (balanced)로 페르소나 인식 압축
+aiwf compress-with-persona
+
+# 다른 압축 모드와 함께 사용
+aiwf compress-aggressive-persona  # aggressive 모드
+aiwf compress-minimal-persona     # minimal 모드
+```
+
+## 참고
+
+- 페르소나가 활성화되지 않은 경우 일반 압축이 수행됩니다
+- 압축된 파일은 `.aiwf_compressed/` 디렉토리에 저장됩니다
+- 페르소나별 중요 패턴 보존율이 리포트에 포함됩니다

package/.aiwf/.claude/commands/aiwf/aiwf_evaluate.md

@@ -0,0 +1,92 @@
+# aiwf evaluate
+
+AI 응답 품질을 간단하게 평가합니다.
+
+## 실행
+
+```javascript
+const { spawn } = require('child_process');
+const path = require('path');
+
+// .aiwf 디렉토리로 이동하여 명령 실행
+const cwd = path.join(process.cwd(), '.aiwf');
+const args = process.argv.slice(2); // 추가 인자 전달
+
+const proc = spawn('node', [
+  '../claude-code/aiwf/ko/commands/evaluate.js',
+  ...args
+], { cwd, stdio: 'inherit' });
+
+proc.on('error', (err) => {
+  console.error('명령 실행 실패:', err.message);
+});
+```
+
+## 설명
+
+경량화된 평가 시스템으로 AI 응답 품질을 모니터링합니다. 기본적으로 백그라운드에서 자동 실행되며, 필요할 때만 상세 정보를 확인할 수 있습니다.
+
+## 사용 옵션
+
+### 기본 사용 (빠른 평가)
+```bash
+aiwf evaluate
+```
+현재 페르소나의 최근 평가 통계를 간단히 표시합니다.
+
+### 상세 분석
+```bash
+aiwf evaluate --detailed
+# 또는
+aiwf evaluate -d
+```
+모든 페르소나의 상세 통계와 개선 제안을 표시합니다.
+
+### 평가 히스토리
+```bash
+aiwf evaluate --history
+# 또는
+aiwf evaluate -h
+```
+최근 10개의 평가 기록을 시간순으로 표시합니다.
+
+### 주간 통계
+```bash
+aiwf evaluate --stats
+# 또는
+aiwf evaluate -s
+```
+일주일간의 평가 통계와 페르소나별 활용도를 표시합니다.
+
+## 자동 평가 시스템
+
+이 명령어는 수동으로 실행할 수 있지만, 실제로는 다음 상황에서 자동으로 백그라운드 평가가 수행됩니다:
+
+- 페르소나 전환 시
+- 컨텍스트 압축 시
+- AI 응답 생성 후 (향후 구현)
+
+평가 점수가 60% 미만일 때만 자동으로 피드백이 표시되므로, 작업 흐름을 방해하지 않습니다.
+
+## 평가 기준
+
+### 3가지 핵심 지표
+1. **역할 일치도 (50%)**: 페르소나 특성 반영 정도
+2. **작업 관련성 (30%)**: 요청된 작업과의 관련성
+3. **기본 품질 (20%)**: 응답의 구조와 내용
+
+### 점수 해석
+- 80% 이상: 훌륭함 🎉
+- 60-79%: 양호함 ✅
+- 60% 미만: 개선 필요 💡
+
+## 예시 출력
+
+```
+🔍 최근 응답 평가
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+현재 페르소나: architect
+평균 점수: 0.75
+평가 횟수: 23
+추세: 📈 개선 중
+```

package/.aiwf/00_PROJECT_MANIFEST.md

@@ -0,0 +1,183 @@
+# AIWF 프로젝트 매니페스트
+
+**프로젝트명**: AIWF (AI Workflow Framework)  
+**생성일**: 2025-07-02  
+**마지막 업데이트**: 2025-07-10  
+**프로젝트 유형**: Node.js NPM 패키지  
+**현재 버전**: 0.3.0
+**최고 마일스톤**: M02
+**최고 스프린트**: S03
+
+## 프로젝트 개요
+
+AIWF는 Claude Code와의 통합을 위해 설계된 마크다운 기반 프로젝트 관리 프레임워크입니다. AI 지원 개발을 위한 체계적인 워크플로우를 제공하며, 다국어 지원(한국어/영어)을 통해 글로벌 개발자들이 사용할 수 있도록 설계되었습니다.
+
+## 현재 마일스톤
+
+- **활성 마일스톤**: M02_Context_Engineering_Enhancement
+- **마일스톤 상태**: 완료
+- **진행률**: 100%
+- **완료일**: 2025-07-08
+
+## 현재 스프린트
+
+- **활성 스프린트**: S03_M02_ecosystem_integration
+- **스프린트 상태**: complete
+- **시작일**: 2025-07-08
+- **완료일**: 2025-07-08
+
+## 활성 태스크
+
+### 진행 중
+
+- **T14_S03**: 기본 프로젝트 템플릿 구축 (in_progress → 2025-07-10 06:20 시작)
+
+### 계획됨
+
+- 계획된 태스크 없음
+
+### 최근 완료
+
+- **T13_S03**: AI 도구 통합 템플릿 개발 (completed → 2025-07-10 04:37 완료)
+
+- **TX001**: Complete English Translation for 100% i18n Support (completed → 2025-07-09 08:13 완료)
+- **TX05_S02**: S02 통합 테스트 및 문서화 (completed → 2025-07-08 00:09 완료)
+- **TX03_S02**: Context 압축 알고리즘 구현 (completed → 2025-07-09 03:48 완료)
+- **TX11_S01**: 통합 테스트 Suite 구축 (completed → 2025-07-09 03:06 완료)
+- **TX10_S01**: update_docs 명령어 복구 (completed → 2025-07-09 02:49 완료)
+- **TX09_S01**: 압축 알고리즘 프로토타입 (completed → 2025-07-09 02:35 완료)
+- **TX08_S01**: 토큰 추적 시스템 프로토타입 (completed → 2025-07-09 02:12 완료)
+- **TX07_S01**: Context 압축 아키텍처 설계 (completed → 2025-07-09 01:54 완료)
+- **TX05_S01**: AI 페르소나 데이터 구조 설계 (completed → 2025-07-09 01:25 완료)
+- **TX04_S01**: Feature Ledger 문서화 (completed → 2025-07-09 01:02 완료)
+- **TX03_S01**: Git 연동 Feature 추적 (completed → 2025-07-09 00:45 완료)
+- **TX02_S01**: Feature Ledger CLI 명령어 개발 (completed → 2025-07-09 00:18 완료)
+- **TX01_S01**: Feature Ledger 데이터 구조 설계 (completed → 2025-07-09 00:01 완료)
+- **T04_S03**: update_docs 명령어 누락 이슈 해결 (completed → 2025-07-03 06:35 완료)
+- **T03_S03**: 한국어 명령어 전체 시스템 표준화 (completed → 2025-07-03 06:28 완료)
+
+### 완료됨
+
+- 프로젝트 초기화 완료
+- M01 마일스톤 완료 (한국어 명령어 표준화)
+
+## 마일스톤 목록
+
+| ID  | 이름                            | 상태    | 진행률 | 시작일     | 완료일 |
+| --- | ------------------------------- | ------- | ------ | ---------- | ------ |
+| M02 | Context_Engineering_Enhancement | 완료 | 100%   | 2025-07-08 | 2025-07-08 |
+
+### 마일스톤 상세
+- [x] [M02: Context Engineering Enhancement](02_REQUIREMENTS/M02_Context_Engineering_Enhancement/M02_milestone_meta.md) - 상태: 완료
+
+## 스프린트 목록
+
+| ID  | 이름                          | 마일스톤 | 상태      | 진행률 | 시작일     | 완료일 |
+| --- | ----------------------------- | -------- | --------- | ------ | ---------- | ------ |
+| S01 | context_foundation            | M02      | complete  | 100%   | 2025-07-08 | 2025-07-08 |
+| S02 | ai_enhancement                | M02      | complete  | 100%   | 2025-07-08 | 2025-07-08 |
+| S03 | ecosystem_integration         | M02      | complete  | 100%   | 2025-07-08 | 2025-07-08 |
+
+## 일반 태스크
+
+- [x] [TX001: Complete English Translation for 100% i18n Support](04_GENERAL_TASKS/TX001_complete_english_translation.md) - 상태: 완료
+
+## 태스크 통계
+
+- **총 태스크**: 19
+- **완료**: 19
+- **진행 중**: 0
+- **대기 중**: 0
+- **차단됨**: 0
+
+## 프로젝트 메트릭
+
+- **코드 커버리지**: N/A (NPM 패키지)
+- **활성 이슈**: 0
+- **해결된 이슈**: 0
+- **오픈 PR**: 0
+
+## 기술 스택
+
+- **언어**: JavaScript (ES6+)
+- **런타임**: Node.js 14.0.0+
+- **패키지 매니저**: NPM
+- **테스트**: Jest
+- **CLI 도구**: Commander.js, Chalk, Ora, Prompts
+
+## 주요 디렉토리
+
+- `index.js`: 메인 CLI 설치 도구
+- `claude-code/aiwf/ko/`: 한국어 AIWF 프레임워크
+- `claude-code/aiwf/en/`: 영어 AIWF 프레임워크
+- `rules/`: IDE별 개발 규칙
+- `docs/`: 프로젝트 문서
+- `tests/`: 테스트 파일
+
+## 연락처 및 리소스
+
+- **저자**: moonklabs
+- **라이선스**: MIT
+- **저장소**: https://github.com/aiwf/aiwf
+- **NPM**: https://www.npmjs.com/package/aiwf
+- **이슈 트래커**: https://github.com/aiwf/aiwf/issues
+
+## 주요 변경사항 로그
+
+### 2025-07-10
+
+- 스프린트 태스크 상태 업데이트:
+  - S01_M02: 실제로 11/12 태스크 구현 완료 (테스크 파일에는 4/12로 표시됨)
+    - AI 페르소나, Context 압축, 토큰 추적 시스템 모두 구현됨
+    - Feature Ledger CLI 명령어만 미구현
+  - S02_M02: 태스크 파일과 구현의 불일치 확인
+    - 6개 페르소나 구현 (계획 5개와 다른 이름)
+    - Feature-Git 연동 부분 구현
+  - S03_M02: AI 도구 템플릿 및 프로젝트 템플릿 미구현
+    - Claude Code 템플릿만 존재
+    - 오프라인 캐시 시스템은 구현됨
+
+### 2025-07-08
+
+- S02 스프린트 완료: AI 강화 기능 구현
+  - 5개 AI 페르소나 명령어 구현 완료
+  - Context 압축 알고리즘 구현 (토큰 50% 절약 달성)
+  - Feature-Git 연동 시스템 구축
+  - 모든 DoD 항목 충족
+- M01 마일스톤 삭제 (완료됨)
+- M02 Context Engineering Enhancement 마일스톤을 위한 스프린트 재구성:
+  - S01_M02_context_foundation: Feature Ledger, AI 페르소나, Context 압축 기반 구축
+  - S02_M02_ai_enhancement: 5개 AI 페르소나, Context 압축 모드, Git 연동 구현
+  - S03_M02_ecosystem_integration: 5개 AI 도구 템플릿, 통합 및 문서화 완성
+- M02 DoD 요구사항에 맞춘 스프린트 재정의
+- 1주일 단위 실행 가능한 범위로 조정
+
+### 2025-07-02
+
+- AIWF 프로젝트 초기화 완료
+- 아키텍처 문서 생성
+- M01 한국어 명령어 표준화 마일스톤 시작
+- T03_S03 태스크 생성
+
+## 향후 계획
+
+1. **즉시 조치 필요 사항**:
+   - Feature Ledger CLI 명령어 구현 (aiwf_create_feature_ledger, aiwf_update_feature_status 등)
+   - AI 도구 템플릿 4개 추가 (GitHub Copilot, Cursor, Windsurf, Augment)
+   - 프로젝트 템플릿 시스템 구현
+   - `.aiwf/ai-tools/` 및 `.aiwf/07_AI_PERSONAS/` 디렉토리 생성
+
+2. **단기 목표 (1-2주)**:
+   - M02 DoD 항목 완전 충족
+   - 테스크 파일과 구현 상태 동기화
+   - 누락된 기능 구현 완료
+
+3. **중기 목표 (1개월)**:
+   - 다음 마일스톤 계획 수립
+   - 사용자 피드백 반영
+   - 프로덕션 준비
+
+4. **장기 목표 (분기)**:
+   - 새로운 언어 지원 추가
+   - AI 도구 통합 확대
+   - 커뮤니티 생태계 구축

package/.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md

@@ -0,0 +1,121 @@
+# AIWF (AI Workflow Framework) 아키텍처
+
+## 프로젝트 개요
+
+AIWF는 Claude Code와의 통합을 위해 설계된 마크다운 기반 프로젝트 관리 프레임워크입니다. AI 지원 개발을 위한 체계적인 워크플로우를 제공하며, 다국어 지원(한국어/영어)을 통해 글로벌 개발자들이 사용할 수 있도록 설계되었습니다.
+
+## 핵심 목적
+
+- AI가 효과적으로 처리할 수 있는 관리 가능한 단위로 소프트웨어 프로젝트를 분해
+- Claude Code와의 완벽한 통합을 통한 개발 생산성 극대화
+- 체계적인 프로젝트 관리 및 추적 시스템 제공
+- 다국어 환경에서의 일관된 개발 경험 보장
+
+## 핵심 아키텍처 구성요소
+
+### 1. CLI 설치 도구 (index.js)
+- **역할**: GitHub에서 AIWF 프레임워크 구성요소를 다운로드하고 설치하는 메인 진입점
+- **기술 스택**: Node.js ES modules, Commander.js, Chalk, Ora, Prompts
+- **핵심 기능**:
+  - GitHub API 통합으로 최신 프레임워크 컨텐츠 가져오기
+  - 대화형 언어 선택 (한국어/영어)
+  - 자동 백업 및 업데이트 시스템
+  - IDE별 규칙 변환 (Cursor, Windsurf)
+
+### 2. AIWF 프레임워크 (claude-code/aiwf/)
+- **구조**: 언어별 분리된 디렉토리 구조 (`ko/`, `en/`)
+- **구성요소**:
+  - `.claude/commands/`: Claude Code 커스텀 명령어
+  - `.aiwf/`: 프로젝트 관리 구조 및 템플릿
+
+### 3. 규칙 시스템 (rules/)
+- **Global Rules**: 항상 적용되는 개발 가이드라인
+- **Manual Rules**: 필요에 따라 적용하는 규칙들
+- **IDE 통합**: Cursor와 Windsurf IDE를 위한 특화된 규칙 변환
+
+## 기술적 아키텍처 결정사항
+
+### 다국어 지원 전략
+- **언어별 분리**: `ko/`, `en/` 폴더를 통한 완전한 언어별 컨텐츠 분리
+- **설치 시점 선택**: 사용자가 설치 시 언어를 선택하여 해당 언어 버전만 설치
+- **명령어 현지화**: 언어별 Claude Code 명령어 제공
+
+### GitHub 통합 전략
+- **직접 다운로드**: GitHub API를 통한 실시간 컨텐츠 페치
+- **무인증 액세스**: GitHub API 속도 제한 내에서 동작
+- **마스터 브랜치 기준**: 항상 최신 안정 버전 제공
+
+### 파일 관리 전략
+- **원자적 연산**: 백업/복원 기능을 통한 안전한 업데이트
+- **선택적 업데이트**: 
+  - CLAUDE.md 파일: 항상 업데이트
+  - 명령어: 항상 업데이트
+  - 템플릿: 신규 설치 시만 다운로드
+  - 사용자 컨텐츠: 업데이트 중 보존
+
+## 프로젝트 관리 워크플로우
+
+### 명령어 구조
+```
+/project:aiwf:<command>
+```
+
+### 핵심 명령어 카테고리
+1. **설정**: `initialize`, `prime`
+2. **계획**: `plan_milestone`, `create_sprints_from_milestone`
+3. **개발**: `do_task`, `commit`, `test`, `code_review`
+4. **자동화**: `yolo` (자율 실행)
+5. **GitHub 통합**: `issue_create`, `pr_create`
+6. **분석**: `ultrathink_*`, `mermaid`, `project_review`
+
+### 디렉토리 구조 규칙
+```
+.aiwf/
+├── 00_PROJECT_MANIFEST.md     # 중앙 추적 문서
+├── 01_PROJECT_DOCS/           # 프로젝트 문서
+├── 02_REQUIREMENTS/           # 마일스톤 요구사항
+├── 03_SPRINTS/               # 스프린트 실행 추적
+├── 04_GENERAL_TASKS/         # 독립적 태스크
+├── 05_ARCHITECTURE_DECISIONS/ # ADR 문서
+├── 10_STATE_OF_PROJECT/      # 프로젝트 상태 스냅샷
+├── 98_PROMPTS/               # 유용한 AI 프롬프트
+└── 99_TEMPLATES/             # 문서 템플릿
+```
+
+## 중요한 기술적 제약사항
+
+### 설치 안전성
+- 사용자가 생성한 프로젝트 컨텐츠는 절대 덮어쓰지 않음
+- 업데이트 전 항상 백업 생성
+- 스프린트 및 태스크의 기존 작업 보존
+
+### Node.js 요구사항
+- 최소 Node.js 14.0.0
+- ES 모듈 사용 (`"type": "module"`)
+- `https` 및 `fs/promises` 지원 필요
+
+### 네트워크 의존성
+- 설치를 위한 인터넷 연결 필요
+- 라이브 GitHub 저장소에서 모든 컨텐츠 가져오기
+- GitHub API 속도 제한 고려 (미인증)
+
+## 보안 고려사항
+
+- GitHub API를 통한 안전한 컨텐츠 다운로드
+- 사용자 로컬 파일 시스템에 대한 안전한 파일 조작
+- 백업 메커니즘을 통한 데이터 손실 방지
+
+## 확장성 고려사항
+
+### 새로운 언어 추가
+1. `claude-code/aiwf/{lang_code}/` 디렉토리 생성
+2. 기존 언어에서 컨텐츠 복사 및 번역
+3. `index.js`의 `messages` 객체에 언어 옵션 추가
+4. 언어 선택 프롬프트 업데이트
+
+### 새로운 명령어 추가
+1. 언어별 디렉토리에 명령어 파일 생성
+2. 명명 규칙 준수 (한국어 버전은 `_kr` 접미사 가능)
+3. 문서 업데이트
+
+이 아키텍처는 안정성과 사용자 안전을 중시하며, 광범위한 오류 처리와 백업 메커니즘을 통해 여러 언어에서 안정적인 프레임워크 배포를 보장합니다.