aiwf 0.3.0 → 0.3.2

package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_commit.md

@@ -1,160 +1,160 @@
 # 변경사항 분석 및 사용자 확인을 통한 논리적 git 커밋 생성
 
-Follow these instructions from top to bottom.
+다음 지시사항을 위에서 아래로 순서대로 따르세요.
 
-## Create a TODO with EXACTLY these 6 items
+## 정확히 다음 6개 항목으로 TODO 생성
 
-1. Parse arguments and analyze git status
-2. Review changes and group by logical commits
-3. Propose commit structure and messages
-4. Check if user approval is necessary
-5. Execute approved commits
-6. Report commit results
+1. 인수 파싱 및 git 상태 분석
+2. 변경사항 검토 및 논리적 커밋별 그룹화
+3. 커밋 구조 및 메시지 제안
+4. 사용자 승인 필요 여부 확인
+5. 승인된 커밋 실행
+6. 커밋 결과 보고
 
 ---
 
-## 1 · Analyze git status and parse arguments
+## 1 · git 상태 분석 및 인수 파싱
 
-- Run these commands in parallel for maximum efficiency: `git status`, `git diff --staged`, `git diff`
-- List all changed files with their folder structure to understand the scope
+- 최대 효율성을 위해 다음 명령어들을 병렬 실행: `git status`, `git diff --staged`, `git diff`
+- 범위를 이해하기 위해 폴더 구조와 함께 모든 변경된 파일 나열
 
-### CRITICAL: Argument Interpretation Rules
+### 중요: 인수 해석 규칙
 
-**Context Provided** (when <$ARGUMENTS> contains text):
+**컨텍스트 제공됨** (<$ARGUMENTS>에 텍스트가 포함된 경우):
 
-- If YOLO is part of the <$ARGUMENTS> it is meant to skip user Approval (see Step 4 on your Todo)
-- The other text in <$ARGUMENTS> represents a **task ID**, **sprint ID**, or other **contextual identifier** provided by the user
-- This is NOT a file path - it's a semantic context for filtering changes
-- **PRIMARY FOCUS**: Only commit files directly related to this context
-- **SECONDARY CONSIDERATION**: After handling the primary context, ask if user wants to commit other unrelated changes
+- YOLO가 <$ARGUMENTS>의 일부라면 사용자 승인을 건너뛰는 것을 의미 (Todo의 4단계 참조)
+- <$ARGUMENTS>의 다른 텍스트는 사용자가 제공한 **태스크 ID**, **스프린트 ID**, 또는 기타 **컨텍스트 식별자**를 나타냄
+- 이것은 파일 경로가 아니라 변경사항을 필터링하기 위한 의미적 컨텍스트임
+- **주요 초점**: 이 컨텍스트와 직접 관련된 파일만 커밋
+- **부차적 고려사항**: 주요 컨텍스트 처리 후, 사용자가 관련 없는 다른 변경사항을 커밋하고 싶은지 묻기
 
-**Task ID Pattern** (e.g., T01_S02, TX03_S01, T003):
+**태스크 ID 패턴** (예: T01_S02, TX03_S01, T003):
 
-- Sprint Tasks: `T<NN>_S<NN>` format (e.g., T01_S02, T03_S02)
-- Completed Sprint Tasks: `TX<NN>_S<NN>` format (e.g., TX01_S02, TX03_S01)
-- General Tasks: `T<NNN>` format (e.g., T001, T002)
-- Completed General Tasks: `TX<NNN>` format (e.g., TX001, TX002)
-- Search for this task ID in:
-  - `.aiwf/03_SPRINTS/` directory (for sprint tasks)
-  - `.aiwf/04_GENERAL_TASKS/` directory (for general tasks)
-  - Task metadata in files (look for `task_id: T01_S02` in frontmatter)
-  - Git diff content (to see if code comments or commits reference the task)
-- Identify ALL files that were modified as part of this task's implementation
-- This includes: source code, tests, configuration, and the task documentation file itself
+- 스프린트 태스크: `T<NN>_S<NN>` 형식 (예: T01_S02, T03_S02)
+- 완료된 스프린트 태스크: `TX<NN>_S<NN>` 형식 (예: TX01_S02, TX03_S01)
+- 일반 태스크: `T<NNN>` 형식 (예: T001, T002)
+- 완료된 일반 태스크: `TX<NNN>` 형식 (예: TX001, TX002)
+- 다음 위치에서 이 태스크 ID를 검색:
+  - `.aiwf/03_SPRINTS/` 디렉토리 (스프린트 태스크용)
+  - `.aiwf/04_GENERAL_TASKS/` 디렉토리 (일반 태스크용)
+  - 파일의 태스크 메타데이터 (frontmatter에서 `task_id: T01_S02` 찾기)
+  - Git diff 내용 (코드 주석이나 커밋이 태스크를 참조하는지 확인)
+- 이 태스크 구현의 일부로 수정된 모든 파일 식별
+- 여기에는 다음이 포함: 소스 코드, 테스트, 구성, 그리고 태스크 문서 파일 자체
 
