aiwf 0.3.1 → 0.3.3

package/claude-code/aiwf/ko/.aiwf/06_FEATURE_LEDGERS/FEATURE_ID_GENERATOR.md

@@ -0,0 +1,138 @@
+# Feature ID 생성 규칙
+
+## 개요
+
+Feature ID는 AIWF 프레임워크에서 각 Feature를 고유하게 식별하는 데 사용되는 식별자입니다.
+
+## ID 형식
+
+```
+FL### (예: FL001, FL002, FL010, FL999)
+```
+
+- **접두사**: `FL` (Feature Ledger)
+- **번호**: 3자리 숫자 (001-999)
+- **총 길이**: 5자리
+
+## 생성 규칙
+
+### 1. 자동 증분 방식
+- Feature ID는 자동으로 증분됩니다
+- 마지막 생성된 ID를 기준으로 다음 번호를 할당
+
+### 2. 번호 할당 로직
+```
+다음 ID = max(기존_모든_Feature_ID) + 1
+```
+
+### 3. 번호 범위
+- **시작**: FL001
+- **최대**: FL999 (총 999개 Feature 지원)
+- **예약**: FL000 (시스템 예약)
+
+### 4. ID 검색 순서
+1. `active/` 디렉토리 검색
+2. `completed/` 디렉토리 검색  
+3. `archived/` 디렉토리 검색
+4. 최대값 확인 후 +1
+
+## 구현 예시
+
+### JavaScript 구현
+```javascript
+function generateNextFeatureId() {
+  const directories = ['active', 'completed', 'archived'];
+  let maxId = 0;
+  
+  directories.forEach(dir => {
+    const files = fs.readdirSync(`06_FEATURE_LEDGERS/${dir}`);
+    files.forEach(file => {
+      const match = file.match(/^FL(\d{3})_/);
+      if (match) {
+        const idNumber = parseInt(match[1], 10);
+        maxId = Math.max(maxId, idNumber);
+      }
+    });
+  });
+  
+  const nextId = maxId + 1;
+  return `FL${nextId.toString().padStart(3, '0')}`;
+}
+```
+
+### CLI 명령어 구현
+```bash
+# 다음 Feature ID 조회
+/aiwf_next_feature_id
+
+# Feature 생성 시 자동 ID 할당
+/aiwf_create_feature_ledger "제목" "설명"
+```
+
+## 파일명 생성 규칙
+
+### 1. 기본 구조
+```
+{feature_id}_{sanitized_title}.md
+```
+
+### 2. 제목 정제 규칙
+- 공백 → 언더스코어 (`_`)
+- 특수문자 제거 (알파벳, 숫자, 언더스코어, 하이픈만 허용)
+- 최대 길이: 50자
+- 소문자 변환
+
+### 3. 예시
+```
+입력: "사용자 인증 시스템 개발"
+출력: "FL001_사용자_인증_시스템_개발.md"
+
+입력: "API 응답 속도 최적화 (Redis 캐시 적용)"
+출력: "FL002_api_응답_속도_최적화_redis_캐시_적용.md"
+```
+
+## 중복 방지 메커니즘
+
+### 1. ID 중복 검사
+- 새 ID 생성 전 기존 ID 전체 검색
+- 동시성 제어를 위한 락 메커니즘 필요
+
+### 2. 파일명 충돌 처리
+```
+기본: FL001_사용자_인증.md
+충돌 시: FL001_사용자_인증_2.md
+```
+
+### 3. 삭제된 ID 재사용 금지
+- 한 번 사용된 ID는 영구적으로 예약
+- 아카이브된 Feature의 ID도 재사용하지 않음
+
+## 검증 규칙
+
+### 1. ID 형식 검증
+```regex
+^FL[0-9]{3}$
+```
+
+### 2. 범위 검증
+- 001-999 범위 내에서만 생성
+- FL000은 시스템 예약으로 사용 불가
+
+### 3. 고유성 검증
+- 모든 디렉토리에서 ID 고유성 보장
+- 대소문자 구분하여 검증
+
+## 마이그레이션 전략
+
+### 1. 기존 Feature 마이그레이션
+- 기존 Feature들에 순차적으로 ID 할당
+- 생성 날짜 순으로 정렬 후 ID 부여
+
+### 2. 백업 및 복구
+- ID 생성 전 현재 상태 백업
+- 롤백 가능한 마이그레이션 수행
+
+---
+
+*생성일: 2025-07-08*
+*최종 업데이트: 2025-07-08 20:55*

