aiwf 0.3.2 → 0.3.3

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

@@ -1,416 +0,0 @@
-# Feature Ledger User Guide
-
-## 목차
-
-1. [소개](#소개)
-2. [시작하기](#시작하기)
-3. [기본 워크플로우](#기본-워크플로우)
-4. [고급 사용법](#고급-사용법)
-5. [통합 가이드](#통합-가이드)
-6. [문제 해결](#문제-해결)
-7. [베스트 프랙티스](#베스트-프랙티스)
-
-## 소개
-
-### Feature Ledger란?
-
-Feature Ledger는 AIWF 프로젝트에서 기능 개발을 체계적으로 추적하고 관리하는 시스템입니다. 각 기능의 생명주기를 문서화하고, 진행 상황을 모니터링하며, 팀 협업을 향상시킵니다.
-
-### 주요 이점
-
-- **투명성**: 모든 기능의 상태를 한눈에 파악
-- **추적성**: Git 커밋과 PR을 자동으로 연결
-- **협업**: 팀원 간 작업 현황 공유
-- **보고**: 자동화된 진행 상황 보고서
-- **통합**: AIWF의 다른 시스템과 완벽히 통합
-
-## 시작하기
-
-### 1. 첫 번째 Feature Ledger 생성
-
-새로운 기능 개발을 시작할 때:
-
-```bash
-/project:aiwf:create_feature_ledger user_registration --milestone M02 --sprint S01_M02 --priority high
-```
-
-결과:
-```
-✅ Feature Ledger created successfully!
-Feature ID: FL001
-Title: User Registration
-Status: active
-Location: .aiwf/06_FEATURE_LEDGERS/active/FL001_User_Registration.md
-```
-
-### 2. Feature 파일 구조 이해하기
-
-생성된 Feature 파일을 열어보면:
-
-```yaml
----
-feature_id: FL001
-title: User Registration
-status: active
-created_date: 2025-07-09
-milestone: M02
-sprint_ids: [S01_M02]
-priority: high
----
-
-# Feature: User Registration
-
-## Overview
-[자동 생성된 템플릿]
-```
-
-### 3. Feature 정보 업데이트
-
-기본 정보를 채워넣습니다:
-
-1. Overview 섹션에 기능 설명 추가
-2. Requirements에 구체적인 요구사항 나열
-3. Technical Design에 구현 계획 작성
-
-## 기본 워크플로우
-
-### 개발 프로세스
-
-```mermaid
-graph LR
-    A[Feature 생성] --> B[계획 수립]
-    B --> C[개발 시작]
-    C --> D[진행률 업데이트]
-    D --> E[PR 생성]
-    E --> F[리뷰 및 머지]
-    F --> G[Feature 완료]
-```
-
-### 1단계: Feature 생성 및 계획
-
-```bash
-# Feature 생성
-/project:aiwf:create_feature_ledger payment_integration --milestone M02 --assignee "john_doe"
-
-# 브랜치 생성
-/project:aiwf:feature_branch FL002 create
-```
-
-### 2단계: 개발 중 진행률 추적
-
-```bash
-# 진행률 업데이트
-/project:aiwf:update_feature_progress FL002 25 --hours 8
-
-# 커밋 연결
-git commit -m "feat(FL002): Implement payment gateway connection"
-/project:aiwf:link_feature_commit FL002 --auto-progress
-```
-
-### 3단계: PR 및 완료
-
-```bash
-# PR 생성 및 연결
-gh pr create --title "feat(FL002): Payment Integration"
-/project:aiwf:link_feature_pr FL002 123
-
-# Feature 완료
-/project:aiwf:update_feature_status FL002 completed --comment "All tests passing"
-```
-
-## 고급 사용법
-
-### 복잡한 Feature 관리
-
-#### 의존성 설정
-
-Feature 간 의존성이 있을 때:
-
-```yaml
-# FL003 파일에서
-depends_on: [FL001, FL002]  # 이 기능들이 먼저 완료되어야 함
-blocks: [FL004, FL005]       # 이 Feature가 완료되어야 시작 가능
-```
-
-#### 하위 작업 분할
-
-큰 Feature를 작은 단위로 나누기:
-
-```markdown
-## Implementation Plan
-
-### Phase 1: Foundation (25%)
-- [x] Database schema design
-- [x] API specification
-- [ ] Core business logic
-
-### Phase 2: Integration (50%)
-- [ ] External API integration
-- [ ] Error handling
-- [ ] Logging setup
-
-### Phase 3: UI Implementation (25%)
-- [ ] Component development
-- [ ] Testing
-- [ ] Documentation
-```
-
-### 대시보드 및 보고서
-
-#### 실시간 대시보드
-
-```bash
-# 전체 현황
-/project:aiwf:feature_dashboard
-
-# 특정 마일스톤
-/project:aiwf:feature_dashboard --milestone M02
-
-# 개인별 현황
-/project:aiwf:feature_dashboard --assignee "john_doe"
-```
-
-#### 상세 보고서
-
-```bash
-# 개발 속도 분석
-/project:aiwf:feature_report velocity --milestone M02
-
-# 번다운 차트
-/project:aiwf:feature_report burndown --sprint S01_M02
-
-# 의존성 그래프
-/project:aiwf:feature_report dependencies --format html
-```
-
-### 검색 및 필터링
-
-```bash
-# 키워드 검색
-/project:aiwf:feature_search "payment" --tags "backend,api"
-
-# 날짜 범위 검색
-/project:aiwf:feature_search "*" --date-range "2025-07-01:2025-07-31"
-
-# 상태별 검색
-/project:aiwf:feature_search "*" --status active --assignee "john_doe"
-```
-
-## 통합 가이드
-
-### Git 워크플로우 통합
-
-#### 1. 브랜치 전략
-
-```bash
-# Feature 브랜치 생성
-/project:aiwf:feature_branch FL001 create
-# → feature/FL001-user-registration
-
-# 자동으로 체크아웃됨
-git status
-# On branch feature/FL001-user-registration
-```
-
-#### 2. 커밋 메시지 규칙
-
-```bash
-# Feature ID를 포함한 커밋
-git commit -m "feat(FL001): Add email validation"
-git commit -m "fix(FL001): Resolve password reset issue"
-git commit -m "test(FL001): Add unit tests for registration"
-```
-
-#### 3. 자동 동기화
-
-```bash
-# Git 히스토리를 Feature Ledger와 동기화
-/project:aiwf:feature_sync --direction git-to-ledger
-
-# 양방향 동기화
-/project:aiwf:feature_sync --direction both
-```
-
-### Sprint/Task 통합
-
-#### Feature와 Task 연결
-
-```yaml
-# Feature 파일에서
-tasks: [T01_S01, T02_S01, T03_S01]
-
-# Task 파일에서
-feature_id: FL001
-```
-
-#### 진행률 자동 계산
-
-Task 완료 시 Feature 진행률이 자동 업데이트됩니다:
-
-```
-Tasks completed: 2/3 → Feature progress: 67%
-```
-
-### CI/CD 통합
-
-#### GitHub Actions 예제
-
-```yaml
-name: Feature Ledger Update
-on:
-  pull_request:
-    types: [opened, merged]
-
-jobs:
-  update-feature:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - name: Extract Feature ID
-        run: |
-          FEATURE_ID=$(echo "${{ github.event.pull_request.title }}" | grep -oP 'FL\d{3}')
-          echo "FEATURE_ID=$FEATURE_ID" >> $GITHUB_ENV
-      - name: Update Feature Status
-        if: github.event.pull_request.merged == true
-        run: |
-          npx aiwf update_feature_status $FEATURE_ID completed
-```
-
-## 문제 해결
-
-### 일반적인 문제
-
-#### 1. Feature ID 중복
-
-**문제**: "Error E003: Duplicate feature ID"
-
-**해결책**:
-```bash
-# 현재 사용 중인 ID 확인
-cat .aiwf/06_FEATURE_LEDGERS/FEATURE_LEDGER_INDEX.md | grep "Last assigned ID"
-
-# 다음 번호 사용
-/project:aiwf:create_feature_ledger new_feature
-```
-
-#### 2. 잘못된 상태 전환
-
-**문제**: "Error E002: Invalid status transition"
-
-**해결책**:
-- `archived` 상태는 되돌릴 수 없음
-- `completed` → `active`는 불가능
-- 필요시 새 Feature 생성
-
-#### 3. Git 동기화 실패
-
-**문제**: "Error E004: Git integration failed"
-
-**해결책**:
-```bash
-# Git 상태 확인
-git status
-
-# 스테이징된 변경사항 커밋
-git add .
-git commit -m "Save work before feature sync"
-
-# 다시 시도
-/project:aiwf:feature_sync
-```
-
-### 디버깅 팁
-
-#### 로그 확인
-
-```bash
-# Feature 활동 로그
-tail -f .aiwf/logs/feature_ledger.log
-
-# 특정 Feature 히스토리
-grep "FL001" .aiwf/logs/feature_ledger.log
-```
-
-#### 수동 복구
-
-```bash
-# 인덱스 재구성
-/project:aiwf:feature_index --rebuild
-
-# 무결성 검사
-/project:aiwf:feature_validate --fix
-```
-
-## 베스트 프랙티스
-
-### 1. Feature 생성 시점
-
-- ✅ 개발 시작 전 생성
-- ✅ 요구사항이 명확해졌을 때
-- ❌ 개발 완료 후 생성
-- ❌ 너무 세분화된 작업
-
-### 2. 진행률 관리
-
-```bash
-# 좋은 예: 구체적인 진행 사항과 함께
-/project:aiwf:update_feature_progress FL001 40 --comment "API endpoints completed"
-
-# 나쁜 예: 설명 없이
-/project:aiwf:update_feature_progress FL001 40
-```
-
-### 3. 커밋 메시지
-
-```bash
-# 좋은 예
-git commit -m "feat(FL001): Implement JWT authentication with refresh tokens"
-
-# 나쁜 예
-git commit -m "Update auth"  # Feature ID 없음
-git commit -m "FL001"        # 설명 없음
-```
-
-### 4. Feature 범위
-
-**적절한 Feature 크기**:
-- 1-2주 내 완료 가능
-- 명확한 비즈니스 가치
-- 독립적으로 배포 가능
-
-**피해야 할 것**:
-- 너무 큰 범위 (예: "전체 시스템 리팩토링")
-- 너무 작은 범위 (예: "버튼 색상 변경")
-- 모호한 목표
-
-### 5. 팀 협업
-
-```markdown
-## 일일 스탠드업에서
-"FL001 진행률 70%, 오늘 인증 로직 완료 예정"
-
-## PR 리뷰에서
-"FL001의 요구사항 3번이 구현되지 않았습니다"
-
-## 스프린트 회고에서
-"FL001이 예상보다 복잡해서 2개 Feature로 분할 필요"
-```
-
-### 6. 문서화
-
-Feature Ledger 자체가 문서이므로:
-
-1. **실시간 업데이트**: 변경사항 즉시 반영
-2. **상세 기록**: 의사결정 과정 포함
-3. **링크 활용**: 관련 문서, PR, 이슈 연결
-4. **시각적 자료**: 다이어그램, 스크린샷 추가
-
-## 다음 단계
-
-1. [API Reference](./FEATURE_LEDGER_API_REFERENCE.md) - 모든 명령어 상세 정보
-2. [Architecture Guide](../02_REQUIREMENTS/M02_Context_Engineering_Enhancement/SPECS_Feature_Ledger_System.md) - 시스템 구조 이해
-3. [Integration Examples](../06_FEATURE_LEDGERS/FEATURE_INTEGRATION_GUIDE.md) - 실제 통합 예제
-
----
-
-*이 가이드는 AIWF Feature Ledger System v1.0 기준으로 작성되었습니다.*

package/claude-code/aiwf/ko/docs/FEATURE_LEDGER_/354/213/234/354/236/221_/352/260/200/354/235/264/353/223/234.md

@@ -1,247 +0,0 @@
-# Feature Ledger 시작 가이드
-
-## Feature Ledger란?
-
-Feature Ledger는 AIWF 프로젝트에서 기능 개발의 전체 생명주기를 추적하고 관리하는 시스템입니다. 각 기능의 계획부터 완료까지 모든 과정을 문서화하고, Git과 연동하여 개발 진행 상황을 실시간으로 파악할 수 있습니다.
-
-## 빠른 시작
-
-### 1. 첫 Feature 생성하기
-
-새로운 기능 개발을 시작할 때:
-
-```bash
-/project:aiwf:create_feature_ledger 사용자_인증_시스템 --milestone M02 --priority high
-```
-
-생성된 Feature 파일 확인:
-```bash
-cat .aiwf/06_FEATURE_LEDGERS/active/FL001_사용자_인증_시스템.md
-```
-
-### 2. Feature 정보 채우기
-
-생성된 파일을 열어 다음 정보를 추가합니다:
-
-```markdown
-## Overview
-사용자 인증 시스템은 JWT 기반의 로그인/로그아웃 기능을 제공합니다.
-이메일 인증과 소셜 로그인을 지원하며, 보안 강화를 위한 2FA도 포함됩니다.
-
-## Requirements
-- [x] 이메일/비밀번호 로그인
-- [x] JWT 토큰 발급 및 검증
-- [ ] 소셜 로그인 (Google, GitHub)
-- [ ] 2단계 인증 (2FA)
-- [ ] 비밀번호 재설정
-```
-
-### 3. 개발 시작하기
-
-Feature 브랜치 생성:
-```bash
-/project:aiwf:feature_branch FL001 create
-# → feature/FL001-사용자-인증-시스템 브랜치 생성 및 체크아웃
-```
-
-### 4. 진행 상황 추적하기
-
-개발하면서 진행률 업데이트:
-```bash
-# 진행률 업데이트
-/project:aiwf:update_feature_progress FL001 30 --comment "로그인 API 완성"
-
-# 커밋과 연결
-git commit -m "feat(FL001): JWT 토큰 발급 로직 구현"
-/project:aiwf:link_feature_commit FL001
-```
-
-### 5. 완료 처리하기
-
-모든 요구사항이 완료되면:
-```bash
-/project:aiwf:update_feature_status FL001 completed --comment "모든 테스트 통과, 문서화 완료"
-```
-
-## 주요 개념
-
-### Feature 생명주기
-
-```mermaid
-graph LR
-    생성[🆕 생성] --> 활성[🚀 활성]
-    활성 --> 일시중단[⏸️ 일시중단]
-    활성 --> 완료[✅ 완료]
-    일시중단 --> 활성
-    완료 --> 보관[📦 보관]
-    일시중단 --> 보관
-    활성 --> 보관
-```
-
-### Feature 크기 가이드
-
-적절한 Feature 범위:
-- ⭐ **좋은 예**: "사용자 인증 시스템", "대시보드 리디자인", "결제 시스템 통합"
-- ❌ **나쁜 예**: "버튼 색상 변경", "전체 앱 리팩토링", "버그 수정"
-
-### 디렉토리 구조
-
-```
-.aiwf/06_FEATURE_LEDGERS/
-├── active/          # 🚀 진행 중
-├── completed/       # ✅ 완료됨
-├── paused/         # ⏸️ 일시중단
-└── archived/       # 📦 보관됨
-```
-
-## 실전 예제
-
-### 예제 1: API 엔드포인트 개발
-
-```bash
-# 1. Feature 생성
-/project:aiwf:create_feature_ledger 상품_검색_API --milestone M02 --assignee "김개발"
-
-# 2. 요구사항 정의 (파일 편집)
-## Requirements
-- [ ] 키워드 검색 API
-- [ ] 필터링 기능 (카테고리, 가격대)
-- [ ] 정렬 옵션 (인기순, 가격순, 최신순)
-- [ ] 페이지네이션
-
-# 3. 개발 진행
-git checkout -b feature/FL002-상품-검색-API
-# ... 코딩 ...
-
-# 4. 진행률 업데이트
-/project:aiwf:update_feature_progress FL002 50 --comment "검색 로직 구현 완료"
-
-# 5. PR 생성 및 연결
-gh pr create --title "feat(FL002): 상품 검색 API 구현"
-/project:aiwf:link_feature_pr FL002 123
-```
-
-### 예제 2: UI 컴포넌트 개발
-
-```bash
-# 1. Feature 생성 (태그 포함)
-/project:aiwf:create_feature_ledger 반응형_네비게이션 --tags "frontend,ui,responsive"
-
-# 2. 하위 작업 분할
-## Implementation Plan
-### Phase 1: 데스크톱 레이아웃 (30%)
-- [x] 메뉴 구조 설계
-- [ ] 스타일링
-- [ ] 애니메이션
-
-### Phase 2: 모바일 최적화 (40%)
-- [ ] 햄버거 메뉴
-- [ ] 터치 제스처
-- [ ] 성능 최적화
-
-### Phase 3: 테스트 및 문서화 (30%)
-- [ ] 크로스 브라우저 테스트
-- [ ] 스토리북 문서
-- [ ] 사용 가이드
-```
-
-## 팀 협업
-
-### 일일 스탠드업에서
-
-```markdown
-"FL001 사용자 인증 - 진행률 70%
- - 어제: JWT 리프레시 토큰 구현
- - 오늘: 소셜 로그인 통합
- - 블로커: OAuth 설정 관련 DevOps 팀 지원 필요"
-```
-
-### 코드 리뷰에서
-
-```bash
-# PR 설명에 Feature 참조
-PR 제목: feat(FL001): 소셜 로그인 구현
-
-본문:
-## Feature: FL001 - 사용자 인증 시스템
-
-### 구현 내용
-- Google OAuth 2.0 통합
-- GitHub 로그인 지원
-- 기존 계정과 소셜 계정 연동
-
-### 체크리스트
-- [x] 단위 테스트
-- [x] 통합 테스트  
-- [x] 문서 업데이트
-```
-
-### 스프린트 회고에서
-
-대시보드로 전체 현황 파악:
-```bash
-/project:aiwf:feature_dashboard --sprint S01_M02
-
-# 출력:
-## Sprint S01_M02 Features
-- FL001: 사용자 인증 [90%] ⚠️ 1일 지연
-- FL002: 상품 검색 API [100%] ✅ 완료
-- FL003: 결제 시스템 [30%] 🚀 진행 중
-```
-
-## 유용한 팁
-
-### 1. 자동화 활용
-
-Git Hook 설정 (`.git/hooks/prepare-commit-msg`):
-```bash
-#!/bin/bash
-# Feature ID 자동 추가
-BRANCH=$(git rev-parse --abbrev-ref HEAD)
-FEATURE_ID=$(echo $BRANCH | grep -oP 'FL\d{3}')
-
-if [ ! -z "$FEATURE_ID" ]; then
-    sed -i "1s/^/feat($FEATURE_ID): /" $1
-fi
-```
-
-### 2. 템플릿 활용
-
-자주 사용하는 Feature 유형별 템플릿 준비:
-- `api_feature_template.md` - API 개발용
-- `ui_feature_template.md` - UI 컴포넌트용
-- `bugfix_feature_template.md` - 버그 수정용
-
-### 3. 검색 활용
-
-```bash
-# 내가 담당한 활성 Feature
-/project:aiwf:feature_search "*" --assignee "나" --status active
-
-# 이번 주 완료된 Feature
-/project:aiwf:feature_search "*" --date-range "2025-07-01:2025-07-07" --status completed
-
-# 높은 우선순위 Feature
-/project:aiwf:feature_search "*" --priority critical,high
-```
-
-## 다음 단계
-
-1. **상세 문서 읽기**
-   - [API 레퍼런스](./FEATURE_LEDGER_API_REFERENCE.md) - 모든 명령어 상세 설명
-   - [사용자 가이드](./FEATURE_LEDGER_USER_GUIDE.md) - 고급 기능과 통합
-   - [FAQ](./FEATURE_LEDGER_FAQ.md) - 자주 묻는 질문과 문제 해결
-
-2. **실습하기**
-   - 테스트 Feature 생성해보기
-   - Git 통합 연습하기
-   - 대시보드 생성해보기
-
-3. **팀과 공유하기**
-   - 팀 규칙 정하기 (Feature 크기, 명명 규칙 등)
-   - 워크플로우 문서화
-   - 정기 리뷰 프로세스 수립
-
----
-
-*🚀 Feature Ledger로 더 체계적인 개발을 시작하세요!*