-**Sprint ID Pattern** (e.g., S01, S02):
+**스프린트 ID 패턴** (예: S01, S02):
 
-- When only sprint ID is provided, commit all changes related to ANY task within that sprint
-- Search pattern: `T*_S<NN>` in the sprint directory
-- Example: "S02" would include changes for T01_S02, T02_S02, T03_S02, etc.
+- 스프린트 ID만 제공된 경우, 해당 스프린트 내의 모든 태스크와 관련된 변경사항을 커밋
+- 검색 패턴: 스프린트 디렉토리의 `T*_S<NN>`
+- 예시: "S02"는 T01_S02, T02_S02, T03_S02 등의 변경사항을 포함
 
-**No Context Provided** (when <$ARGUMENTS> is empty):
+**컨텍스트 제공되지 않음** (<$ARGUMENTS>가 비어있는 경우):
 
-- Analyze all changes and group them logically
-- Propose separate commits for different logical units of work
+- 모든 변경사항을 분석하고 논리적으로 그룹화
+- 서로 다른 논리적 작업 단위에 대해 별도 커밋 제안
 
-### Implementation Steps
+### 구현 단계
 
-1. First, determine if <$ARGUMENTS> contains any text
-2. If yes, explicitly state: "Context provided: '$ARGUMENTS' - I will focus on changes related to this context"
-3. If it's a task ID pattern, find the task file and understand what was implemented
-4. Filter the changed files to only those related to the identified context
-5. If no files match the context, inform the user: "No changes found related to '$ARGUMENTS'"
-6. If unrelated changes exist, mention them but DO NOT include in initial commit proposal
+1. 먼저 <$ARGUMENTS>에 텍스트가 포함되어 있는지 확인
+2. 포함되어 있다면 명시적으로 기술: "컨텍스트 제공됨: '$ARGUMENTS' - 이 컨텍스트와 관련된 변경사항에 집중하겠습니다"
+3. 태스크 ID 패턴인 경우, 태스크 파일을 찾아서 구현된 내용 이해
+4. 식별된 컨텍스트와 관련된 파일들로만 변경된 파일들을 필터링
+5. 컨텍스트와 일치하는 파일이 없으면 사용자에게 알림: "'$ARGUMENTS'와 관련된 변경사항을 찾을 수 없습니다"
+6. 관련 없는 변경사항이 존재하면 언급하되 초기 커밋 제안에는 포함하지 않음
 
-## 2 · Review changes and group by logical commits
+## 2 · 변경사항 검토 및 논리적 커밋별 그룹화
 
-### PRIORITY: Context Filtering
+### 우선순위: 컨텍스트 필터링
 
-**If context provided in arguments**:
+**인수에 컨텍스트가 제공된 경우**:
 
-1. **FILTER FIRST**: Separate changes into two groups:
-   - **Related to context**: Files that are part of the task/context implementation
-   - **Unrelated to context**: Everything else
-2. **FOCUS**: Only analyze the "related to context" group for the first commit
-3. **DEFER**: Keep the "unrelated" group for potential later commits (only if user requests)
+1. **먼저 필터링**: 변경사항을 두 그룹으로 분리:
+   - **컨텍스트와 관련**: 태스크/컨텍스트 구현의 일부인 파일들
+   - **컨텍스트와 무관**: 그 외 모든 것
+2. **집중**: 첫 번째 커밋에서는 "컨텍스트와 관련" 그룹만 분석
+3. **연기**: 잠재적인 후속 커밋을 위해 "무관" 그룹 보관 (사용자가 요청하는 경우에만)
 
-**Standard grouping logic** (for no-context or within-context grouping):
+**표준 그룹화 로직** (컨텍스트 없음 또는 컨텍스트 내 그룹화용):
 
