aiwf 0.3.8 → 0.3.12

package/.claude/commands/aiwf/aiwf_yolo.md

@@ -1,300 +0,0 @@
-# YOLO 모드 - 모든 열린 태스크 실행
-
-이 모드는 사용자 상호작용 없이 실행되도록 설계되었습니다.
-사용자에게 질문하거나 확인을 요청하지 **마세요**
-의심스러울 때는 최선의 해결책에 대해 **RESEARCH**하고 **ULTRATHINK**하세요.
-
-**중요** 특정 지점에서 멈추지 않으려고 노력하되, 신중한 고려 후 필요하다면 그렇게 하세요.
-
-우선순위는 작업 완료입니다.
-
-## 모드 선택
-
-<$ARGUMENTS> 확인:
-
-- 스프린트 ID가 제공된 경우 (예: S03): 해당 스프린트에서만 작업
-- `sprint-all`이 제공된 경우: 완료될 때까지 모든 스프린트를 순차적으로 실행
-- `milestone-all`이 제공된 경우: 완료될 때까지 모든 마일스톤(모든 스프린트 포함) 실행
-- `worktree`가 제공된 경우: 워크트리 모드 사용 (브랜치 생성 없이 직접 푸시)
-- 비어있는 경우: 일반 태스크를 먼저 작업한 후 활성 스프린트 태스크 작업
-
-**사용자에게 모드 보고!**
-
-## 안전 가이드라인
-
-- 중요한 파일(.env, alembic 마이그레이션, 프로덕션 설정)을 **절대** 수정하지 마세요
-- 데이터베이스 스키마 변경이 발생하면 **중단**하세요
-- 5개 이상의 파일을 삭제해야 하는 경우 **중단**하세요
-- 변경 후 테스트가 실패하면 **중단**하세요
-- 태스크 구현 후 **항상** 테스트를 실행하세요
-
-## 정확한 프로세스를 따르세요
-
-이 프로세스를 고수하고 **정확히** 따라야 합니다
-
-시작하기 전에:
-
-- test.md 명령(@.claude/commands/aiwf/aiwf_test.md)을 사용하여 깨끗한 기준선을 보장하기 위해 테스트 실행
-- **만약** 실패율이 10%를 초과하면 수정이 가능한지 평가. 가능하다면 수정하고 계속. 그렇지 않다면 어쨌든 계속 진행.
-
-- 깨끗한 작업 디렉토리를 보장하기 위해 git 상태 확인
-- **만약** git 상태가 깨끗하지 않다면 기억하고 마지막에 사용자에게 보고하되, 계속 진행.
-
-또한 <$ARGUMENTS>를 고려 - <> 사이의 것이 추가 지침으로 간주될 수 있다면, 프로세스에서 우선순위를 두세요.
-
-시스템에서 현재 datetime 스탬프를 가져와서 기억하세요
-
-### 열린 작업 찾기
-
-모드에 따라 실행:
-
-**인수에 스프린트 ID가 제공된 경우:**
-
-- .aiwf/03_SPRINTS/{sprint_id}/로 이동
-- 스프린트에 태스크가 있는지 확인 (T\*.md 파일)
-- 태스크가 존재하지 않는 경우:
-  - 스프린트 메타 파일 확인
-  - 메타가 존재하면: ### 스프린트 태스크 생성으로 이동
-  - 메타가 없으면: 오류로 종료 - 스프린트가 존재하지 않음
-- 태스크가 존재하면: 아래 **태스크 선택** 섹션으로 계속
-
-**인수에 `sprint-all`이 있는 경우:**
-
-- .aiwf/03_SPRINTS/ 디렉토리의 모든 스프린트 스캔
-- 모든 스프린트의 순서 목록 생성 (S01, S02, S03, ...)
-- 각 스프린트를 순서대로:
-  - 스프린트에 태스크가 있는지 확인, 없으면 생성
-  - 다음으로 이동하기 전에 현재 스프린트의 모든 태스크 실행
-  - 모든 태스크가 완료되면 스프린트를 완료로 표시
-- 모든 스프린트가 100% 완료될 때까지 계속
-- 우선순위: 다음을 시작하기 전에 현재 스프린트를 완전히 완료
-
-**인수에 `milestone-all`이 있는 경우:**
-
-- .aiwf/01_MILESTONES/ 디렉토리의 모든 마일스톤 스캔
-- 각 마일스톤을 순서대로:
-  - 이 마일스톤과 관련된 모든 스프린트 식별
-  - 현재 마일스톤과 관련된 모든 스프린트 실행
-  - 각 스프린트의 모든 태스크 실행
-  - 관련된 모든 작업이 완료되면 마일스톤을 완료로 표시
-- 모든 마일스톤이 100% 완료될 때까지 계속
-- 우선순위: 다음을 시작하기 전에 현재 마일스톤을 완전히 완료
-
-**인수가 없는 경우 (일반 모드):**
-
-- 병렬 서브에이전트를 사용하여 확인:
-  - 열린 일반 태스크를 위한 .aiwf/04_GENERAL_TASKS
-  - 현재 활성 스프린트를 위한 .aiwf/00_PROJECT_MANIFEST.md
-  - 메타 파일만 있는 스프린트를 위한 .aiwf/03_SPRINTS/
-- 우선순위 순서:
-  1. 일반 태스크 (열린 것이 있다면)
-  2. 활성 스프린트 태스크 (열린 것이 있다면)
-  3. 태스크 생성이 필요한 스프린트 (발견되면) - 스프린트 순서 유지
-
-**태스크 선택:**
-
-- 발견된 태스크에서 완료되지 않은 하나를 선택. 스프린트나 일반 태스크에서 가장 낮은 ID를 선택
-- 이전에 시도한 태스크는 건너뛰기 (OUTPUT LOG 확인)
-- 적합한 태스크를 찾지 못하고 스프린트가 태스크를 필요로 하지 않으면: 우아하게 종료
-
-### 스프린트 태스크 생성
-
-**오직** 스프린트가 태스크 생성을 필요로 하는 경우에만 실행
-
-- **서브에이전트**를 사용하여 스프린트 ID를 인수로 하여 @.claude/commands/aiwf/aiwf_create_sprint_tasks.md를 포함하도록 함
-- 완료를 기다림
-- 태스크 생성 후 `### 열린 작업 찾기`로 다시 이동
-
-### 태스크 작업
-
-- 이전에 이 태스크를 건드린 적이 있다면 무시하고 다음 태스크로 이동
-- 이전에 수정을 시도하지 않은 태스크를 찾을 수 없다면 ### 프로젝트 리뷰 실행으로 이동
-- 작업이 이미 완료되어 수정할 수 없는 태스크를 발견하면, 태스크를 닫고 태스크의 Output Log에 기록.
-- **시작하기 전에**:
-  - **만약** 인수에 `worktree`가 없다면: 태스크를 위한 git 브랜치 생성: `git checkout -b task/<task-id>`
-  - **만약** 인수에 `worktree`가 있다면: 브랜치 생성 건너뛰기 (워크트리 모드)
-- **GitHub 이슈 생성 (선택사항):**
-  - 태스크에 `github_issue` 필드가 없는 경우
-  - 서브에이전트를 사용하여 이슈 생성을 위해 @.claude/commands/aiwf/aiwf_issue_create.md 포함
-- **서브에이전트 사용**하여 태스크를 실행하기 위해 태스크 ID를 인수로 하여 @.claude/commands/aiwf/aiwf_do_task.md를 포함하도록 함.
-- **태스크 완료 후**: test.md 명령(@.claude/commands/aiwf/aiwf_test.md)을 사용하여 아무것도 깨지지 않았는지 확인하기 위해 테스트 실행
-- 태스크 실행에서 실패 시 오류의 심각성 평가:
-  - 치명적 오류 (테스트 중단, 보안 문제, 데이터 손실 위험): **문제 수정**
-  - 비치명적 오류 (린팅, 포맷팅, 사소한 문제): OUTPUT LOG에 기록하고 계속
-- 성공 시 계속 진행
-
-### 작업 커밋
-
-- **오직** 테스트가 통과하고 치명적 문제가 없는 경우에만
-- **서브에이전트 사용**하여 태스크 ID를 인수로 하고 YOLO를 추가 인수로 하여 @.claude/commands/aiwf/aiwf_commit.md를 포함하도록 함
-- 커밋 시 실패하면, 태스크의 OUTPUT LOG에 문제를 기록하고 계속
-- 성공적인 커밋 후,
-  - **만약** 인수에 `worktree`가 없다면: 성공적인 커밋 후, main으로 병합: `git checkout main && git merge task/<task-id>`
-  - **만약** 인수에 `worktree`가 있다면: 성공적인 커밋 후, 변경사항 푸시: `git push`
-- **풀 리퀘스트 생성 (선택사항):**
-  - GitHub 이슈가 태스크에 연결된 경우
-  - 서브에이전트를 사용하여 PR 생성을 위해 @.claude/commands/aiwf/aiwf_pr_create.md 포함
-- **즉시** 다음 태스크를 계속하기 위해 `### 열린 작업 찾기`로 다시 이동
-
-### 연속 실행 루프
-
-**⚡ YOLO 모드: 완료까지 중단 없음**
-
-**이것이 메인 실행 루프입니다 - 조기 종료하지 마세요**
-
-**스프린트별 모드:**
-
-- 지정된 스프린트의 모든 태스크가 완료될 때까지 **루프**
-- 각 커밋 후, **즉시** `### 열린 작업 찾기`로 다시 이동
-- 스프린트가 100% 완료된 경우에만 프로젝트 리뷰로 이동
-- 사용자 입력이나 확인을 **절대** 요청하지 마세요
-
-**Sprint-all 모드:**
-
-- 모든 스프린트가 100% 완료될 때까지 **루프**
-- 각 스프린트에 대해: 다음 스프린트로 이동하기 전에 모든 태스크 완료
-- 각 커밋 후, **즉시** `### 열린 작업 찾기`로 다시 이동
-- 진행 상황 추적: 현재 스프린트 X / 총 Y 스프린트
-- 불완전한 스프린트를 **절대** 건너뛰지 마세요
-- 모든 스프린트가 완전히 완료된 경우에만 종료
-
-**Milestone-all 모드:**
-
-- 모든 마일스톤이 100% 완료될 때까지 **루프**
-- 각 마일스톤에 대해: 관련된 모든 스프린트와 태스크 완료
-- 각 커밋 후, **즉시** `### 열린 작업 찾기`로 다시 이동
-- 진행 상황 추적: 현재 마일스톤 X / 총 Y 마일스톤
-- 불완전한 마일스톤이나 그 종속성을 **절대** 건너뛰지 마세요
-- 모든 마일스톤이 완전히 달성된 경우에만 종료
-
-**일반 모드:**
-
-- 다음을 통해 **연속 루프**:
-  1. 사용 가능한 모든 일반 태스크 완료
-  2. 그 다음 활성 스프린트 태스크로 이동
-  3. 모든 활성 스프린트 태스크 완료
-  4. 새로 생성된 스프린트나 태스크 확인
-  5. 더 이상 사용 가능한 작업이 없을 때까지 반복
-- 각 커밋 후, **즉시** `### 열린 작업 찾기`로 다시 이동
-- 절대적으로 작업이 남아있지 않은 경우에만 종료
-
-**중단 조건 (모든 것이 참인 경우에만 중단):**
-
-- 대상 범위에 보류 중인 태스크 없음
-- 자동 수정할 수 있는 태스크 없음
-- 태스크 생성이 필요한 스프린트 없음
-- 프로젝트 리뷰가 새 태스크를 생성하지 않고 통과
-
-## 프로젝트 리뷰 실행
-
-- **서브에이전트 사용**하여 @.claude/commands/aiwf/aiwf_project_review.md를 포함하도록 함
-- 리뷰 결과에 따라:
-  - 실패 시: 가능한 수정에 대해 생각.
-  - 수정이 빠르게 완료되면, 즉시 수정하고 `## 프로젝트 리뷰 실행` 반복
-  - 수정이 더 복잡하면 **서브에이전트 사용**하여 필요에 따라 새 일반 태스크를 생성하기 위해 @.claude/commands/aiwf/aiwf_create_general_task.md를 포함하도록 함.
-  - 이러한 수정 작업을 위해 `### 열린 작업 찾기`로 다시 이동
-  - 통과 시: 계속 진행
-
-## 계속 확인
-
-**⚡ 필수 계속 로직**
-
-**남은 작업 확인:**
-
-- 현재 범위에서 보류 중인 태스크 스캔
-- 프로젝트 리뷰가 새 태스크를 생성했는지 확인
-- 태스크 생성이 필요한 스프린트가 있는지 확인
-
-**결정 매트릭스:**
-
-**스프린트별 모드:**
-
-- **만약** 스프린트에 보류 중인 태스크가 있다면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 스프린트가 100% 완료되었다면 → `## 요약 생성`으로 이동
-
-**Sprint-all 모드:**
-
-- **만약** 어떤 스프린트에든 보류 중인 태스크가 있다면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 어떤 스프린트든 태스크 생성이 필요하다면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 모든 스프린트가 100% 완료되었다면 → `## 요약 생성`으로 이동
-
-**Milestone-all 모드:**
-
-- **만약** 어떤 마일스톤에든 불완전한 스프린트가 있다면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 어떤 마일스톤 관련 태스크든 보류 중이라면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 모든 마일스톤이 100% 완료되었다면 → `## 요약 생성`으로 이동
-
-**일반 모드:**
-
-- **만약** 어떤 일반 태스크든 보류 중이라면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 어떤 스프린트 태스크든 보류 중이라면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 어떤 스프린트든 태스크 생성이 필요하다면 → `### 열린 작업 찾기`로 다시 이동
-- **만약** 프로젝트 리뷰가 실패하고 새 태스크를 생성했다면 → `### 열린 작업 찾기`로 다시 이동
-- **오직** 절대적으로 작업이 남아있지 않은 경우에만 → `## 요약 생성`으로 이동
-
-**🚨 치명적: 작업이 남아있지 않다고 100% 확신하지 않는 한 요약으로 이동하지 마세요**
-
-## 요약 생성
-
-- 시스템에서 현재 datetime 스탬프를 가져와서 처음에 기억한 타임스탬프와 비교. 프로세스 지속시간 계산.
-
-### 프로젝트 상태 보고서 생성
-
-**프로젝트 상태 데이터 수집:**
-
-- 마일스톤 완료 상태를 위해 `.aiwf/01_MILESTONES/` 스캔
-- 모든 스프린트 상태와 태스크 완료를 위해 `.aiwf/03_SPRINTS/` 스캔
-- 일반 태스크 완료를 위해 `.aiwf/04_GENERAL_TASKS/` 스캔
-- 각 카테고리에 대해 완료된 vs 전체 태스크 계산
-
-**시각적 진행 상황 보고서 생성:**
-
-```
-=== MOONKLABS 프로젝트 상태 보고서 ===
-
-🎯 마일스톤 진행 상황:
-[▓▓▓▓▓▓▓░░░] 70% (10개 중 7개 완료)
-M01: ✅ 설정 및 아키텍처
-M02: ✅ 핵심 기능
-M03: ✅ 인증
-M04: 🔄 진행 중 - API 개발
-M05: ⏳ 대기 중 - 프론트엔드 통합
-
-📊 스프린트 진행 상황:
-[▓▓▓▓▓▓░░░░] 60% (5개 스프린트 중 3개 완료)
-S01: ✅ 완료 (12/12 태스크)
-S02: ✅ 완료 (8/8 태스크)
-S03: 🔄 활성 (9개 태스크 중 5개 완료)
-S04: ⏳ 계획됨 (0/0 태스크)
-S05: ⏳ 계획됨 (0/0 태스크)
-
-⚡ 일반 태스크:
-[▓▓▓▓▓▓▓▓░░] 80% (20개 중 16개 완료)
-
-📈 전체 프로젝트 상태:
-[▓▓▓▓▓▓▓░░░] 73% 완료
-```
-
-**다음을 포함한 요약 보고서 생성:**
-
-- 실행된 모드 (스프린트별, Sprint-all, Milestone-all, 또는 일반)
-- 생성된 스프린트 태스크 (해당되는 경우)
-- 이 세션에서 완료된 태스크 수
-- 이 세션에서 건너뛰거나 실패한 태스크 수
-- YOLO 세션의 총 지속시간
-- 현재 프로젝트 완료 백분율
-- 완료된 스프린트 (sprint-all 모드인 경우)
-- 달성된 마일스톤 (milestone-all 모드인 경우)
-- 발생한 치명적 문제들
-- 현재 테스트 상태
-- 다음 권장 조치
-- 다음 세션을 위한 상위 3개 우선순위 항목
-
-**다음을 포함하여 사용자에게 완전한 상태 보고:**
-
-- 시각적 진행 상황 그래프
-- 세션 요약
-- 프로젝트 상태 개요
-- 권장 다음 단계
-
-작업이 완료되었습니다. 감사합니다.

