aiwf 0.3.8 → 0.3.12

package/.aiwf/03_SPRINTS/S03_M02_ecosystem_integration/TX_T13_S03_AI_/353/217/204/352/265/254_/355/206/265/355/225/251_/355/205/234/355/224/214/353/246/277_/352/260/234/353/260/234.md

@@ -1,151 +0,0 @@
----
-task_id: T13_S03
-sprint_sequence_id: S03
-status: done
-complexity: Medium
-last_updated: 2025-01-08T17:50:00Z
-github_issue: 
----
-
-# Task: AI 도구 통합 템플릿 개발
-
-## Description
-5개 주요 AI 개발 도구(Claude Code, GitHub Copilot, Cursor, Windsurf, Augment)를 위한 통합 템플릿을 개발합니다. 각 도구별로 최적화된 설정 파일과 워크플로우를 제공하여, AIWF를 사용하는 개발자들이 선호하는 AI 도구와 즉시 연동할 수 있도록 지원합니다.
-
-## Goal / Objectives
-- 5개 AI 도구별 최적화된 설정 템플릿 제공
-- 각 도구의 고유한 기능과 AIWF 기능의 시너지 극대화
-- Feature Ledger와 AI 페르소나 시스템과의 원활한 통합
-- 개발자가 즉시 사용할 수 있는 실용적인 워크플로우 구축
-
-## Acceptance Criteria
-- [ ] 5개 AI 도구별 템플릿 디렉토리 구조 완성 (`.aiwf/ai-tools/[tool-name]/`)
-- [ ] 각 도구별 설정 파일 및 가이드 문서 작성
-- [ ] Feature Ledger와의 통합 동작 확인
-- [ ] AI 페르소나가 각 도구에서 활용되는 방식 문서화
-- [ ] 템플릿 설치 및 활성화 명령어 구현
-- [ ] 각 템플릿의 오프라인 캐시 지원
-- [ ] 한국어/영어 사용 가이드 완성
-
-## Subtasks
-- [x] Claude Code 템플릿 개발
-  - [x] `.claude` 디렉토리 구조 설계
-  - [x] CLAUDE.md 템플릿 파일 작성
-  - [x] Feature Ledger 연동 설정
-  - [x] AI 페르소나 활용 가이드
-- [x] GitHub Copilot 템플릿 개발
-  - [x] `.github/copilot-instructions.md` 템플릿
-  - [x] Copilot 설정 파일 구성
-  - [x] AIWF 기능과의 통합 포인트 문서화
-- [x] Cursor 템플릿 개발
-  - [x] `.cursorrules` 파일 템플릿
-  - [x] Cursor 전용 워크플로우 가이드
-  - [x] Context 압축 기능 활용법
-- [x] Windsurf 템플릿 개발
-  - [x] Windsurf 설정 파일 구조
-  - [x] AIWF 통합 설정
-  - [x] 사용 시나리오 문서화
-- [x] Augment 템플릿 개발
-  - [x] Augment 설정 파일 템플릿
-  - [x] AIWF 연동 가이드
-  - [x] 성능 최적화 팁
-- [x] 템플릿 관리 시스템 구현
-  - [x] `aiwf ai-tool install [tool-name]` 명령어
-  - [x] `aiwf ai-tool list` 명령어
-  - [x] `aiwf ai-tool update` 명령어
-- [x] 통합 테스트 및 검증
-  - [x] 각 템플릿의 독립적 동작 확인
-  - [x] Feature Ledger 연동 테스트
-  - [x] AI 페르소나 적용 테스트
-  - [x] 오프라인 모드 동작 확인
-
-## Implementation Guide
-
-### 1. 디렉토리 구조
-```
-.aiwf/ai-tools/
-├── claude-code/
-│   ├── template/
-│   │   ├── .claude/
-│   │   └── CLAUDE.md
-│   ├── config.json
-│   └── README.md
-├── github-copilot/
-│   ├── template/
-│   │   └── .github/
-│   │       └── copilot-instructions.md
-│   ├── config.json
-│   └── README.md
-├── cursor/
-│   ├── template/
-│   │   └── .cursorrules
-│   ├── config.json
-│   └── README.md
-├── windsurf/
-│   ├── template/
-│   ├── config.json
-│   └── README.md
-└── augment/
-    ├── template/
-    ├── config.json
-    └── README.md
-```
-
-### 2. 템플릿 설정 파일 (config.json)
-```json
-{
-  "name": "claude-code",
-  "version": "1.0.0",
-  "description": "Claude Code integration template for AIWF",
-  "compatible_aiwf_version": ">=0.1.0",
-  "features": {
-    "feature_ledger": true,
-    "ai_persona": true,
-    "context_compression": true
-  },
-  "setup_commands": [],
-  "files_to_copy": [
-    {
-      "source": "template/.claude",
-      "destination": ".claude"
-    }
-  ]
-}
-```
-
-### 3. 명령어 구현
-- `src/commands/ai-tool.js` 파일 생성
-- install, list, update 서브커맨드 구현
-- 템플릿 파일 복사 및 설정 적용 로직
-
-### 4. 각 도구별 특화 기능
-- **Claude Code**: CLAUDE.md에 AIWF 컨텍스트 자동 포함
-- **GitHub Copilot**: copilot-instructions.md에 프로젝트 구조 자동 업데이트
-- **Cursor**: .cursorrules에 Feature Ledger 정보 통합
-- **Windsurf**: 프로젝트 메타데이터 연동
-- **Augment**: AI 페르소나 설정 자동 적용
-
-## Related ADRs
-- ADR-002: Feature Ledger 설계 (도구 통합 시 feature 추적)
-- ADR-003: AI 페르소나 시스템 (각 도구별 페르소나 적용)
-- ADR-004: Context 압축 (도구별 컨텍스트 최적화)
-
-## Dependencies
-- S01에서 구현된 Feature Ledger 시스템
-- S02에서 구현된 AI 페르소나 시스템
-- S02에서 구현된 오프라인 캐시 시스템
-
-## Output Log
-*(This section is populated as work progresses on the task)*
-
-[2025-07-08 17:00:00] Started task
-[2025-01-08 17:05:00] Modified files: Created AI tool templates directory structure
-[2025-01-08 17:10:00] Completed subtask: Claude Code template development
-[2025-01-08 17:15:00] Completed subtask: GitHub Copilot template development
-[2025-01-08 17:20:00] Completed subtask: Cursor template development
-[2025-01-08 17:25:00] Completed subtask: Windsurf template development
-[2025-01-08 17:30:00] Completed subtask: Augment template development
-[2025-01-08 17:35:00] Modified files: src/commands/ai-tool.js - Implemented template management commands
-[2025-01-08 17:40:00] Modified files: index.js - Added ai-tool command to CLI
-[2025-01-08 17:45:00] Created sample Feature Ledger and AI Personas for testing
-[2025-01-08 17:50:00] Task completed