-- **Think about** which changes belong together logically:
-  - Task completion (group by task ID when applicable)
-  - Feature additions (group by feature scope)
-  - Configuration updates (group separately)
-  - Documentation updates (group by documentation type)
-  - Bug fixes (group by related functionality)
-- **Think carefully** to ensure each commit represents one logical change that can be understood and potentially reverted independently
-- Avoid mixing unrelated changes in the same commit
-- Consider dependencies between changes when ordering commits
+- **논리적으로 함께 속하는 변경사항 고민**:
+  - 태스크 완료 (해당되는 경우 태스크 ID별 그룹화)
+  - 기능 추가 (기능 범위별 그룹화)
+  - 구성 업데이트 (별도 그룹화)
+  - 문서 업데이트 (문서 유형별 그룹화)
+  - 버그 수정 (관련 기능별 그룹화)
+- **신중하게 고려**하여 각 커밋이 독립적으로 이해되고 잠재적으로 되돌릴 수 있는 하나의 논리적 변경을 나타내도록 보장
+- 관련 없는 변경사항을 같은 커밋에 혼합하지 않기
+- 커밋 순서를 정할 때 변경사항 간의 의존성 고려
 
-## 3 · Propose commit
+## 3 · 커밋 제안
 
-### Context-Aware Commit Proposal
+### 컨텍스트 인식 커밋 제안
 
-**When context was provided** (e.g., task ID):
+**컨텍스트가 제공된 경우** (예: 태스크 ID):
 
-- **FIRST COMMIT**: Must contain ONLY files related to the provided context
-- State clearly: "This commit includes changes for $ARGUMENTS"
-- After this commit is done, then ask: "There are also unrelated changes in [list files]. Would you like me to create additional commits for these?"
+- **첫 번째 커밋**: 제공된 컨텍스트와 관련된 파일만 포함해야 함
+- 명확히 기술: "이 커밋은 $ARGUMENTS에 대한 변경사항을 포함합니다"
+- 이 커밋이 완료된 후, 다음과 같이 묻기: "[파일 목록]에 관련 없는 변경사항도 있습니다. 이것들에 대해서도 추가 커밋을 생성하시겠습니까?"
 
-**When no context provided**:
+**컨텍스트가 제공되지 않은 경우**:
 
-- Propose commits based on logical grouping of all changes
+- 모든 변경사항의 논리적 그룹화를 기반으로 커밋 제안
 
-For the next commit to create:
+생성할 다음 커밋에 대해:
 
-- **Context**: If applicable, which task/context this commit addresses
-- **Files**: List the specific files to be included
-- **Commit message**: Use conventional commit format, be clear and concise
-  - **CRITICAL:** Must not contain any attribution to Claude, Anthropic, or AI assistance
-  - If task-related, include task ID in message (e.g., "feat(agents): implement T01_S02 coordinator agent" or "fix(api): resolve T003 authentication issue")
-  - **GitHub Issue Linking**: If task has a GitHub issue, include `fixes #123` or `relates to #456` in commit message
-- **Reasoning**: Brief explanation of why these changes belong together
+- **컨텍스트**: 해당되는 경우, 이 커밋이 다루는 태스크/컨텍스트
+- **파일**: 포함될 특정 파일 목록
+- **커밋 메시지**: 관례적인 커밋 형식 사용, 명확하고 간결하게
+  - **중요:** Claude, Anthropic, 또는 AI 지원에 대한 어떤 언급도 포함하지 않아야 함
+  - 태스크 관련인 경우, 메시지에 태스크 ID 포함 (예: "feat(agents): implement T01_S02 coordinator agent" 또는 "fix(api): resolve T003 authentication issue")
+  - **GitHub 이슈 연결**: 태스크에 GitHub 이슈가 있는 경우, 커밋 메시지에 `fixes #123` 또는 `relates to #456` 포함
+- **근거**: 이러한 변경사항들이 왜 함께 속하는지에 대한 간단한 설명
 
-## 4 · Check if user approval is necessary
+## 4 · 사용자 승인 필요 여부 확인
 
-If YOLO **IS** part of the <$ARGUMENTS> skip this and jump to next step.
+YOLO가 <$ARGUMENTS>의 **일부라면** 이 단계를 건너뛰고 다음 단계로 이동.
 
-Otherwise ask the User for approval.
+그렇지 않으면 사용자 승인을 요청.
 
