aiwf 0.3.14 → 0.3.15

package/src/lib/installer.js

@@ -52,6 +52,61 @@ async function checkExistingInstallation() {
   return flagExists;
 }
 
+/**
+ * Check if existing project files exist
+ * @returns {Promise<{hasProject: boolean, projectFiles: string[]}>} Project status
+ */
+async function checkExistingProject() {
+  const projectFiles = [];
+  let hasProject = false;
+
+  // Check for key project files
+  const keyFiles = [
+    FILES.PROJECT_MANIFEST,
+    path.join(AIWF_DIRS.PROJECT_DOCS, 'README.md'),
+    path.join(AIWF_DIRS.REQUIREMENTS, 'requirements.md'),
+    path.join(AIWF_DIRS.SPRINTS, 'sprint-01.md'),
+    path.join(AIWF_DIRS.GENERAL_TASKS, 'tasks.md'),
+    path.join(AIWF_DIRS.ARCHITECTURAL_DECISIONS, 'decisions.md'),
+    path.join(AIWF_DIRS.STATE_OF_PROJECT, 'current-state.md')
+  ];
+
+  for (const file of keyFiles) {
+    try {
+      await fs.access(file);
+      projectFiles.push(file);
+      hasProject = true;
+    } catch (error) {
+      // File doesn't exist, continue
+    }
+  }
+
+  // Check for any .md files in project directories
+  const projectDirs = [
+    AIWF_DIRS.PROJECT_DOCS,
+    AIWF_DIRS.REQUIREMENTS,
+    AIWF_DIRS.SPRINTS,
+    AIWF_DIRS.GENERAL_TASKS,
+    AIWF_DIRS.ARCHITECTURAL_DECISIONS,
+    AIWF_DIRS.STATE_OF_PROJECT
+  ];
+
+  for (const dir of projectDirs) {
+    try {
+      const files = await fs.readdir(dir);
+      const mdFiles = files.filter(file => file.endsWith('.md'));
+      if (mdFiles.length > 0) {
+        hasProject = true;
+        projectFiles.push(...mdFiles.map(file => path.join(dir, file)));
+      }
+    } catch (error) {
+      // Directory doesn't exist, continue
+    }
+  }
+
+  return { hasProject, projectFiles };
+}
+
 /**
  * Log with spinner for debug mode
  * @param {Object} spinner - Ora spinner instance
@@ -146,34 +201,145 @@ async function selectLanguage(options) {
  * Handle existing installation
  * @param {Object} msg - Localized messages
  * @param {Object} options - Installation options
- * @returns {Promise<boolean>} Continue with installation
+ * @returns {Promise<{continue: boolean, installType: string, preserveProject: boolean}>} Installation decision
  */
 async function handleExistingInstallation(msg, options) {
+
   if (options.force) {
-    return true;
+    return { continue: true, installType: 'reinstall', preserveProject: false };
   }
 
-  const response = await prompts({
+  // First, ask about installation type
+  const installResponse = await prompts({
     type: 'select',
     name: 'action',
     message: msg.existingDetected,
     choices: [
       { title: msg.updateOption, value: 'update' },
+      { title: msg.reinstallOption, value: 'reinstall' },
       { title: msg.skipOption, value: 'skip' },
       { title: msg.cancelOption, value: 'cancel' }
     ]
   });
 
-  if (response.action === 'skip' || response.action === 'cancel') {
+
+
+  if (installResponse.action === 'skip' || installResponse.action === 'cancel') {
     console.log(chalk.yellow(msg.installCancelled));
     process.exit(0);
   }
 
-  if (response.action === 'update') {
+  let preserveProject = true; // Default to preserve
+  
+  // If reinstalling, don't preserve project (complete fresh install)
+  if (installResponse.action === 'reinstall') {
+    preserveProject = false;
+  }
+
+  // Backup if updating
+  if (installResponse.action === 'update') {
     await backupCommandsAndDocs(msg);
   }
 
-  return true;
+  return {
+    continue: true,
+    installType: installResponse.action,
+    preserveProject
+  };
+}
+
+/**
+ * Backup project files
+ * @param {string[]} projectFiles - List of project files to backup
+ * @param {Object} msg - Localized messages
+ * @returns {Promise<string>} Backup directory path
+ */
+async function backupProjectFiles(projectFiles, msg) {
+  if (projectFiles.length === 0) {
+    return null;
+  }
+
+  const backupDir = path.join(os.tmpdir(), `aiwf-project-backup-${Date.now()}`);
+  await fs.mkdir(backupDir, { recursive: true });
+
+  console.log(chalk.cyan('💾 Backing up project files...'));
+  
+  for (const file of projectFiles) {
+    try {
+      const relativePath = path.relative(process.cwd(), file);
+      const backupPath = path.join(backupDir, relativePath);
+      const backupDirPath = path.dirname(backupPath);
+      
+      await fs.mkdir(backupDirPath, { recursive: true });
+      await fs.copyFile(file, backupPath);
+    } catch (error) {
+      console.log(chalk.yellow(`Warning: Could not backup ${file}: ${error.message}`));
+    }
+  }
+
+  console.log(chalk.green(`✅ Project files backed up to: ${backupDir}`));
+  return backupDir;
+}
+
+/**
+ * Restore project files from backup
+ * @param {string} backupDir - Backup directory path
+ * @param {Object} msg - Localized messages
+ */
+async function restoreProjectFiles(backupDir, msg) {
+  if (!backupDir) {
+    return;
+  }
+
+  console.log(chalk.cyan('🔄 Restoring project files...'));
+  
+  try {
+    const backupFiles = await fs.readdir(backupDir, { recursive: true });
+    
+    for (const file of backupFiles) {
+      const backupFilePath = path.join(backupDir, file);
+      const stat = await fs.stat(backupFilePath);
+      
+      if (stat.isFile()) {
+        const targetPath = path.join(process.cwd(), file);
+        const targetDir = path.dirname(targetPath);
+        
+        await fs.mkdir(targetDir, { recursive: true });
+        await fs.copyFile(backupFilePath, targetPath);
+      }
+    }
+    
+    console.log(chalk.green(msg.projectPreserved));
+    
+    // Clean up backup directory
+    await fs.rm(backupDir, { recursive: true, force: true });
+  } catch (error) {
+    console.log(chalk.yellow(`Warning: Could not restore some project files: ${error.message}`));
+    console.log(chalk.yellow(`Backup preserved at: ${backupDir}`));
+  }
+}
+
+/**
+ * Remove project files
+ * @param {string[]} projectFiles - List of project files to remove
+ * @param {Object} msg - Localized messages
+ */
+async function removeProjectFiles(projectFiles, msg) {
+  if (projectFiles.length === 0) {
+    return;
+  }
+
+  console.log(chalk.cyan('🗑️  Removing existing project files...'));
+  
+  for (const file of projectFiles) {
+    try {
+      await fs.unlink(file);
+    } catch (error) {
+      // File might already be deleted, continue
+    }
+  }
+  
+  console.log(chalk.green(msg.projectOverwritten));
 }
 
 /**
@@ -609,9 +775,22 @@ export async function installAIWF(options = {}) {
   // Check existing installation
   const hasExisting = await checkExistingInstallation();
 
+  let installDecision = { continue: true, installType: 'fresh', preserveProject: false };
+  let projectBackupDir = null;
+
   if (hasExisting) {
-    const shouldContinue = await handleExistingInstallation(msg, options);
-    if (!shouldContinue) return;
+
+    installDecision = await handleExistingInstallation(msg, options);
+
+    if (!installDecision.continue) return;
+    
+    // If reinstalling and preserving project, backup project files
+    if (installDecision.installType === 'reinstall' && installDecision.preserveProject) {
+      const { hasProject, projectFiles } = await checkExistingProject();
+      if (hasProject) {
+        projectBackupDir = await backupProjectFiles(projectFiles, msg);
+      }
+    }
   }
 
   const spinner = ora(msg.fetching).start();
@@ -620,16 +799,20 @@ export async function installAIWF(options = {}) {
     // Create directory structure
     await createDirectoryStructure();
 
-    // Download manifest (fresh installs only)
-    if (!hasExisting) {
+    // Download manifest (fresh installs only or complete reinstall)
+    if (!hasExisting || installDecision.installType === 'reinstall') {
       await downloadManifest(languagePath, spinner, msg, debugLog);
     }
 
-    // Download templates
-    await downloadTemplates(languagePath, spinner, msg, debugLog);
+    // Download templates (fresh installs and complete reinstall only)
+    if (!hasExisting || installDecision.installType === 'reinstall') {
+      await downloadTemplates(languagePath, spinner, msg, debugLog);
+    }
 
-    // Update documentation
-    await updateDocumentation(languagePath, spinner, msg, debugLog);
+    // Update documentation (fresh installs and complete reinstall only)
+    if (!hasExisting || installDecision.installType === 'reinstall') {
+      await updateDocumentation(languagePath, spinner, msg, debugLog);
+    }
 
     // Update commands
     await updateCommands(languagePath, spinner, msg, debugLog);
@@ -637,8 +820,13 @@ export async function installAIWF(options = {}) {
     // Download and process rules
     await downloadAndProcessRules(spinner, msg, debugLog);
 
+    // Restore project files if needed
+    if (projectBackupDir) {
+      await restoreProjectFiles(projectBackupDir, msg);
+    }
+
     // Success
-    if (hasExisting) {
+    if (hasExisting && installDecision.installType === 'update') {
       spinner.succeed(chalk.green(msg.updateSuccess));
     } else {
       spinner.succeed(chalk.green(msg.installSuccess));

package/src/utils/messages.js

@@ -11,8 +11,16 @@ export const messages = {
     english: 'English',
     existingDetected: '기존 AIWF 설치가 감지되었습니다. 무엇을 하시겠습니까?',
     updateOption: '업데이트 (명령어와 문서만 업데이트하고 작업 내용은 보존)',
+    reinstallOption: '완전 재설치 (모든 내용을 새로 설치, 기존 프로젝트 덮어쓰기)',
     skipOption: '설치 건너뛰기',
     cancelOption: '취소',
+    projectDetected: '기존 프로젝트가 감지되었습니다. 프로젝트 파일을 어떻게 처리하시겠습니까?',
+    preserveProject: '프로젝트 보존 (기존 프로젝트 파일 유지)',
+    overwriteProject: '덮어쓰기 (새로 설치하고 기존 프로젝트 삭제)',
+    checkingProject: '기존 프로젝트 확인 중...',
+    projectFound: '기존 프로젝트가 발견되었습니다:',
+    projectPreserved: '💾 프로젝트가 보존되었습니다.',
+    projectOverwritten: '🔄 프로젝트가 새로 설치되었습니다.',
     installCancelled: '\n설치가 취소되었습니다.',
     backingUp: '기존 명령어 및 문서 백업 중...',
     fetching: 'GitHub에서 AIWF 프레임워크를 가져오는 중...',
@@ -72,8 +80,16 @@ export const messages = {
     english: 'English',
     existingDetected: 'Existing AIWF installation detected. What would you like to do?',
     updateOption: 'Update (Update commands and docs only, preserve work content)',
+    reinstallOption: 'Complete reinstall (Install everything fresh, overwrite existing project)',
     skipOption: 'Skip installation',
     cancelOption: 'Cancel',
+    projectDetected: 'Existing project detected. How would you like to handle project files?',
+    preserveProject: 'Preserve project (Keep existing project files)',
+    overwriteProject: 'Overwrite (Fresh install and remove existing project)',
+    checkingProject: 'Checking for existing project...',
+    projectFound: 'Existing project found:',
+    projectPreserved: '💾 Project has been preserved.',
+    projectOverwritten: '🔄 Project has been freshly installed.',
     installCancelled: '\nInstallation cancelled.',
     backingUp: 'Backing up existing commands and documents...',
     fetching: 'Fetching AIWF framework from GitHub...',

package/src/utils/paths.js

@@ -22,7 +22,7 @@ export const AIWF_DIRS = {
   REQUIREMENTS: path.join(BASE_DIRS.AIWF, '02_REQUIREMENTS'),
   SPRINTS: path.join(BASE_DIRS.AIWF, '03_SPRINTS'),
   GENERAL_TASKS: path.join(BASE_DIRS.AIWF, '04_GENERAL_TASKS'),
-  ARCHITECTURE_DECISIONS: path.join(BASE_DIRS.AIWF, '05_ARCHITECTURE_DECISIONS'),
+  ARCHITECTURAL_DECISIONS: path.join(BASE_DIRS.AIWF, '05_ARCHITECTURAL_DECISIONS'),
   STATE_OF_PROJECT: path.join(BASE_DIRS.AIWF, '10_STATE_OF_PROJECT'),
   PROMPTS: path.join(BASE_DIRS.AIWF, '98_PROMPTS'),
   TEMPLATES: path.join(BASE_DIRS.AIWF, '99_TEMPLATES'),
@@ -77,7 +77,7 @@ export function getAllAiwfDirectories() {
     AIWF_DIRS.REQUIREMENTS,
     AIWF_DIRS.SPRINTS,
     AIWF_DIRS.GENERAL_TASKS,
-    AIWF_DIRS.ARCHITECTURE_DECISIONS,
+    AIWF_DIRS.ARCHITECTURAL_DECISIONS,
     AIWF_DIRS.STATE_OF_PROJECT,
     AIWF_DIRS.PROMPTS,
     AIWF_DIRS.TEMPLATES

package/docs/CLEANUP_RECOMMENDATIONS.md

@@ -1,86 +0,0 @@
-# AIWF 프로젝트 정리 권장사항
-
-## ✅ 완료된 작업
-
-1. **import 경로 수정**
-   - index.js의 잘못된 경로 수정 완료
-   - `./src/commands/ai-tool.js` → `./commands/ai-tool.js`
-
-2. **미사용 파일 삭제** (4개 파일, 1,734줄 제거)
-   - lib/file-batch-processor.js
-   - lib/performance-benchmark.js
-   - lib/template-manager.js
-   - lib/cache-integration.js
-
-## 📋 추가 권장사항
-
-### 1. 코드 구조 개선
-
-#### index.js 모듈화 (1,950줄 → 여러 모듈로 분리)
-```
-index.js
-├── lib/installer.js         # 설치 로직
-├── lib/validator.js         # 검증 로직
-├── lib/backup-manager.js    # 백업/복원 로직
-└── lib/github-client.js     # GitHub API 통신
-```
-
-#### 토큰 관리 시스템 통합
-현재 8개 파일에 분산된 토큰 기능을 2개로 통합:
-- `lib/token-manager.js` - 핵심 토큰 관리
-- `commands/token-tracking.js` - CLI 명령어
-
-### 2. 파일명 일관성
-
-스네이크 케이스를 케밥 케이스로 통일:
-```bash
-# 변경 필요
-sync-feature-commits.js → sync-feature-commits.js ✓ (완료)
-feature-commit-report.js → feature-commit-report.js ✓ (완료)
-scan-git-history.js → scan-git-history.js ✓ (완료)
-```
-
-### 3. 중복 기능 통합
-
-#### 압축 시스템 (4개 → 2개)
-- 유지: `utils/context-compressor.js`, `commands/compress-context.js`
-- 통합: `compression-strategies.js`, `persona-aware-compressor.js`
-
-### 4. 문서 정리
-
-중복되거나 오래된 문서 통합:
-- PRD.md와 PRD.ko.md의 정보 동기화
-- 여러 개의 가이드 문서를 하나로 통합
-- 사용되지 않는 문서에서만 참조되는 기능 제거
-
-### 5. 테스트 개선
-
-- 큰 테스트 파일 분리 (compression-test-suite.js: 1,251줄)
-- 주석 처리된 테스트 코드 정리
-- 실제 사용되는 유틸리티에 대한 테스트 추가
-
-### 6. 성능 최적화
-
-- 복잡한 메트릭 수집 간소화 (metrics-collector.js: 884줄)
-- 불필요한 추상화 레벨 제거
-- 캐시 시스템 단순화
-
-## 🎯 예상 효과
-
-- **코드 감소**: 약 20-30% 코드량 감소
-- **유지보수성**: 파일 구조 명확화로 이해도 향상
-- **성능**: 불필요한 추상화 제거로 성능 개선
-- **일관성**: 명명 규칙 통일로 개발 경험 개선
-
-## ⚠️ 주의사항
-
-1. **Git 통합 파일들은 유지**: 실제로 활발히 사용 중
-2. **페르소나 시스템 유지**: Claude Code 통합에 필수
-3. **변경 시 테스트 필수**: 기능 손상 방지
-
-## 🔄 단계별 진행
-
-1. **Phase 1** (즉시): ✅ 미사용 파일 제거 (완료)
-2. **Phase 2** (단기): 파일명 통일, 중복 통합
-3. **Phase 3** (중기): index.js 모듈화, 테스트 개선
-4. **Phase 4** (장기): 전체 구조 최적화

package/docs/git-feature-integration-guide.md

@@ -1,253 +0,0 @@
-# Git-Feature 통합 가이드
-
-이 문서는 AIWF의 Git 연동 Feature 추적 시스템 사용법을 설명합니다.
-
-## 개요
-
-Git-Feature 통합 시스템은 Git 커밋과 Feature Ledger를 자동으로 연결하여, 개발 진행 상황을 효과적으로 추적할 수 있게 합니다.
-
-## 주요 기능
-
-1. **커밋 메시지 파싱**: 다양한 형식의 Feature ID 자동 인식
-2. **자동 동기화**: Git hooks를 통한 실시간 Feature 업데이트
-3. **히스토리 스캔**: 기존 커밋 히스토리와 Feature 연결
-4. **리포트 생성**: Feature-커밋 매핑 리포트 자동 생성
-
-## 커밋 메시지 규칙
-
-### 지원하는 Feature ID 형식
-
-```bash
-# 직접 참조
-git commit -m "FL001 사용자 인증 기능 구현"
-
-# 대괄호 참조
-git commit -m "[FL001] 로그인 폼 스타일 수정"
-
-# Conventional Commit 형식
-git commit -m "feat(FL001): JWT 토큰 발급 로직 추가"
-git commit -m "fix(FL001): 로그인 오류 수정"
-
-# 해시 참조
-git commit -m "Update authentication flow #FL001"
-
-# 여러 Feature 참조
-git commit -m "FL001, FL002 관련 공통 유틸리티 추가"
-```
-
-### 브랜치 명명 규칙
-
-```bash
-# Feature 브랜치 형식
-git checkout -b feature/FL001-user-authentication
-git checkout -b feature/FL002-dashboard-redesign
-```
-
-## 명령어 사용법
-
-### 1. sync_feature_commits - Feature 동기화
-
-```bash
-# 특정 Feature 동기화
-node claude-code/aiwf/ko/commands/sync_feature_commits.js FL001
-
-# 모든 활성 Feature 동기화
-node claude-code/aiwf/ko/commands/sync_feature_commits.js --all
-
-# 최근 100개 커밋에서 Feature 찾기
-node claude-code/aiwf/ko/commands/sync_feature_commits.js --recent 100
-
-# 특정 날짜 이후 커밋 검색
-node claude-code/aiwf/ko/commands/sync_feature_commits.js --since 2025-01-01
-
-# 상세 로그 출력
-node claude-code/aiwf/ko/commands/sync_feature_commits.js --verbose
-```
-
-### 2. scan_git_history - 히스토리 스캔
-
-```bash
-# 기본 스캔 (2025-01-01부터)
-node claude-code/aiwf/ko/commands/scan_git_history.js
-
-# 날짜 범위 지정
-node claude-code/aiwf/ko/commands/scan_git_history.js --since 2024-01-01 --until 2024-12-31
-
-# 특정 Feature만 스캔
-node claude-code/aiwf/ko/commands/scan_git_history.js --feature FL001
-
-# Dry-run 모드 (실제 업데이트 없음)
-node claude-code/aiwf/ko/commands/scan_git_history.js --dry-run
-
-# 누락된 Feature 파일 자동 생성
-node claude-code/aiwf/ko/commands/scan_git_history.js --create-missing
-```
-
-### 3. feature_commit_report - 리포트 생성
-
-```bash
-# 기본 Markdown 리포트 생성
-node claude-code/aiwf/ko/commands/feature_commit_report.js
-
-# 특정 Feature 리포트
-node claude-code/aiwf/ko/commands/feature_commit_report.js --feature FL001
-
-# 활성 Feature만 포함
-node claude-code/aiwf/ko/commands/feature_commit_report.js --status active
-
-# JSON 형식으로 출력
-node claude-code/aiwf/ko/commands/feature_commit_report.js --format json --output report.json
-
-# HTML 형식 + 상세 정보
-node claude-code/aiwf/ko/commands/feature_commit_report.js --format html --detailed --output report.html
-
-# 타임라인 뷰 포함
-node claude-code/aiwf/ko/commands/feature_commit_report.js --timeline
-```
-
-## Git Hooks 설정
-
-### 자동 설치
-
-```bash
-# 설치 스크립트 실행
-./claude-code/aiwf/ko/hooks/install-hooks.sh
-
-# 환경 변수 설정 (활성화)
-export AIWF_HOOKS_ENABLED=true
-
-# 상세 로그 활성화 (선택사항)
-export AIWF_HOOKS_VERBOSE=true
-
-# 영구 설정 (~/.bashrc 또는 ~/.zshrc에 추가)
-echo 'export AIWF_HOOKS_ENABLED=true' >> ~/.bashrc
-```
-
-### 수동 설치
-
-```bash
-# post-commit hook 복사
-cp claude-code/aiwf/ko/hooks/post-commit .git/hooks/
-chmod +x .git/hooks/post-commit
-
-# 환경 변수 설정
-export AIWF_HOOKS_ENABLED=true
-```
-
-### Hook 동작 확인
-
-```bash
-# Feature ID를 포함한 커밋 생성
-git add .
-git commit -m "feat(FL001): 새로운 기능 추가"
-
-# 콘솔에 다음과 같은 메시지가 표시됩니다:
-# 🔄 AIWF Feature Ledger 동기화 중...
-# ✅ Feature ID 발견: FL001
-# 📝 FL001 동기화 중...
-# ✅ FL001 동기화 완료
-# ✨ Feature Ledger 동기화 완료!
-```
-
-## 워크플로우 예시
-
-### 1. 새 Feature 시작
-
-```bash
-# 1. Feature Ledger 생성
-/project:aiwf:create_feature_ledger "User Authentication"
-
-# 2. Feature 브랜치 생성
-git checkout -b feature/FL001-user-authentication
-
-# 3. 개발 및 커밋
-git add src/auth/*
-git commit -m "feat(FL001): 사용자 인증 모듈 구현"
-
-# 4. Feature 자동 업데이트 확인
-cat .aiwf/06_FEATURE_LEDGERS/active/FL001_User_Authentication.md
-```
-
-### 2. 기존 프로젝트에 적용
-
-```bash
-# 1. Git 히스토리 스캔
-node claude-code/aiwf/ko/commands/scan_git_history.js --since 2024-01-01
-
-# 2. 누락된 Feature 확인 및 생성
-node claude-code/aiwf/ko/commands/scan_git_history.js --create-missing
-
-# 3. 리포트 생성
-node claude-code/aiwf/ko/commands/feature_commit_report.js --detailed
-
-# 4. Git hooks 설치
-./claude-code/aiwf/ko/hooks/install-hooks.sh
-export AIWF_HOOKS_ENABLED=true
-```
-
-### 3. 진행 상황 모니터링
-
-```bash
-# 전체 Feature 상태 확인
-node claude-code/aiwf/ko/commands/feature_commit_report.js
-
-# 특정 Feature 상세 정보
-node claude-code/aiwf/ko/commands/sync_feature_commits.js FL001 --verbose
-
-# 최근 활동 확인
-node claude-code/aiwf/ko/commands/sync_feature_commits.js --recent 50 --verbose
-```
-
-## 문제 해결
-
-### Git hooks가 실행되지 않음
-
-```bash
-# 환경 변수 확인
-echo $AIWF_HOOKS_ENABLED
-
-# Hook 파일 권한 확인
-ls -la .git/hooks/post-commit
-
-# 수동으로 동기화 실행
-node claude-code/aiwf/ko/commands/sync_feature_commits.js --all
-```
-
-### Feature ID가 인식되지 않음
-
-```bash
-# 커밋 메시지 패턴 확인
-git log --oneline | grep "FL[0-9]\{3\}"
-
-# 지원하는 형식 사용
-git commit -m "feat(FL001): 기능 설명"  # 권장
-git commit -m "[FL001] 기능 설명"       # 가능
-git commit -m "FL001 기능 설명"         # 가능
-```
-
-### 동기화 오류
-
-```bash
-# Feature 파일 존재 확인
-find .aiwf/06_FEATURE_LEDGERS -name "FL001*"
-
-# 수동으로 Feature 파일 생성
-/project:aiwf:create_feature_ledger "Feature Name"
-
-# 다시 동기화 시도
-node claude-code/aiwf/ko/commands/sync_feature_commits.js FL001
-```
-
-## 모범 사례
-
-1. **일관된 커밋 메시지**: Conventional Commit 형식 사용 권장
-2. **브랜치 전략**: Feature별 브랜치 생성 및 명명 규칙 준수
-3. **정기적 동기화**: 주기적으로 `--all` 옵션으로 전체 동기화
-4. **리포트 활용**: 스프린트 종료 시 리포트 생성하여 진행 상황 공유
-5. **Hook 활성화**: 팀 전체가 Git hooks를 활성화하여 일관성 유지
-
-## 추가 리소스
-
-- [Feature Ledger 시스템 사양](/.aiwf/02_REQUIREMENTS/M02_Context_Engineering_Enhancement/SPECS_Feature_Ledger_System.md)
-- [Git 통합 사양](/.aiwf/06_FEATURE_LEDGERS/FEATURE_GIT_INTEGRATION.md)
-- [통합 가이드](/.aiwf/06_FEATURE_LEDGERS/FEATURE_INTEGRATION_GUIDE.md)