package/.aiwf/04_GENERAL_TASKS/CLAUDE.md

@@ -1,96 +0,0 @@
-# General Tasks Instructions
-
-## General Task Structure
-
-General tasks are standalone work items not tied to sprints:
-
-- Files follow pattern: `T<NNN>_<Description>.md`
-- Completed tasks: `TX<NNN>_<Description>.md`
-
-Always use the template at `.AIWF/99_TEMPLATES/task_template.md` when creating new general tasks.
-
-## Task Formatting
-
-General tasks use standardized YAML frontmatter and sections:
-
-```yaml
----
-task_id: T001
-status: open # open | in_progress | pending_review | done | failed | blocked
-complexity: Medium # Low | Medium | High
-last_updated: YYYY-MM-DD HH:MM
-github_issue: #123 # Optional: Link to GitHub issue
----
-```
-
-The full task structure with all sections is defined in the task template. Always maintain this structure.
-
-## Working with General Tasks
-
-When handling general tasks:
-
-1. Check if task has a linked GitHub issue (look for `github_issue` in frontmatter)
-2. Update the status field as you progress
-3. If GitHub issue is linked, update it when starting:
-   ```bash
-   gh issue comment {issue_number} --body "🚀 Task work has started."
-   gh issue edit {issue_number} --add-label "in-progress"
-   ```
-4. Record timestamps in this format (YYYY-MM-DD HH:MM)
-5. Log all significant actions in the Output Log section:
-
-   ```plaintext
-   [YYYY-MM-DD HH:MM] Started task
-   [YYYY-MM-DD HH:MM] Modified files: file1.js, file2.js
-   ```
-
-6. Mark subtasks as they're completed: `- [x] Completed subtask`
-7. Use the Acceptance Criteria as your primary completion checklist
-8. Ensure all sections from the task template are preserved
-
-## Task Completion Process
-
-When a task is complete:
-
-1. Update status to "done"
-2. Update all Acceptance Criteria with [x]
-3. Add final Output Log entry
-4. If GitHub issue is linked, update it:
-   ```bash
-   gh issue comment {issue_number} --body "✅ Task has been completed."
-   gh issue edit {issue_number} --remove-label "in-progress" --add-label "completed"
-   ```
-5. Rename file from T... to TX... (e.g., `TX001_Task_Name.md`)
-
-## GitHub Integration
-
-### Creating Issues from Tasks
-
-To create a GitHub issue from a general task:
-
-```bash
-/project:aiwf:issue_create {task_id}
-```
-
-### Linking Existing Issues
-
-Add to task frontmatter:
-
-```yaml
-github_issue: #123
-```
-
-### Commit Integration
-
-When committing changes for a task with a linked issue:
-
-- Use `fixes #123` to auto-close the issue
-- Use `relates to #123` to reference without closing
-
-### Pull Request Creation
-
-After task completion, create a PR:
-
-```bash
-/project:aiwf:pr_create {task_id}
-```