package/claude-code/aiwf/ko/.aiwf/06_FEATURE_LEDGERS/FEATURE_INDEX.md

@@ -0,0 +1,186 @@
+# Feature Ledger 인덱스
+
+## 개요
+
+이 문서는 AIWF 프로젝트의 모든 Feature를 중앙에서 관리하는 인덱스입니다. Feature의 현재 상태, 진행률, 의존성을 한눈에 파악할 수 있습니다.
+
+**최종 업데이트**: 2025-07-08 20:56  
+**총 Feature 수**: 3개  
+**활성 Feature**: 2개  
+**완료 Feature**: 1개  
+
+## Feature 통계
+
+### 상태별 분포
+| 상태 | 개수 | 비율 |
+|------|------|------|
+| draft | 1 | 33% |
+| active | 1 | 33% |
+| completed | 1 | 33% |
+| on-hold | 0 | 0% |
+| archived | 0 | 0% |
+
+### 우선순위별 분포
+| 우선순위 | 개수 | 비율 |
+|----------|------|------|
+| high | 2 | 67% |
+| medium | 1 | 33% |
+| low | 0 | 0% |
+| critical | 0 | 0% |
+
+### 마일스톤별 분포
+| 마일스톤 | 개수 | 상태 |
+|----------|------|------|
+| M01 | 1 | 완료 |
+| M02 | 2 | 진행 중 |
+
+## Feature 목록
+
+### 🟢 Active Features
+
+#### [FL001] 사용자 인증 시스템 `active` `high`
+- **담당자**: moonklabs
+- **마일스톤**: M02
+- **진행률**: 33% (8/24h)
+- **태그**: authentication, security, core, backend
+- **브랜치**: feature/FL001-user-auth-system
+- **설명**: JWT 기반 사용자 인증 시스템 구현으로 보안 강화 및 세션 관리 개선
+- **파일**: [FL001_사용자_인증_시스템.md](active/FL001_사용자_인증_시스템.md)
+
+#### [FL002] AI 페르소나 시스템 `draft` `high`
+- **담당자**: team-ai
+- **마일스톤**: M02
+- **진행률**: 0% (0/32h)
+- **태그**: ai, persona, context, enhancement, core
+- **의존성**: FL001
+- **설명**: 5개의 전문 AI 페르소나를 통한 컨텍스트 특화 개발 지원 시스템
+- **파일**: [FL002_ai_페르소나_시스템.md](active/FL002_ai_페르소나_시스템.md)
+
+### ✅ Completed Features
+
+#### [FL003] 다국어 명령어 표준화 `completed` `medium`
+- **담당자**: moonklabs
+- **마일스톤**: M01
+- **완료일**: 2025-07-08
+- **작업시간**: 18/16h (+2h)
+- **태그**: i18n, localization, command, standardization, completed
+- **브랜치**: feature/FL003-multilang-commands, hotfix/FL003-korean-encoding
+- **설명**: 한국어/영어 명령어 시스템 통합 및 표준화로 글로벌 사용자 지원
+- **파일**: [FL003_다국어_명령어_표준화.md](completed/FL003_다국어_명령어_표준화.md)
+
+## 의존성 그래프
+
+```mermaid
+graph TD
+    FL001[FL001: 사용자 인증 시스템] --> FL002[FL002: AI 페르소나 시스템]
+    FL003[FL003: 다국어 명령어 표준화]
+    
+    style FL001 fill:#ffeb3b
+    style FL002 fill:#e3f2fd
+    style FL003 fill:#c8e6c9
+```
+
+**범례**:
+- 🟡 Active (진행 중)
+- 🔵 Draft (기획 완료)
+- 🟢 Completed (완료)
+
+## 마일스톤별 현황
+
+### M01 - 한국어 명령어 표준화 ✅
+- **상태**: 완료
+- **Feature 수**: 1개
+- **완료율**: 100%
+- **주요 성과**: 글로벌 사용자 기반 확대
+
+### M02 - Context Engineering Enhancement 🔄
+- **상태**: 진행 중
+- **Feature 수**: 2개
+- **완료율**: 0%
+- **예상 완료**: 2025-07-15
+- **핵심 Feature**: FL001 (사용자 인증), FL002 (AI 페르소나)
+
+## 최근 활동
+
+### 2025-07-08
+- ✅ **FL003** 다국어 명령어 표준화 완료
+- 🔄 **FL001** 사용자 인증 시스템 활성화 (33% 진행)
+- 📋 **FL002** AI 페르소나 시스템 기획 완료
+
+### 향후 계획
+- **2025-07-09**: FL001 Phase 1 완료 예정
+- **2025-07-10**: FL002 개발 시작 예정
+- **2025-07-15**: M02 마일스톤 완료 목표
+
+## Feature 관리 명령어
+
+### 조회 명령어
+```bash
+# 전체 Feature 목록
+/aiwf_list_features
+
+# 상태별 조회
+/aiwf_list_features --status active
+/aiwf_list_features --status completed
+
+# 마일스톤별 조회
+/aiwf_list_features --milestone M02
+
+# 특정 Feature 상세 조회
+/aiwf_feature_details FL001
+```
+
+### 관리 명령어
+```bash
+# 새 Feature 생성
+/aiwf_create_feature_ledger "제목" "설명"
+
+# 상태 업데이트
+/aiwf_update_feature_status FL001 completed
+
+# 의존성 추가
+/aiwf_add_dependency FL002 FL001
+
+# 인덱스 업데이트
+/aiwf_update_feature_index
+```
+
+## 품질 메트릭
+
+### 계획 정확도
+- **시간 예측 정확도**: 89% (FL003: 예상 16h vs 실제 18h)
+- **완료율 예측**: 진행 중 (FL001, FL002)
+- **의존성 관리**: 100% (순환 참조 없음)
+
+### 생산성 지표
+- **평균 Feature 크기**: 24시간
+- **완료 소요 시간**: 평균 6일 (FL003 기준)
+- **재작업률**: 11% (FL003: +2시간)
+
+## 위험 요소 및 대응
+
+### 현재 위험 요소
+1. **FL002 의존성**: FL001 완료 지연 시 FL002 시작 지연 가능
+2. **M02 일정**: 2개 Feature의 병렬 진행 필요
+3. **리소스 할당**: team-ai의 FL002 전담 필요
+
+### 대응 방안
+- FL001 Phase 1 우선 완료로 FL002 시작 가능
+- 일주일 스프린트 단위로 진행 모니터링
+- 필요시 Feature 범위 조정
+
+## 관련 문서
+
+- [Feature Ledger 시스템 가이드](README.md)
+- [Feature 워크플로우](FEATURE_WORKFLOW.md)
+- [메타데이터 정의](FEATURE_METADATA.md)
+- [ID 생성 규칙](FEATURE_ID_GENERATOR.md)
+- [스키마 검증](schemas/feature_schema.json)
+
+---
+
+*이 인덱스는 Feature 생성/수정 시 자동으로 업데이트됩니다.*  
+*수동 업데이트: `/aiwf_update_feature_index`*
+
+**생성일**: 2025-07-08 20:56  
+**관리자**: moonklabs