-- Show the complete commit plan including files and message
-- Wait for explicit user confirmation before proceeding
-- If user says no, ask what should be changed
-- If user wants to modify the commit message or scope, make adjustments
+- 파일과 메시지를 포함한 완전한 커밋 계획 표시
+- 진행하기 전에 명시적인 사용자 확인 대기
+- 사용자가 거부하면 무엇을 변경해야 하는지 묻기
+- 사용자가 커밋 메시지나 범위를 수정하고 싶어하면 조정
 
-## 5 · Execute approved commit and continue
+## 5 · 승인된 커밋 실행 및 계속
 
-For the approved commit:
+승인된 커밋에 대해:
 
-- Stage the specified files with `git add`
-- **IMPORTANT:** We are using pre-commit hooks that will likely report shortcomings. You need to fix them. Don't skip validation unless there are open tasks adressing especially these problems.
-- **Create the commit** with the approved message
-- Verify commit was created successfully
-- **GitHub Issue Update (if applicable):**
-  - If task has a linked GitHub issue
-  - Add commit link comment to issue:
+- `git add`로 지정된 파일들 스테이징
+- **중요:** pre-commit 훅을 사용하고 있어 부족한 점을 보고할 가능성이 높음. 이를 수정해야 함. 특히 이런 문제들을 다루는 열린 태스크가 없다면 검증을 건너뛰지 마세요.
+- 승인된 메시지로 **커밋 생성**
+- 커밋이 성공적으로 생성되었는지 확인
+- **GitHub 이슈 업데이트 (해당하는 경우):**
+  - 태스크에 연결된 GitHub 이슈가 있는 경우
+  - 이슈에 커밋 링크 댓글 추가:
     ```bash
     gh issue comment {issue_number} --body "🔗 Commit: {commit_sha} - {commit_message}"
     ```
-- **IMPORTANT:** If there are more commits remaining, return to step 3 for the next commit
-- Only proceed to step 6 when all commits are completed
+- **중요:** 남은 커밋이 더 있다면 다음 커밋을 위해 3단계로 돌아가기
+- 모든 커밋이 완료된 경우에만 6단계로 진행
 
-## 6 · Report commit results
+## 6 · 커밋 결과 보고
 
-Provide summary:
+요약 제공:
 
-- **Commits Created**: List each commit with SHA and message
-- **Files Committed**: Total count of files committed
-- **Remaining Changes**: Any uncommitted changes still pending
-- **Repository Status**: Current git status after commits
+- **생성된 커밋**: SHA와 메시지와 함께 각 커밋 나열
+- **커밋된 파일**: 커밋된 파일의 총 개수
+- **남은 변경사항**: 아직 커밋되지 않은 대기 중인 변경사항
+- **저장소 상태**: 커밋 후 현재 git 상태
 
-## 7 · Generate Changelog (Optional)
+## 7 · 변경 로그 생성 (선택사항)
 
-After successful commits:
+성공적인 커밋 후:
 
-- Ask user: "커밋이 완료되었습니다. Changelog를 업데이트하시겠습니까? (y/n)"
-- If yes, execute: `/project:aiwf:changelog`
-- This will:
-  - Analyze recent commit history
-  - Generate or update CHANGELOG.md
-  - Categorize changes by type (feat, fix, docs, etc.)
-  - Include the commits just created
+- 사용자에게 묻기: "커밋이 완료되었습니다. Changelog를 업데이트하시겠습니까? (y/n)"
+- yes인 경우 실행: `/project:aiwf:changelog`
+- 이는 다음을 수행:
+  - 최근 커밋 히스토리 분석
+  - CHANGELOG.md 생성 또는 업데이트
+  - 유형별 변경사항 분류 (feat, fix, docs 등)
+  - 방금 생성된 커밋들 포함

package/claude-code/aiwf/ko/.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/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_compress_context.md

