aiwf 0.3.2 → 0.3.3

package/index.js

@@ -82,9 +82,9 @@ async function getDirectoryStructure(path = '') {
 const COMMANDS_DIR = '.claude/commands/aiwf';
 
 async function checkExistingInstallation() {
-    const aiwfExists = await fs.access('.aiwf').then(() => true).catch(() => false);
-    const claudeCommandsExists = await fs.access(COMMANDS_DIR).then(() => true).catch(() => false);
-    return aiwfExists || claudeCommandsExists;
+    const flagFile = path.join('.aiwf', 'installed.flag');
+    const flagExists = await fs.access(flagFile).then(() => true).catch(() => false);
+    return flagExists;
 }
 
 // 백업 폴더명 생성 함수
@@ -1781,6 +1781,10 @@ async function installAIWF(options = {}) {
         console.error(chalk.red(error.message));
         process.exit(1);
     }
+
+    // 설치 완료 플래그 파일 생성
+    const flagFile = path.join('.aiwf', 'installed.flag');
+    await fs.writeFile(flagFile, 'installed', 'utf8');
 }
 
 async function restoreFromBackup(spinner, msg) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aiwf",
-    "version": "0.3.2",
+    "version": "0.3.3",
     "description": "AI Workflow Framework for Claude Code with multi-language support (Korean/English)",
     "main": "index.js",
     "type": "module",

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

@@ -1,53 +0,0 @@
-# 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

@@ -1,48 +0,0 @@
-# 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

@@ -1,79 +0,0 @@
-# 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

@@ -1,51 +0,0 @@
-# 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

@@ -1,92 +0,0 @@
-# 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/claude-code/aiwf/ko/bin/aiwf-create.js

@@ -1,56 +0,0 @@
-#!/usr/bin/env node
-
-import { createProject } from '../scripts/create-project.js';
-import { createProjectOffline, isOnline } from '../scripts/create-offline.js';
-import chalk from 'chalk';
-
-export async function main(args = process.argv.slice(2)) {
-  
-  // 오프라인 모드 체크
-  if (args.includes('--offline')) {
-    console.log(chalk.yellow('⚠️  오프라인 모드로 실행합니다.'));
-    // 오프라인 생성 로직
-    const template = args[0];
-    const projectName = args[1];
-    
-    if (!template || !projectName) {
-      console.log(chalk.red('사용법: aiwf create --offline <template> <project-name>'));
-      process.exit(1);
-    }
-    
-    try {
-      await createProjectOffline(template, projectName, projectName);
-    } catch (error) {
-      console.error(chalk.red('오류:', error.message));
-      process.exit(1);
-    }
-    
-    return;
-  }
-
-  // 네트워크 연결 확인
-  const online = await isOnline();
-  
-  if (!online) {
-    console.log(chalk.yellow('\n⚠️  인터넷 연결을 확인할 수 없습니다.'));
-    console.log(chalk.yellow('오프라인 모드로 전환합니다.\n'));
-    console.log(chalk.gray('온라인 모드를 강제하려면 --online 플래그를 사용하세요.'));
-    
-    // 오프라인 모드로 자동 전환
-    if (!args.includes('--online')) {
-      // 오프라인 프로젝트 생성 로직
-      return;
-    }
-  }
-
-  // 온라인 모드 (대화형)
-  createProject();
-}
-
-// CLI로 직접 실행된 경우에만 main 함수 호출
-if (import.meta.url === `file://${process.argv[1]}`) {
-  main().catch(error => {
-    console.error(chalk.red('오류:', error.message));
-    process.exit(1);
-  });
-}

package/claude-code/aiwf/ko/bin/aiwf.js

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-
-// AIWF (AI Workflow Framework) Binary
-// This is a wrapper that forwards to the main index.js file
-
-import { execSync } from 'child_process';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const mainScript = path.join(__dirname, '../../index.js');
-
-// Forward all arguments to the main script
-const args = process.argv.slice(2);
-const command = `node "${mainScript}" ${args.join(' ')}`;
-
-try {
-    execSync(command, { stdio: 'inherit', cwd: process.cwd() });
-} catch (error) {
-    process.exit(error.status || 1);
-}

package/claude-code/aiwf/ko/docs/00_PROJECT_MANIFEST.md

@@ -1,183 +0,0 @@
-# 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 도구 통합 확대
-   - 커뮤니티 생태계 구축