aiwf 0.3.2 → 0.3.3

package/claude-code/aiwf/ko/docs/ARCHITECTURE.md

@@ -1,121 +0,0 @@
-# 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. 문서 업데이트
-
-이 아키텍처는 안정성과 사용자 안전을 중시하며, 광범위한 오류 처리와 백업 메커니즘을 통해 여러 언어에서 안정적인 프레임워크 배포를 보장합니다.

package/claude-code/aiwf/ko/docs/FEATURE_LEDGER_ADVANCED_USE_CASES.md

@@ -1,412 +0,0 @@
-# Feature Ledger Advanced Use Cases
-
-## 1. Multi-Sprint Feature Management
-
-### Scenario
-대규모 기능이 여러 스프린트에 걸쳐 개발되는 경우
-
-### Implementation
-
-```yaml
-# FL004_Enterprise_Dashboard.md
-sprint_ids: [S01_M02, S02_M02, S03_M02]
-milestone: M02
-
-# Sprint-specific tasks
-sprint_breakdown:
-  S01_M02:
-    - "Foundation: Database schema, API design"
-    - "Progress: 0% → 30%"
-  S02_M02:
-    - "Core Implementation: Backend APIs, basic UI"
-    - "Progress: 30% → 70%"
-  S03_M02:
-    - "Polish: Advanced features, optimization"
-    - "Progress: 70% → 100%"
-```
-
-### Sprint Tracking
-
-```bash
-# Sprint 시작 시
-/project:aiwf:update_feature_progress FL004 30 --comment "S01 완료: DB 스키마 및 API 설계 완성"
-
-# Sprint 중간 점검
-/project:aiwf:feature_report sprint_progress --feature FL004
-```
-
-### Best Practices
-- 각 스프린트별 명확한 deliverable 정의
-- 스프린트 경계에서 통합 테스트
-- 진행률은 전체 Feature 기준으로 관리
-
-## 2. Cross-Team Feature Collaboration
-
-### Scenario
-프론트엔드, 백엔드, DevOps 팀이 함께 작업하는 경우
-
-### Setup
-
-```yaml
-# Team assignment
-assignee: tech_lead
-contributors: [frontend_dev, backend_dev, devops_eng]
-reviewers: [architect, qa_lead]
-
-# Team-specific branches
-team_branches:
-  frontend: feature/FL005-frontend
-  backend: feature/FL005-backend
-  devops: feature/FL005-infra
-```
-
-### Workflow
-
-```bash
-# 팀별 브랜치 생성
-/project:aiwf:feature_branch FL005 create --team frontend
-/project:aiwf:feature_branch FL005 create --team backend
-
-# 팀별 진행 상황 추적
-/project:aiwf:update_feature_progress FL005 20 --team frontend --comment "UI 컴포넌트 50% 완성"
-/project:aiwf:update_feature_progress FL005 15 --team backend --comment "API 엔드포인트 3/5 완성"
-
-# 통합 상태 확인
-/project:aiwf:feature_dashboard --feature FL005 --view team_breakdown
-```
-
-### Integration Points
-
-```markdown
-## Team Sync Points
-- [ ] API Contract Agreement (Day 2)
-- [ ] Frontend-Backend Integration Test (Day 5)
-- [ ] DevOps Deployment Pipeline (Day 7)
-- [ ] End-to-End Testing (Day 9)
-- [ ] Production Deployment (Day 10)
-```
-
-## 3. Feature Flag Integration
-
-### Scenario
-점진적 롤아웃을 위한 Feature Flag 관리
-
-### Configuration
-
-```yaml
-# Feature metadata
-feature_flags:
-  name: "enterprise_dashboard_enabled"
-  default_state: false
-  rollout_plan:
-    - stage: "internal"
-      percentage: 5
-      date: "2025-07-10"
-    - stage: "beta"
-      percentage: 25
-      date: "2025-07-15"
-    - stage: "ga"
-      percentage: 100
-      date: "2025-07-20"
-```
-
-### Implementation
-
-```javascript
-// Code example
-if (featureFlags.isEnabled('enterprise_dashboard_enabled')) {
-  return <EnterpriseDashboard />;
-} else {
-  return <LegacyDashboard />;
-}
-```
-
-### Monitoring
-
-```bash
-# Feature flag 상태 업데이트
-/project:aiwf:update_feature_flag FL004 --stage beta --percentage 25
-
-# 롤아웃 메트릭 확인
-/project:aiwf:feature_report rollout_metrics --feature FL004
-```
-
-## 4. Dependency Management
-
-### Scenario
-복잡한 Feature 간 의존성 관리
-
-### Dependency Graph
-
-```mermaid
-graph TD
-    FL001[User Auth] --> FL004[Enterprise Dashboard]
-    FL002[Permission System] --> FL004
-    FL003[Data Analytics] --> FL004
-    FL004 --> FL005[Mobile App]
-    FL004 --> FL006[API Gateway]
-```
-
-### Configuration
-
-```yaml
-# FL004 dependencies
-depends_on: [FL001, FL002, FL003]
-blocks: [FL005, FL006]
-
-# Dependency status tracking
-dependency_status:
-  FL001: completed
-  FL002: completed
-  FL003: in_progress  # 80% complete
-```
-
-### Automation
-
-```bash
-# 의존성 체크
-/project:aiwf:check_dependencies FL004
-
-# Output:
-✅ FL001: User Auth - Completed
-✅ FL002: Permission System - Completed
-⚠️ FL003: Data Analytics - In Progress (80%)
-❌ Cannot start FL004 until all dependencies are completed
-
-# 의존성 대시보드
-/project:aiwf:feature_report dependencies --format mermaid
-```
-
-## 5. Performance Tracking
-
-### Scenario
-Feature의 성능 영향 추적
-
-### Metrics Definition
-
-```yaml
-performance_metrics:
-  - metric: "API Response Time"
-    baseline: 200ms
-    target: 150ms
-    current: 180ms
-  - metric: "Page Load Time"
-    baseline: 2.5s
-    target: 2.0s
-    current: 2.2s
-  - metric: "Database Query Count"
-    baseline: 15
-    target: 10
-    current: 12
-```
-
-### Tracking
-
-```bash
-# 성능 메트릭 업데이트
-/project:aiwf:update_metrics FL004 --metric "API Response Time" --value 180ms
-
-# 성능 리포트
-/project:aiwf:feature_report performance --feature FL004
-```
-
-### Automated Checks
-
-```yaml
-# CI/CD integration
-performance_gates:
-  - name: "API Response Time"
-    threshold: 200ms
-    action: "warn"
-  - name: "Page Load Time"
-    threshold: 3.0s
-    action: "block"
-```
-
-## 6. Migration Features
-
-### Scenario
-레거시 시스템 마이그레이션 Feature
-
-### Phased Approach
-
-```yaml
-migration_phases:
-  phase1:
-    name: "Data Migration"
-    status: completed
-    duration: "5 days"
-    rollback_tested: true
-  phase2:
-    name: "API Migration"
-    status: in_progress
-    duration: "7 days"
-    rollback_tested: false
-  phase3:
-    name: "UI Migration"
-    status: planned
-    duration: "10 days"
-    rollback_tested: false
-```
-
-### Rollback Planning
-
-```markdown
-## Rollback Procedures
-
-### Phase 1 Rollback (Data)
-1. Stop write operations
-2. Run rollback script: `scripts/rollback_data_migration.sh`
-3. Verify data integrity
-4. Resume operations
-
-### Phase 2 Rollback (API)
-1. Switch load balancer to legacy endpoints
-2. Clear cache
-3. Monitor error rates
-```
-
-## 7. A/B Testing Features
-
-### Scenario
-새 기능의 효과를 A/B 테스트로 검증
-
-### Configuration
-
-```yaml
-ab_test_config:
-  test_name: "new_checkout_flow"
-  variants:
-    control:
-      name: "Legacy Checkout"
-      percentage: 50
-      feature_flag: false
-    treatment:
-      name: "New Checkout"
-      percentage: 50
-      feature_flag: true
-  metrics:
-    - conversion_rate
-    - average_order_value
-    - checkout_time
-  duration: "14 days"
-```
-
-### Results Tracking
-
-```bash
-# A/B 테스트 결과 업데이트
-/project:aiwf:update_ab_test FL007 --metric conversion_rate --control 2.3 --treatment 3.1
-
-# 통계적 유의성 확인
-/project:aiwf:feature_report ab_test_results --feature FL007
-```
-
-## 8. Security Features
-
-### Scenario
-보안 관련 Feature의 특별 관리
-
-### Security Checklist
-
-```yaml
-security_requirements:
-  - requirement: "Security Design Review"
-    status: completed
-    reviewer: "security_team"
-    date: "2025-07-08"
-  - requirement: "Penetration Testing"
-    status: scheduled
-    date: "2025-07-15"
-  - requirement: "OWASP Top 10 Compliance"
-    status: in_progress
-    checklist:
-      - injection: passed
-      - broken_auth: passed
-      - sensitive_data: in_review
-```
-
-### Compliance Tracking
-
-```bash
-# 보안 체크리스트 업데이트
-/project:aiwf:update_security_checklist FL008 --item "penetration_testing" --status completed
-
-# 보안 컴플라이언스 리포트
-/project:aiwf:feature_report security_compliance --feature FL008
-```
-
-## 9. Documentation-Heavy Features
-
-### Scenario
-API나 SDK처럼 문서가 중요한 Feature
-
-### Documentation Tracking
-
-```yaml
-documentation_requirements:
-  - type: "API Reference"
-    status: in_progress
-    completeness: 70%
-    location: "docs/api/v2"
-  - type: "Integration Guide"
-    status: completed
-    completeness: 100%
-    location: "docs/guides/integration"
-  - type: "Code Examples"
-    status: planned
-    completeness: 0%
-    languages: [javascript, python, java]
-```
-
-### Auto-generation
-
-```bash
-# API 문서 자동 생성
-/project:aiwf:generate_docs FL009 --type api_reference
-
-# 문서 완성도 확인
-/project:aiwf:feature_report documentation --feature FL009
-```
-
-## 10. Feature Deprecation
-
-### Scenario
-기존 Feature를 단계적으로 폐기
-
-### Deprecation Plan
-
-```yaml
-deprecation_plan:
-  announcement_date: "2025-07-01"
-  deprecation_date: "2025-08-01"
-  removal_date: "2025-09-01"
-  migration_guide: "docs/migration/legacy_to_new.md"
-  affected_users: 1250
-  migration_status:
-    notified: 1250
-    migrated: 890
-    pending: 360
-```
-
-### Communication
-
-```bash
-# 폐기 공지 발송
-/project:aiwf:send_deprecation_notice FL003 --channel email,in_app
-
-# 마이그레이션 상태 추적
-/project:aiwf:feature_report deprecation_status --feature FL003
-```
-
-## Best Practices Summary
-
-1. **복잡도 관리**: Feature가 복잡해질수록 더 세분화된 추적 필요
-2. **자동화 우선**: 반복 작업은 스크립트나 CI/CD로 자동화
-3. **투명성 유지**: 모든 이해관계자가 상태를 쉽게 파악할 수 있도록
-4. **데이터 기반 결정**: 메트릭과 로그를 기반으로 의사결정
-5. **롤백 준비**: 항상 되돌릴 수 있는 계획 수립
-
----
-
-*이 문서는 Feature Ledger의 고급 활용 사례를 다룹니다. 기본 사용법은 [User Guide](./FEATURE_LEDGER_USER_GUIDE.md)를 참조하세요.*