📖 1_가이드 폴더 디렉토리 구조 및 가이드 목록

📖 1_가이드 폴더 디렉토리 구조

2025년 12월 정리 완료

중복되고 오래된 가이드들을 정리하고 주제별로 체계적으로 재분류했습니다.

📁 전체 폴더 구조

1_가이드/
├── 📖_가이드_디렉토리_구조.md          # 이 문서 (인덱스)
├── macOS_리눅스_설치_종합_가이드.md      # 🎯 메인 종합 가이드
│
├── 🖥️ 가상화/                          # Linux 가상화 관련
│   ├── VMware_Fusion_Rocky_Linux_설치_가이드.md     # ⭐ 추천
│   ├── Ubuntu_가상머신_생성_가이드.md
│   ├── macOS에서_VirtualBox_설치_가이드.md
│   ├── 리눅스_네트워크_설정_가이드.md
│   ├── macOS_가상화_솔루션_비교_가이드.md
│   └── Linux_가상머신_트러블슈팅_가이드.md
│
├── 🤖 AI도구/                          # AI 도구 활용
│   ├── Claude_Code_지식관리_완벽_가이드.md
│   ├── Gemini_CLI_활용_가이드.md
│   └── Ollama_Troubleshooting_Guide.md
│
├── 💻 개발환경/                        # 개발 환경 구축
│   └── nodejs_installation_guide.md
│
└── 📋 기타/                           # 기타 유틸리티
    └── naver_gmail_integration_guide.md

---

🎯 시작하기 - 추천 가이드

💡 Linux 가상화를 시작한다면?

학습 경로 추천

1. macOS_리눅스_설치_종합_가이드 - 전체 개요 파악 (필수)
2. macOS_가상화_솔루션_비교_가이드 - 솔루션 선택
3. 구체적 설치 가이드 선택:
   • Rocky Linux: VMware_Fusion_Rocky_Linux_설치_가이드 ⭐
   • Ubuntu: Ubuntu_가상머신_생성_가이드
   • VirtualBox: macOS에서_VirtualBox_설치_가이드

🤖 AI 도구를 활용한다면?

AI 도구 활용 순서

1. Claude_Code_지식관리_완벽_가이드 - Claude 활용법
2. Gemini_CLI_활용_가이드 - Gemini CLI 사용
3. Ollama_Troubleshooting_Guide - 로컬 AI 환경

---

📊 주제별 가이드 상세 목록

🖥️ 가상화 가이드 (6개)

🎯 메인 설치 가이드

가이드	대상	특징	권장도
VMware Fusion + Rocky Linux	모든 Mac	개인용 무료, 완벽 호환	⭐⭐⭐
VirtualBox + Ubuntu	Intel Mac	완전 무료, 학습용	⭐⭐
Ubuntu 가상머신 생성	모든 Mac	초보자 친화적	⭐⭐

🔧 설정 및 문제해결

가이드	용도	복잡도
리눅스 네트워크 설정	SSH, 네트워크 구성	중급
가상화 솔루션 비교	솔루션 선택 가이드	초급
트러블슈팅	문제 해결	고급

🤖 AI도구 가이드 (3개)

📋 AI 도구별 특징

Claude Code:
  - 용도: 코드 작성, 지식 관리
  - 특징: 파일 시스템 접근, 터미널 실행
  - 적용: 개발 프로젝트, 문서 정리
 
Gemini CLI:
  - 용도: 터미널 기반 AI 활용
  - 특징: 명령행 인터페이스
  - 적용: 자동화, 스크립팅
 
Ollama:
  - 용도: 로컬 AI 모델 실행
  - 특징: 오프라인 사용 가능
  - 적용: 프라이버시, 커스텀 모델

💻 개발환경 가이드 (1개)

• Node.js 설치 가이드: JavaScript/TypeScript 개발 환경

📋 기타 가이드 (1개)

• 네이버 Gmail 통합: 이메일 자동화 및 통합

---

🗑️ 정리 과정에서 삭제된 가이드들

❌ 삭제된 파일 목록

중복 및 불필요한 파일들 (2025-12-02 삭제):
├── MacBook_ARM_Ubuntu_VM_환경_구축_가이드.md        # 중복
├── Linux_완전정복_가이드.md                        # 너무 일반적
├── gemini_cli_introduction.md                     # 중복
├── gemini_context_awareness_guide.md              # 세부 기능
├── gemini_file_management_guide.md                # 세부 기능
└── 내_컴퓨터를_AI_서버로_만들기_Ollama_설치_및_문제해결_가이드.md  # 중복

🔄 삭제 이유

• 중복성: 동일한 주제를 다루는 여러 가이드 존재
• 일반성: 너무 일반적이고 구체성이 부족
• 세분화: 하나의 도구를 너무 세분화한 가이드들
• 명명 규칙: 일관성 없는 파일명

---

📝 가이드 작성 및 관리 규칙

✅ 가이드 작성 기준

파일명 규칙:
  - 한글_영어_혼용_가능
  - 공백은 언더스코어(_)로 대체
  - 확장자: .md
 
내용 기준:
  - YAML frontmatter 필수
  - 07_02 스타일 템플릿 준수
  - 키캅 이모지 금지 (1, 2 등)
  - 숫자는 "1.", "2." 형식 사용
 
링크 기준:
  - 폴더 간 링크: [[폴더명/파일명]]
  - 상위 폴더: [[../파일명]]
  - 같은 폴더: [[파일명]]

🔄 향후 추가 예정 가이드

가상화 영역:
  - Kubernetes_실습환경_구축_가이드.md
  - Docker_컨테이너_관리_가이드.md
  - 리눅스_개발환경_구축_가이드.md
 
개발환경 영역:
  - Python_개발환경_설정_가이드.md
  - Git_워크플로우_가이드.md
  - VS_Code_원격개발_가이드.md
 
AI도구 영역:
  - ChatGPT_API_활용_가이드.md
  - AI_코딩_워크플로우_가이드.md

---

🎯 빠른 참조

📌 자주 찾는 가이드

1. Rocky Linux 설치: 가상화/VMware_Fusion_Rocky_Linux_설치_가이드.md
2. Ubuntu 설치: 가상화/Ubuntu_가상머신_생성_가이드.md
3. 가상화 솔루션 선택: 가상화/macOS_가상화_솔루션_비교_가이드.md
4. Claude Code 활용: AI도구/Claude_Code_지식관리_완벽_가이드.md

🔗 핵심 가이드 링크

• 🎯 macOS_리눅스_설치_종합_가이드 - 시작점
• ⭐ VMware_Fusion_Rocky_Linux_설치_가이드 - 최신 권장
• 🤖 Claude_Code_지식관리_완벽_가이드 - 도구 활용

---

📈 가이드 통계

총 가이드 수: 12개
├── 종합 가이드: 1개
├── 가상화: 6개 (50%)
├── AI도구: 3개 (25%)
├── 개발환경: 1개 (8.3%)
└── 기타: 1개 (8.3%)
 
삭제된 가이드: 6개
정리 효과: 50% 중복 제거 완료

2025-12-02 기준 정리 완료. 체계적이고 중복 없는 가이드 구조 완성! 🎉