@@ -0,0 +1,116 @@
+# Context 압축 - 토큰 절약 실행
+
+토큰 사용량을 줄이기 위해 프로젝트 컨텍스트를 압축합니다. 3단계 압축 모드와 실시간 토큰 모니터링을 제공합니다.
+
+**중요사항:**
+- 기본 모드는 'balanced'로 30-50% 토큰 절약을 목표로 합니다
+- 압축 전후 토큰 사용량과 절약률을 실시간으로 표시합니다
+- 중요한 정보는 모든 모드에서 보존됩니다
+
+## 사용법
+
+```
+/project:aiwf:compress_context [mode] [target]
+```
+
+### 파라미터
+
+- `mode` (선택적): 압축 모드
+  - `aggressive`: 50-70% 토큰 절약 (critical/high 정보만 유지)
+  - `balanced`: 30-50% 토큰 절약 (기본값, medium 이상 정보 유지)
+  - `minimal`: 10-30% 토큰 절약 (모든 정보 유지, 포맷팅만 최적화)
+
+- `target` (선택적): 압축 대상
+  - 파일 경로: 특정 파일 압축
+  - 디렉토리 경로: 디렉토리 내 모든 마크다운 파일 압축
+  - 생략 시: 현재 프로젝트의 주요 문서 압축
+
+## 압축 전략
+
+### Aggressive 모드 (50-70% 압축)
+- Critical/High 중요도 섹션만 유지
+- 코드 예제 대폭 축소
+- 중복 정보 완전 제거
+- Output Log, 히스토리 등 제거
+
+### Balanced 모드 (30-50% 압축)
+- Critical/High/Medium 중요도 섹션 유지
+- 코드 예제 선택적 유지
+- 중복 정보 부분 제거
+- 오래된 로그만 제거
+
+### Minimal 모드 (10-30% 압축)
+- 모든 중요도 유지
+- 공백 및 형식 정리
+- 명백한 중복만 제거
+- 안전한 압축
+
+## 실행 단계
+
+1. **압축 대상 파악**
+   - 대상 파일/디렉토리 확인
+   - 원본 토큰 수 계산
+
+2. **압축 모드 적용**
+   - 선택된 모드에 따라 압축 전략 실행
+   - 중요도 기반 섹션 필터링
+   - 압축 알고리즘 적용
+
+3. **압축 결과 검증**
+   - 압축 후 토큰 수 계산
+   - 절약률 및 품질 점수 표시
+   - Critical 정보 보존 검증
+
+4. **압축 파일 생성**
+   - 압축된 컨텐츠를 새 파일로 저장
+   - 원본 파일은 보존
+   - 압축 메타데이터 기록
+
+## 출력 형식
+
+```
+🗜️ Context 압축 시작
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+압축 모드: balanced
+대상: /workspace/project/.aiwf/
+
+📊 압축 전 통계:
+- 총 파일 수: 15
+- 원본 토큰: 45,320
+- 원본 크기: 125.4 KB
+
+⚙️ 압축 진행 중...
+✓ PROJECT_MANIFEST.md (5,320 → 2,890 토큰, -45.6%)
+✓ ARCHITECTURE.md (8,210 → 4,105 토큰, -50.0%)
+✓ M02_milestone_meta.md (3,450 → 2,070 토큰, -40.0%)
+... [추가 파일들]
+
+📊 압축 후 통계:
+- 압축된 토큰: 27,192
+- 절약된 토큰: 18,128
+- 토큰 절약률: 40.0%
+- 압축 시간: 2.3초
+- 품질 점수: 92/100
+
+✅ 압축 완료!
+압축된 파일 위치: /workspace/project/.aiwf_compressed/
+```
+
+## 품질 보증
+
+- **Critical 정보 보존**: 목표, 요구사항, 승인 기준은 항상 유지
+- **구조 보존**: 문서의 논리적 구조와 계층 유지
+- **가독성 유지**: 압축 후에도 읽기 쉬운 형태 유지
+- **복원 가능**: 압축 메타데이터로 필요시 복원 지원
+
+## 권장 사용 시나리오
+
+1. **대규모 프로젝트 리뷰 시**: aggressive 모드로 핵심만 빠르게 파악
+2. **일반 개발 작업**: balanced 모드로 효율적인 컨텍스트 관리
+3. **디버깅/상세 분석**: minimal 모드로 모든 정보 유지하며 최적화
+
+## 주의사항
+
+- 압축된 파일은 별도 디렉토리에 저장되며 원본은 보존됩니다
+- 압축 시 일부 형식이나 세부 정보가 손실될 수 있습니다
+- Critical로 표시된 정보는 모든 모드에서 보존됩니다

package/claude-code/aiwf/ko/.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/claude-code/aiwf/ko/.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/claude-code/aiwf/ko/.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/` 디렉토리에 저장됩니다
+- 페르소나별 중요 패턴 보존율이 리포트에 포함됩니다