# 로빙 프로젝트 문서

로빙(RO-BEING) 프로젝트의 모든 문서를 모아놓은 저장소입니다.

## 문서 구조

### 프로젝트 개요
- [프로젝트 종합 v2](./00_프로젝트_종합_v2.md) - 로빙 프로젝트 전체 소개 (최신)

### 철학과 비전
- [AI Agent 차별화 방안](./docs/philosophy/AI%20agent%20차별화%20방안%20제안.md)
- [PERSONOS 인간-에이전트 인터페이스](./docs/philosophy/PERSONOS_인간–에이전트%20인터페이스%20프로토콜%20v1.md)
- [로빙 스탯 성장 설계](./docs/philosophy/robeing_stats_growth_design.md)
- [에이전트 게이미피케이션 시스템](./docs/philosophy/에이전트%20게이미피케이션%20시스템%20통합%20설계.md)

### 아키텍처
- [아키텍처 개요](./docs/architecture/00_아키텍처.md)
- [로빙 아키텍처](./docs/architecture/아키텍처_로빙.md)
- [로빙 컨테이너 아키텍처 설계](./docs/architecture/로빙_컨테이너_아키텍처_설계.md)
- [Nginx 아키텍처](./docs/architecture/Nginx_아키텍처.md)
- [스킬 허브 아키텍처](./docs/architecture/skillhub_architecture.md)
- [경량 버전 제의](./docs/architecture/로빙_아키텍쳐_설계_경량.md)

### 구현 가이드
- [MVP 단계 상세 계획](./docs/implementation/01_MVP%20단계_%20자세한%20계획.md)
- [PRD 문서](./docs/implementation/prd.md)
- [개발 작업 목록](./docs/implementation/tasks.md)

### AI 메모리 시스템
- [AI 에이전트의 장기 기억 관리](./docs/ai-memory/AI%20에이전트의%20장기%20기억%20관리_%20정보%20가치%20판단_신뢰성%20검증_망각과%20효율성%20최적화_by%20grok.md)
- [기억모듈 설계](./docs/ai-memory/기억모듈01.md)
- [로빙 스탯기반 LLM 모델 업그레이드](./docs/ai-memory/로빙_스탯기반_LLM_모델_업그레이드_및_100대_모델_순위.md)

### 스킬과 스탯 시스템
- [에이전트 스탯 스킬 클래스 구조](./docs/skills-stats/에이전트%20스탯%20스킬%20클래스%20구조.md)
- [외부도구 아이템화 및 스마트폰 오버레이](./docs/skills-stats/외부도구_아이템화_및_스마트폰_오버레이_활용방안.md)
- [PPTX 파일 구조분석 및 HTML 변환](./docs/skills-stats/pptx_파일_구조분석_및_HTML_변환_가능성.md)

### 연구 자료
- [종합 AI 모델 분석 보고서](./docs/research/종합%20AI%20모델%20분석%20보고서_%20전략적%20의사결정을%20위한%20성능,%20비용%20및%20기술%20사양%20비교_by%20Gemini.md)

### 함수형 프로그래밍 아키텍처
- [로빙의 존재와 함수형 프로그래밍](./docs/guide/functional-programing/로빙_존재와_함수형_프로그래밍.md) - 철학적 배경과 점진적 적용 전략
- [함수형 구현 패턴과 사례](./docs/guide/functional-programing/함수형_구현_패턴과_사례.md) - 실제 코드 패턴과 리팩토링 가이드
- [함수형 적용 가이드라인](./docs/guide/functional-programing/함수형_적용_가이드라인.md) - 구성요소별 순수함수 가능성 분석과 실전 적용 기준

### 가치 판단 및 평가 시스템
- [로빙의 가치 판단 아키텍처](./docs/guide/evaluation/00_평가_종합.md) - 4축 가치 판단 시스템과 메타인지 설계
- [평가 시스템 구현 가이드라인](./docs/guide/evaluation/평가_가이드라인.md) - 단계별 구현 계획과 개발자 매뉴얼

### 설정 및 설치 가이드
- [프로젝트 설정 가이드](./docs/setups/setup-guide.md)
- [Slack 설정 최종 가이드](./docs/setups/slack-setup-final.md)
- [Slack 테스트 가이드](./docs/setups/slack-test-guide.md)
- [Socket Mode 테스트 가이드](./docs/setups/socket-mode-test.md)
- [ngrok 테스트 가이드](./docs/setups/ngrok-test-guide.md)
- [이메일 설정 가이드](./docs/setups/Email_readme.md) - Gmail API 실시간 수신 및 발송 완전 가이드

### 트러블슈팅
- [troubleshooting](./troubleshooting/) - 문제 해결 가이드 모음
  - [GitHub → Gitea 마이그레이션](./troubleshooting/20250714_migration_from_github.md)
  - [nginx 프록시 및 CI/CD 배포 문제 해결](./troubleshooting/250728_happybell80_nginx프록시및CI배포문제해결.md) - 51123/51124 서버 배포 이슈

### 외부 참조
- [Slack API 문서](https://api.slack.com/web)
- [OpenAI API 문서](https://platform.openai.com/docs)
- [Gemini API 문서](https://ai.google.dev/docs)
- [FastAPI 문서](https://fastapi.tiangolo.com/)
- [LangChain 문서](https://docs.langchain.com/)

## 문서 활용 가이드

### 프로젝트 이해하기
1. [프로젝트 종합 v2](./00_프로젝트_종합_v2.md) 읽기
2. [철학과 비전](./docs/philosophy/) 문서들 확인
3. [아키텍처](./docs/architecture/) 문서들로 시스템 구조 이해
4. [MVP 상세 계획](./docs/implementation/01_MVP%20단계_%20자세한%20계획.md) 확인

### 개발 환경 구축하기
1. [설정 가이드](./docs/setups/setup-guide.md) 기본 설치
2. [Slack 설정 가이드](./docs/setups/slack-setup-final.md) Slack 연동
3. [테스트 가이드](./docs/setups/slack-test-guide.md) 동작 확인

## 문서 기여 가이드

- 새로운 문서는 적절한 디렉토리에 마크다운(.md) 형식으로 작성
- 문서 추가 시 이 README.md에 링크 추가
- 기술 문서는 코드 예시와 함께 작성 권장