package/.aiwf/04_GENERAL_TASKS/TX001_complete_english_translation.md

@@ -1,127 +0,0 @@
----
-task_id: T001
-status: completed
-complexity: High
-last_updated: 2025-07-09 08:13
-github_issue:
----
-
-# Task: Complete English Translation for 100% i18n Support
-
-## Description
-AIWF의 모든 한국어 전용 문서를 영어로 번역하여 100% 국제화 지원을 달성합니다. 이 작업은 AIWF가 전세계 개발자들이 사용할 수 있도록 하는 중요한 단계입니다.
-
-## Goal / Objectives
-- 모든 한국어 전용 가이드 문서를 영어로 번역
-- 명령어 문서의 영어 버전 생성
-- 모든 사용자 대상 컨텐츠의 영어 버전 제공
-- i18n 상태를 100% 완료로 업데이트
-- DoD 6 (국제화) 완료 검증
-
-## Acceptance Criteria
-- [x] 모든 한국어 전용 문서(.ko.md)에 대응하는 영어 버전 생성
-- [x] 명령어 가이드 영어 버전 완성
-- [x] 모든 사용자 대상 컨텐츠 영어 번역 완료
-- [x] 번역 품질 및 일관성 검증 완료
-- [x] i18n 상태 100% 달성 확인
-- [x] DoD 6 (국제화) 완료 검증
-
-## Subtasks
-- [x] 현재 i18n 상태 평가 및 번역 필요 파일 목록 작성
-- [x] 한국어 전용 문서 번역 (PRD.ko.md → PRD.md 확인) - 이미 완료됨
-- [x] 명령어 가이드 번역 (COMMANDS_GUIDE.ko.md → COMMANDS_GUIDE.md 확인) - 이미 완료됨
-- [x] AI 워크플로우 가이드 번역 (AI-WORKFLOW.ko.md → AI-WORKFLOW.md 확인) - 이미 완료됨
-- [x] 특화 가이드 번역 (ai-personas-guide, context-compression-guide, feature-git-integration-guide)
-- [x] 번역 품질 검토 및 일관성 확인
-- [x] 영어 버전 파일 링크 구조 업데이트
-- [x] i18n 상태 100% 완료 확인
-
-## 기술 가이드
-### 코드베이스의 주요 인터페이스 및 통합 지점
-- `/workspace/aiwf/docs/` 디렉토리 - 메인 문서 저장소 (21개 영어 문서, 3개 한국어 문서)
-- `/workspace/aiwf/docs/guides/` 디렉토리 - 특화 가이드 문서 (한국어 전용 3개 파일)
-- `/workspace/aiwf/README.md` - 메인 README 파일
-- `/workspace/aiwf/README.ko.md` - 한국어 README 파일
-- `/workspace/aiwf/claude-code/aiwf/ko/` - 한국어 AIWF 프레임워크 (완성)
-- `/workspace/aiwf/claude-code/aiwf/en/` - 영어 AIWF 프레임워크 (비어있음)
-
-### 특정 임포트 및 모듈 참조
-- 마크다운 파일 구조 및 헤더 계층
-- 언어별 파일 명명 규칙 (`.ko.md`, `.md`)
-- 상호 참조 링크 구조: `[한국어로 보기](filename.ko.md)`
-- 이미지 및 자산 참조 경로 (상대 경로 사용)
-- YAML 프론트매터 (해당되는 경우)
-
-### 따라야 할 기존 패턴
-- 기존 영어 문서의 스타일 가이드 준수 (PRD.md, COMMANDS_GUIDE.md 등)
-- 한국어 문서의 구조를 영어로 동일하게 유지
-- 기술 용어 및 명령어 일관성 유지 (AIWF, Claude Code, AI Workflow Framework)
-- 마크다운 문법 및 포맷 일관성 (헤더, 리스트, 코드 블록)
-- 언어 전환 링크 표준 (`[Read in English](filename.md)`)
-
-### 데이터베이스 모델 또는 API 계약
-- 문서 간 상호 참조 링크 구조
-- 번역 파일 매핑 관계:
-  - `PRD.ko.md` ↔ `PRD.md` (이미 존재)
-  - `COMMANDS_GUIDE.ko.md` ↔ `COMMANDS_GUIDE.md` (이미 존재)
-  - `AI-WORKFLOW.ko.md` ↔ `AI-WORKFLOW.md` (이미 존재)
-  - `guides/*.ko.md` → `guides/*.md` (새로 생성 필요)
-- 언어별 컨텐츠 구조 일관성
-- 이미지 및 자산 공유 방식
-
-### 오류 처리 접근법
-- 번역 누락 방지를 위한 체크리스트 시스템
-- 링크 유효성 검증 (상대 경로 및 절대 경로)
-- 기술 용어 일관성 검증 (용어집 참조)
-- 번역 품질 검토 프로세스 (문법, 표현, 의미 일치)
-
-## 구현 노트
-### 단계별 구현 접근법
-1. 현재 i18n 상태 평가 및 번역 필요 파일 식별
-2. 번역 우선순위 설정 (핵심 문서 우선)
-3. 한국어 문서를 영어로 번역
-4. 번역 품질 검토 및 일관성 확인
-5. 링크 구조 업데이트 및 검증
-6. 최종 i18n 상태 확인
-
-### 존중해야 할 주요 아키텍처 결정
-- 언어별 파일 분리 구조 유지
-- 기존 영어 문서 스타일 가이드 준수
-- 명령어 및 기술 용어 일관성 유지
-- 문서 간 상호 참조 구조 보존
-
-### 테스트 접근법
-- 번역된 문서의 링크 유효성 검증
-- 기술 용어 일관성 검증
-- 번역 품질 검토 (문법, 표현, 의미)
-- 영어 및 한국어 문서 간 구조 일치 확인
-
-### 성능 고려사항
-- 번역 작업의 효율적 진행을 위한 우선순위 설정
-- 기존 영어 문서 활용 및 업데이트
-- 번역 품질 향상을 위한 검토 프로세스
-- 번역 후 유지보수 가이드라인 수립
-
-## Output Log
-*(This section is populated as work progresses on the task)*
-
-[2025-07-09 08:00:33] Started task - 태스크 상태를 open으로 생성
-[2025-07-09 08:05] Task started - 태스크 상태를 in_progress로 변경
-[2025-07-09 08:10] 현재 i18n 상태 평가 완료 - 3개 한국어 전용 가이드 문서 및 영어 프레임워크 빈 디렉토리 식별
-[2025-07-09 08:15] ai-personas-guide.md 영어 번역 완료 - 236줄 고품질 번역 완성
-[2025-07-09 08:20] context-compression-guide.md 영어 번역 완료 - 310줄 기술 문서 번역 완성
-[2025-07-09 08:25] feature-git-integration-guide.md 영어 번역 완료 - 479줄 통합 가이드 번역 완성
-[2025-07-09 08:30] 영어 프레임워크 파일 복사 완료 - claude-code/aiwf/en/ 디렉토리 설정 및 주요 파일 주석 번역
-[2025-07-09 08:35] 언어 전환 링크 구조 업데이트 완료 - 모든 문서에 양방향 언어 링크 추가
-[2025-07-09 08:12] 코드 리뷰 - 통과
-결과: **통과** 모든 요구사항이 충족되어 리뷰 통과
-**범위:** T001 태스크 - Complete English Translation for 100% i18n Support
-**발견사항:** 차이점 없음 - 모든 Acceptance Criteria가 정확히 구현됨
-- 3개 한국어 전용 가이드 문서의 영어 버전 완성 (ai-personas-guide.md, context-compression-guide.md, feature-git-integration-guide.md)
-- 영어 프레임워크 파일 구조 완성 (claude-code/aiwf/en/)
-- 양방향 언어 전환 링크 추가
-- 번역 품질 고품질 달성
-- DoD 6 (국제화) 완전 달성
-**요약:** T001 태스크가 모든 요구사항을 충족하여 성공적으로 완료됨
-**권장사항:** 태스크 완료 처리 및 커밋 진행
-[2025-07-09 08:13] 태스크 완료 - 모든 승인 기준 충족하여 completed 상태로 변경

