aiwf 0.3.8 → 0.3.13

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

@@ -1,138 +0,0 @@
-# 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

@@ -1,186 +0,0 @@
-# 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

@@ -1,240 +0,0 @@
-# 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*