package/.eslintrc.json

@@ -1,26 +0,0 @@
-{
-  "extends": ["eslint:recommended"],
-  "parserOptions": {
-    "ecmaVersion": 2022,
-    "sourceType": "module"
-  },
-  "env": {
-    "node": true,
-    "es2022": true
-  },
-  "rules": {
-    "no-console": "warn",
-    "no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
-    "prefer-const": "error",
-    "no-var": "error",
-    "eqeqeq": ["error", "always"],
-    "curly": ["error", "all"],
-    "quotes": ["error", "single"],
-    "semi": ["error", "always"],
-    "indent": ["error", 2],
-    "no-trailing-spaces": "error",
-    "comma-dangle": ["error", "never"],
-    "object-curly-spacing": ["error", "always"],
-    "array-bracket-spacing": ["error", "never"]
-  }
-}

package/.prettierrc

@@ -1,10 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "printWidth": 100,
-  "trailingComma": "none",
-  "bracketSpacing": true,
-  "arrowParens": "avoid",
-  "endOfLine": "lf"
-}

package/CLAUDE.md

@@ -1,254 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is **aiwf** (AI Workflow Framework), an NPM package that installs the AIWF project management framework for AI-assisted development. It's an updated version of the Simone framework, specifically designed for Claude Code integration.
-
-## Changelog Guidelines
-
-- **Changelog Best Practices**: Always summarize changes concisely by feature or component
-- Aim for clear, brief descriptions that highlight the key modifications in each update
-- Group changes by type: Added, Changed, Fixed, Removed
-- Provide context for significant changes without unnecessary details
-- Always use English
-
-## Project Structure
-
-The AIWF project is organized as follows:
-
-```
-aiwf/
-├── ai-tools/             # AI tool-specific configurations
-│   ├── claude-code/      # Claude Code specific settings
-│   ├── cursor/           # Cursor AI integration
-│   ├── windsurf/        # Windsurf integration
-│   └── github-copilot/   # GitHub Copilot integration
-├── commands/             # AIWF command implementations
-│   ├── ai-persona.js     # AI persona management
-│   ├── compress-context.js # Context compression
-│   ├── evaluate.js       # Evaluation functionality
-│   ├── feature-ledger.js # Feature tracking
-│   └── token-tracking.js # Token usage monitoring
-├── config/               # Configuration files
-│   ├── commit-patterns.js # Git commit patterns
-│   └── language.json     # Language settings
-├── docs/                 # Project documentation
-├── feature-ledger/       # Feature tracking JSON files
-│   ├── FL-001-authentication.json
-│   └── feature-index.json
-├── hooks/                # Git hooks and installation scripts
-│   ├── install-hooks.sh  # Hook installation script
-│   └── post-commit       # Post-commit hook
-├── lib/                  # Core library modules
-├── personas/             # AI persona definitions and knowledge bases
-├── rules/                # Development rules and guidelines
-│   ├── global/          # Global development rules
-│   └── manual/          # Manual operation guides
-├── scripts/              # Build and utility scripts
-├── templates/            # Project templates
-│   ├── api-server/      # Express.js API server template
-│   ├── npm-library/     # NPM library template
-│   └── web-app/         # React web app template
-├── tests/                # Test suites
-│   ├── integration/      # Integration tests
-│   └── unit/            # Unit tests
-├── utils/                # Utility modules
-├── package.json          # NPM package configuration
-├── CLAUDE.md            # This file - Claude Code guidance
-└── README.md            # Project documentation
-```
-
-## AI Tools Directory
-
-The `ai-tools/` directory contains configurations for various AI coding assistants:
-
-- **claude-code/**: Claude Code specific settings and templates
-- **cursor/**: Cursor AI integration files
-- **windsurf/**: Windsurf configuration
-- **github-copilot/**: GitHub Copilot integration
-- **augment/**: Augment AI tool configuration
-
-Each tool directory includes:
-- `config.json`: Tool-specific configuration
-- `template/`: Template files for that specific AI tool
-- `README.md`: Documentation for the integration
-
-## Commands Directory
-
-The `commands/` directory contains all AIWF command implementations:
-
-- **ai-persona.js**: Manages AI personas and their behaviors
-- **compress-context.js**: Compresses context to optimize token usage
-- **evaluate.js**: Evaluates code quality and AI responses
-- **feature-ledger.js**: Tracks features and their development status
-- **feature-commit-report.js**: Generates reports from git commits
-- **persona-context-apply.js**: Applies persona contexts to AI interactions
-- **scan-git-history.js**: Analyzes git history for insights
-- **sync-feature-commits.js**: Synchronizes feature commits with ledger
-- **token-tracking.js**: Monitors and reports token usage
-
-## Templates Directory
-
-The `templates/` directory provides starter templates for different project types:
-
-- **api-server/**: Express.js API server with TypeScript
-  - Includes Swagger documentation
-  - AIWF middleware integration
-  - Jest testing setup
-  
-- **npm-library/**: NPM package template
-  - TypeScript configuration
-  - Rollup bundling
-  - Complete testing setup
-  
-- **web-app/**: React + Vite web application
-  - TypeScript + Tailwind CSS
-  - AIWF dashboard components
-  - State management setup
-
-## Feature Ledger Directory
-
-The `feature-ledger/` directory contains JSON files for tracking feature development:
-
-- **FL-001-authentication.json**: Authentication feature tracking
-- **feature-index.json**: Index of all features and their status
-
-Feature ledgers help track:
-- Feature status (planned, in-progress, completed)
-- Related git commits
-- Development milestones
-- Integration with git workflow through hooks
-
-## Hooks Directory
-
-The `hooks/` directory contains Git hooks for automated workflow:
-
-- **install-hooks.sh**: Script to install git hooks into the project
-- **post-commit**: Automatically syncs feature ledger with git commits
-
-To install hooks:
-```bash
-./hooks/install-hooks.sh
-```
-
-The post-commit hook automatically:
-- Parses commit messages for feature references
-- Updates feature status in the ledger
-- Maintains feature-commit relationships
-
-## Utils Directory
-
-The `utils/` directory contains utility modules for various AIWF features:
-
-- **Compression utilities**: Various strategies for context compression
-- **Git utilities**: Git operation helpers and integrations
-- **Token management**: Token counting, tracking, and optimization
-- **Text processing**: Summarization and content normalization
-- **Persona utilities**: Context parsing and behavior validation
-
-## Key Files and Configurations
-
-### package.json Configuration
-- **Type**: ES Module (`"type": "module"`)
-- **Version**: 0.3.3
-- **Main binaries**:
-  - `aiwf` - Main CLI command
-  - `aiwf-lang` - Language management CLI
-
-### Available Scripts
-- `npm test` - Run Jest tests with ES module support
-- `npm run lang:status` - Check language settings
-- `npm run lang:set` - Set language preference
-- `npm run lang:reset` - Reset to auto-detection
-- `npm run validate:commands` - Validate command implementations
-
-## AIWF Framework Development Rules
-
-- **CRITICAL**: All development and source code modifications for the AIWF framework occur directly in the root project directories.
-- When developing new features or modifying existing ones, work directly with the files in `commands/`, `utils/`, `lib/`, etc.
-- The `.aiwf/` directory (when created in user projects) is a generated instance for the end user. Framework development happens in the main repository.
-- Always test changes thoroughly before committing, as modifications directly affect the framework.
-
-## Development Guidelines
-
-### ES Module Usage
-This project uses ES modules. Always use:
-- `import` instead of `require`
-- `export` instead of `module.exports`
-- File extensions in imports when needed
-
-### Language Support
-- AIWF supports both English and Korean languages
-- Language is managed through the `aiwf-lang` CLI command
-- Documentation is provided in both languages (e.g., README.md, README.ko.md)
-- Commands and interfaces adapt based on the selected language
-
-### Language Content Rules
-**IMPORTANT**: Language management approach:
-- The framework uses a unified codebase with language-specific resources
-- Language selection is handled at runtime through `config/language.json`
-- Documentation files use language suffixes:
-  - English: `GUIDE.md`
-  - Korean: `GUIDE.ko.md`
-- Code comments and inline documentation should be in English for maintainability
-- User-facing messages and prompts are loaded from language-specific resources
-- Technical terms, function names, and variable names remain in English
-
-### Testing
-- Write tests for all new features
-- Maintain integration tests in `tests/integration/`
-- Unit tests go in `tests/unit/`
-- Use Jest with ES module configuration
-
-### Git Workflow
-- Follow the commit patterns defined in `config/commit-patterns.js`
-- Use meaningful commit messages
-- Group related changes together
-
-## Language-Specific Features
-
-### Switching Languages
-Users can switch languages using:
-```bash
-aiwf-lang set ko  # Switch to Korean
-aiwf-lang set en  # Switch to English
-```
-
-### Language Detection
-The system automatically detects system language on first install, with fallback to English.
-
-### Localization
-- Commands can have language-specific suffixes (e.g., `_kr`)
-- Documentation is available in both languages
-- Template content is fully localized
-
-## Core Architecture
-
-AIWF is built on a modular architecture designed for extensibility and AI tool integration:
-
-### Command System
-- Commands are self-contained modules in the `commands/` directory
-- Each command exports a default function that handles the command logic
-- Commands can utilize utilities from `utils/` and libraries from `lib/`
-
-### AI Persona System
-- Personas are defined in JSON format in the `personas/` directory
-- Each persona has associated knowledge bases and best practices
-- The system supports dynamic persona switching and context application
-
-### Token Management
-- Built-in token tracking and optimization
-- Multiple compression strategies for context management
-- Real-time monitoring and reporting capabilities
-
-### Template System
-- Project templates are stored in the `templates/` directory
-- Each template is a complete, working project setup
-- Templates include AIWF integration out of the box
-
-### Multi-Language Support
-- Runtime language switching via `aiwf-lang` command
-- Localized documentation and user interfaces
-- Unified codebase with language-specific resources