package/claude-code/aiwf/ko/.aiwf/06_FEATURE_LEDGERS/FEATURE_METADATA.md

@@ -0,0 +1,240 @@
+# Feature 메타데이터 필드 정의
+
+## 개요
+
+Feature Ledger 시스템에서 각 Feature는 체계적인 메타데이터를 통해 관리됩니다. 이 문서는 모든 메타데이터 필드의 정의와 사용법을 설명합니다.
+
+## 필수 필드 (Required Fields)
+
+### 1. feature_id
+- **타입**: String
+- **형식**: `FL###` (예: FL001, FL002)
+- **설명**: Feature의 고유 식별자
+- **자동 생성**: 예
+- **수정 불가**: 예
+
+### 2. title
+- **타입**: String
+- **제한**: 1-100자
+- **설명**: Feature의 간단한 제목
+- **예시**: "사용자 인증 시스템", "댓글 기능 구현"
+
+### 3. description
+- **타입**: String
+- **제한**: 1-1000자
+- **설명**: Feature의 상세 설명
+- **예시**: "JWT 기반 사용자 인증 시스템 구현"
+
+### 4. status
+- **타입**: Enum
+- **값**: draft, active, on-hold, completed, archived
+- **설명**: Feature의 현재 상태
+- **기본값**: draft
+
+### 5. priority
+- **타입**: Enum
+- **값**: low, medium, high, critical
+- **설명**: Feature의 우선순위
+- **기본값**: medium
+
+## 프로젝트 연동 필드
+
+### 6. milestone_id
+- **타입**: String
+- **형식**: `M##` (예: M01, M02)
+- **설명**: 연관된 마일스톤 ID
+- **필수**: 예
+- **참조**: `02_REQUIREMENTS/` 디렉토리의 마일스톤
+
+### 7. assignee
+- **타입**: String
+- **제한**: 1-50자
+- **설명**: Feature 담당자명
+- **예시**: "moonklabs", "team-frontend", "개발자명"
+
+## 시간 관리 필드
+
+### 8. created_date
+- **타입**: DateTime (ISO 8601)
+- **설명**: Feature 생성 일시
+- **자동 생성**: 예
+- **예시**: "2025-07-08T20:55:57+0900"
+
+### 9. updated_date
+- **타입**: DateTime (ISO 8601)
+- **설명**: Feature 최종 수정 일시
+- **자동 업데이트**: 예
+- **예시**: "2025-07-08T21:30:45+0900"
+
+### 10. estimated_hours
+- **타입**: Number
+- **범위**: 0-1000
+- **단위**: 시간
+- **설명**: 예상 작업 시간
+- **기본값**: 0
+
+### 11. actual_hours
+- **타입**: Number
+- **범위**: 0-1000
+- **단위**: 시간
+- **설명**: 실제 작업 시간
+- **기본값**: 0
+- **자동 계산**: Git 커밋 기반 (옵션)
+
+## 분류 및 태그 필드
+
+### 12. tags
+- **타입**: Array of String
+- **제한**: 각 태그 1-30자
+- **설명**: Feature 분류 태그
+- **예시**: ["authentication", "security", "core"]
+- **사전 정의 태그**:
+  - **카테고리**: frontend, backend, api, database, ui, ux
+  - **유형**: feature, enhancement, bugfix, refactor, docs
+  - **복잡도**: simple, complex, critical
+  - **도메인**: auth, payment, notification, search, admin
+
+### 13. dependencies
+- **타입**: Array of String
+- **형식**: Feature ID 배열 (["FL002", "FL003"])
+- **설명**: 종속성 Feature ID 목록
+- **검증**: 존재하는 Feature ID만 허용
+- **순환 참조**: 자동 감지 및 방지
+
+## Git 연동 필드
+
+### 14. git_branches
+- **타입**: Array of String
+- **형식**: 브랜치명 배열
+- **설명**: 관련 Git 브랜치 목록
+- **예시**: ["feature/FL001-user-auth", "hotfix/FL001-security-fix"]
+- **자동 추가**: 브랜치 생성 시 자동 업데이트
+
+## 선택 필드 (Optional Fields)
+
+### 15. epic_id
+- **타입**: String
+- **형식**: `EP###` (예: EP001)
+- **설명**: 상위 Epic ID (대규모 Feature 그룹)
+- **사용**: 큰 프로젝트에서 Feature 그룹핑
+
+### 16. story_points
+- **타입**: Number
+- **범위**: 1-100
+- **설명**: 스크럼 스토리 포인트
+- **사용**: 애자일 개발 시 복잡도 추정
+
+### 17. acceptance_criteria
+- **타입**: Array of String
+- **설명**: 완료 조건 목록
+- **예시**: ["로그인 성공 시 토큰 발급", "실패 시 에러 메시지 표시"]
+
+### 18. business_value
+- **타입**: String
+- **제한**: 1-500자
+- **설명**: 비즈니스 가치 및 ROI 설명
+
+### 19. technical_notes
+- **타입**: String
+- **제한**: 1-2000자
+- **설명**: 기술적 구현 노트 및 제약사항
+
+### 20. test_coverage
+- **타입**: Number
+- **범위**: 0-100
+- **단위**: 퍼센트
+- **설명**: 테스트 커버리지 (자동 계산)
+
+## 메타데이터 검증 규칙
+
+### 1. 필수 필드 검증
+```yaml
+required_fields:
+  - feature_id
+  - title
+  - description
+  - status
+  - priority
+  - milestone_id
+  - assignee
+  - created_date
+  - updated_date
+  - estimated_hours
+  - actual_hours
+  - tags
+  - dependencies
+  - git_branches
+```
+
+### 2. 형식 검증
+- **Feature ID**: 정규식 `^FL[0-9]{3}$`
+- **Milestone ID**: 정규식 `^M[0-9]{2}$`
+- **Epic ID**: 정규식 `^EP[0-9]{3}$`
+- **날짜**: ISO 8601 형식
+- **브랜치명**: Git 브랜치 명명 규칙
+
+### 3. 참조 무결성
+- Milestone ID는 실제 존재하는 마일스톤 참조
+- Dependencies의 Feature ID는 실제 존재하는 Feature 참조
+- 순환 의존성 자동 감지
+
+## 기본값 및 자동 생성
+
+### 1. 자동 생성 필드
+```yaml
+auto_generated:
+  feature_id: "다음 가용 FL### ID"
+  created_date: "현재 시간"
+  updated_date: "현재 시간"
+```
+
+### 2. 기본값 설정
+```yaml
+defaults:
+  status: "draft"
+  priority: "medium"
+  estimated_hours: 0
+  actual_hours: 0
+  tags: []
+  dependencies: []
+  git_branches: []
+```
+
+## 메타데이터 활용
+
+### 1. 검색 및 필터링
+```bash
+# 태그별 검색
+/aiwf_search_features --tags authentication,security
+
+# 담당자별 검색
+/aiwf_search_features --assignee moonklabs
+
+# 마일스톤별 검색
+/aiwf_search_features --milestone M02
+
+# 복합 조건
+/aiwf_search_features --status active --priority high --milestone M02
+```
+
+### 2. 리포팅
+```bash
+# 진행률 리포트
+/aiwf_progress_report --milestone M02
+
+# 시간 추적 리포트
+/aiwf_time_report --assignee moonklabs --date-range "2025-07-01,2025-07-31"
+
+# 의존성 분석
+/aiwf_dependency_analysis --feature FL001
+```
+
+### 3. 자동화 트리거
+- **상태 변경** 시 Git 브랜치 생성/삭제
+- **의존성 해결** 시 대기 중인 Feature 알림
+- **시간 초과** 시 담당자 통지
+
+---
+
+*생성일: 2025-07-08*
+*최종 업데이트: 2025-07-08 20:55*