aiwf 0.3.1 → 0.3.2

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

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

@@ -0,0 +1,412 @@
+# 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)를 참조하세요.*