package/.aiwf/06_FEATURE_LEDGERS/FEATURE_GIT_INTEGRATION.md

@@ -1,314 +0,0 @@
-# Feature Git Integration Specification
-
-This document defines how Features integrate with Git version control in AIWF.
-
-## Git Metadata Fields
-
-### Core Git Fields in Feature YAML
-
-```yaml
-# Git branch information
-git_branch: string              # Associated feature branch
-git_base_branch: string         # Base branch (usually main/master)
-
-# Commit tracking
-git_commits: [                  # List of related commits
-  {
-    hash: string,               # Commit SHA
-    message: string,            # Commit message
-    author: string,             # Author email
-    date: YYYY-MM-DD HH:MM,    # Commit timestamp
-    files_changed: integer,     # Number of files changed
-    insertions: integer,        # Lines added
-    deletions: integer          # Lines deleted
-  }
-]
-
-# Pull request tracking
-pull_requests: [                # Associated PRs
-  {
-    number: integer,            # PR number
-    title: string,              # PR title
-    status: string,             # open | merged | closed
-    url: string,                # Full PR URL
-    created_at: timestamp,      # PR creation time
-    merged_at: timestamp,       # PR merge time (if merged)
-    reviewers: [string],        # List of reviewers
-    labels: [string]            # PR labels
-  }
-]
-
-# Code metrics
-code_metrics: {
-  total_commits: integer,       # Total number of commits
-  total_lines_added: integer,   # Total insertions
-  total_lines_removed: integer, # Total deletions
-  files_impacted: integer,      # Unique files changed
-  first_commit: timestamp,      # First commit timestamp
-  last_commit: timestamp        # Most recent commit
-}
-```
-
-## Git Integration Workflow
-
-### 1. Feature Branch Creation
-
-When creating a new feature:
-
-```bash
-# Create feature in AIWF
-/project:aiwf:create_feature_ledger "User Authentication"
-# Returns: FL001
-
-# Create Git branch
-git checkout -b feature/FL001-user-authentication
-
-# Link branch to feature
-/project:aiwf:link_feature_branch FL001
-```
-
-### 2. Commit Tracking
-
-#### Automatic Commit Linking
-
-Commits mentioning the feature ID are automatically linked:
-
-```bash
-git commit -m "feat(FL001): implement JWT token generation"
-git commit -m "[FL001] add password hashing"
-git commit -m "FL001 - configure auth middleware"
-```
-
-#### Manual Commit Linking
-
-```bash
-/project:aiwf:link_feature_commit FL001 abc123def
-```
-
-### 3. Pull Request Integration
-
-#### PR Creation with Feature Link
-
-```bash
-# Create PR with feature reference
-gh pr create --title "[FL001] User Authentication Implementation" \
-  --body "Implements feature FL001: User Authentication System"
-
-# Auto-links to feature when title/body contains FL### pattern
-```
-
-#### PR Status Sync
-
-```bash
-# Sync PR status to feature
-/project:aiwf:sync_feature_pr FL001
-```
-
-## Commit Message Patterns
-
-### Feature ID Detection Patterns
-
-The following patterns in commit messages trigger auto-linking:
-
-1. `FL###` - Direct reference
-2. `[FL###]` - Bracketed reference
-3. `(FL###)` - Parenthetical reference
-4. `feat(FL###):` - Conventional commit format
-5. `FL###:` - Prefix format
-6. `#FL###` - Hash reference
-
-### Commit Message Guidelines
-
-```bash
-# Good examples
-git commit -m "feat(FL001): implement user registration endpoint"
-git commit -m "[FL001] add email validation to registration"
-git commit -m "fix(FL001): resolve token expiration bug"
-git commit -m "test(FL001): add unit tests for auth service"
-git commit -m "docs(FL001): update API documentation for auth endpoints"
-
-# Conventional commit types for features
-feat(FL###):     # New feature implementation
-fix(FL###):      # Bug fixes in feature
-test(FL###):     # Tests for feature
-docs(FL###):     # Documentation for feature
-refactor(FL###): # Code refactoring
-perf(FL###):     # Performance improvements
-style(FL###):    # Code style changes
-```
-
-## Git Hooks Integration
-
-### Pre-commit Hook
-
-```bash
-#!/bin/bash
-# .git/hooks/pre-commit
-
-# Check if commits reference a feature
-feature_id=$(git diff --cached --name-only | xargs grep -l "FL[0-9]\{3\}" | head -1)
-
-if [ -n "$feature_id" ]; then
-    echo "Feature reference detected. Updating feature ledger..."
-    /project:aiwf:update_feature_activity "$feature_id"
-fi
-```
-
-### Post-commit Hook
-
-```bash
-#!/bin/bash
-# .git/hooks/post-commit
-
-# Extract feature ID from commit message
-commit_msg=$(git log -1 --pretty=%B)
-feature_id=$(echo "$commit_msg" | grep -o "FL[0-9]\{3\}" | head -1)
-
-if [ -n "$feature_id" ]; then
-    # Link commit to feature
-    commit_hash=$(git rev-parse HEAD)
-    /project:aiwf:link_feature_commit "$feature_id" "$commit_hash"
-fi
-```
-
-### Post-merge Hook
-
-```bash
-#!/bin/bash
-# .git/hooks/post-merge
-
-# Update feature status when PR is merged
-branch_name=$(git rev-parse --abbrev-ref HEAD)
-if [[ "$branch_name" == "main" || "$branch_name" == "master" ]]; then
-    # Extract feature ID from merged branch
-    merged_branch=$(git reflog -1 | grep -o "feature/FL[0-9]\{3\}[^[:space:]]*")
-    if [ -n "$merged_branch" ]; then
-        feature_id=$(echo "$merged_branch" | grep -o "FL[0-9]\{3\}")
-        /project:aiwf:update_feature_status "$feature_id" "completed"
-    fi
-fi
-```
-
-## Git Commands for Feature Management
-
-### Link Current Branch to Feature
-```bash
-/project:aiwf:link_feature_branch FL001
-```
-
-### Import Commit History
-```bash
-/project:aiwf:import_feature_commits FL001 --since="2025-07-01"
-```
-
-### Generate Feature Changelog
-```bash
-/project:aiwf:feature_changelog FL001
-```
-
-Output:
-```markdown
-# Feature FL001 Changelog
-
-## Commits (15 total)
-- abc123d feat(FL001): implement JWT token generation (2025-07-08)
-- def456e [FL001] add password hashing (2025-07-09)
-- ghi789f fix(FL001): resolve token expiration bug (2025-07-10)
-
-## Pull Requests (2 total)
-- PR #42: [FL001] User Authentication Implementation (merged)
-- PR #45: [FL001] Fix token validation (open)
-
-## Code Impact
-- Files changed: 23
-- Lines added: 1,245
-- Lines removed: 89
-- First commit: 2025-07-08
-- Last activity: 2025-07-10
-```
-
-### Feature Git Status
-```bash
-/project:aiwf:feature_git_status FL001
-```
-
-Output:
-```
-Feature: FL001 - User Authentication System
-Branch: feature/FL001-user-authentication
-Status: 5 commits ahead of main
-Uncommitted changes: 2 files
-Open PRs: 1
-```
-
-## Automation Rules
-
-### 1. Branch Naming Convention
-- Pattern: `feature/FL###-descriptive-name`
-- Auto-created when feature is created
-- Validated before commits
-
-### 2. Commit Aggregation
-- Commits are aggregated daily
-- Metrics updated every 6 hours
-- Full history preserved
-
-### 3. PR Auto-Updates
-- PR status synced on webhook
-- Feature progress updated on merge
-- Reviewers added to contributors
-
-### 4. Completion Triggers
-- Feature marked complete when PR merged to main
-- Notification sent to stakeholders
-- Metrics finalized
-
-## Git Integration Metrics
-
-### Feature Velocity Metrics
-- Average commits per feature
-- Time from first commit to merge
-- Code churn rate
-- Review turnaround time
-
-### Quality Metrics
-- Test coverage delta
-- Code review comments
-- Bug fix ratio
-- Refactoring frequency
-
-### Team Metrics
-- Commits per developer
-- Review participation
-- Feature ownership distribution
-- Collaboration patterns
-
-## Best Practices
-
-1. **One Feature, One Branch**: Each feature should have dedicated branch
-2. **Atomic Commits**: Make small, focused commits with clear messages
-3. **Reference Features**: Always include feature ID in commit messages
-4. **Regular Sync**: Run sync commands after significant changes
-5. **Clean History**: Squash commits before merging for clarity
-
-## Troubleshooting
-
-### Common Issues
-
-1. **Missing Commits**: Run import command to catch up
-2. **Broken Links**: Use repair command to fix references
-3. **Orphaned Branches**: Clean up after feature completion
-4. **Sync Delays**: Check webhook configuration
-
-### Repair Commands
-
-```bash
-# Repair feature-git links
-/project:aiwf:repair_feature_git FL001
-
-# Resync all features
-/project:aiwf:resync_all_features
-
-# Clean orphaned branches
-/project:aiwf:clean_feature_branches
-```